Developer API
Credit fields
Video jobs return credits_deducted and remaining_credits. Ricochet hosted AI usage can return approval_required, budget_exceeded, insufficient_credits, credits_charged, and billing_url.
#Credit fields
Video and Ricochet responses include credit and budget fields so clients can show clear usage state.
credits_deductedremaining_creditsapproval_requiredbudget_exceeded#Idempotency
Create-style requests should send an Idempotency-Key to avoid duplicate jobs or duplicate credit charges.
Idempotency-Key
Use a stable key per user action, not per retry attempt.