USD balance and billing
Understand published prices, reservations and generation failures.
Model prices
Each model document lists published USD prices by mode, resolution, duration and billing unit where applicable. Web, REST and MCP share the same account USD balance. Model availability and account entitlements also apply to API requests.
Reservations and settlement
Task creation reserves the applicable USD amount before provider submission. Completion settles the generation. Confirmed generation failures release the reservation. The billing receipt includes reserved, charged, released, refunded and net charged amounts. Money uses { currency: "USD", amount: "0.01000000" } objects with eight-decimal strings. Unverified amounts are null. Unknown provider outcomes keep their reservation.
Polling the same task and redelivering a callback reuse the original task. These operations do not generate another image or video.
Insufficient balance
HTTP 402 with code: insufficient_balance indicates an insufficient balance. Read your current USD balance with GET /api/v1/account and recharge through .
Safe retries
Send a stable Idempotency-Key when creating a task. Reuse the key and identical request body after a lost response. If upstream acceptance is still being reconciled, wait for that task to resolve. See .

