Pricing
How Sume bills API work: plans and one wallet, what one run cost, estimates before you run, avatar video rates, failed jobs, and 402 errors.
Start with How Sume pricing works: plans, one wallet, published model rates

Do failed AI video generations cost credits? Reserve, capture, refund
No. Sume reserves a job's estimated USD cost at submit, captures usage only on completion, and releases or refunds the hold if the job fails or is canceled.

Insufficient credits error 402 on the Sume API: add funds and retry
A Sume 402 insufficient_credits means the balance cannot cover the request's estimated cost, so nothing ran. Check GET /v1/balance, add funds, then retry.

AI video generation cost per video: what one Sume API run cost
To see what one Sume run or video job cost, call GET /v1/usage with run_id or job_id and read debited_usd: the wallet deduction, agent turns included.

How Sume pricing works: plans, one wallet, published model rates
Sume plans set access and concurrency. Usage draws from one prepaid wallet at each model's published USD rate, for generation, the Agent, Formats, and the API.