Credits

What credits are

Credits control how many agent runs you can execute per month. Each run costs credits based on its complexity. When your credit balance reaches zero, runs are rejected until the next monthly reset.

Credit cost per run

Complexity is determined by Valta based on the task scope, number of actions taken, and duration. You are not charged for runs that fail before they start (e.g. due to an AGENT_FROZEN or CREDITS_EXHAUSTED error).

Monthly allowances by plan

Credits reset on the 1st of each month at midnight UTC. Unused credits do not roll over.

Checking your credit balance

import { ValtaClient } from 'valta-sdk'

const valta = new ValtaClient({ apiKey: process.env.VALTA_API_KEY })

const me = await valta.auth.whoami()

console.log(me.creditsRemaining) // e.g. 342
console.log(me.plan)             // 'free' | 'builder' | 'startup'

What happens when credits run out

When your balance is insufficient to start a run:

• The run is rejected with HTTP 402
• The error code is CREDITS_EXHAUSTED
• No partial run is executed
• No credits are deducted

import { ValtaClient, ValtaError } from 'valta-sdk'

const valta = new ValtaClient({ apiKey: process.env.VALTA_API_KEY })

try {
  const run = await valta.agents.run(agent.id, { task: 'Process invoices.' })
} catch (err) {
  if (err instanceof ValtaError && err.code === 'CREDITS_EXHAUSTED') {
    console.log('Out of credits. Resets on the 1st of next month.')
  }
}

Beta users on all tiers receive the Builder credit allowance (500/month) during beta.

Next steps

• Public Beta

• Agents SDK