USD pricing and prepaid PAYG
Preview the exact service value before work, cap every acceptance, and fund new work with prepaid USD.
The preview is authoritative
Prices depend on the complete Asset request, model, options, and current catalog. Always call the preview endpoint immediately before create. The response returns decimal USD strings per Asset and in total; client code must not calculate or cache prices.
const preview = await client.generations.preview(draft)
const generation = await client.generations.create({
...draft,
max_cost_usd: preview.total_cost_usd,
})Prepaid service balance
PAYG work reserves the full accepted amount before provider effects. Add funds through the Platform or the OAuth-only prepayment endpoint. Stripe may add applicable tax during Checkout; using purchased service balance is not charged again.
Use USD vocabulary
The Platform uses promotional USD and prepaid service balance—not tokens, credits, subscriptions, or a wallet.
Insufficient funds
A payment_required response creates no Generation, reservation, or provider effect. Add funds, refetch authoritative usage, re-preview the unchanged draft, and require an explicit acceptance. Never reduce the requested work or auto-submit after Checkout.