Credits and costs

See what each generation costs, check your balance and buy credits.

What generation costs#

No credits for background removal, format conversion, resizing, uploads, reading metadata, analyzing an image or website, or reviewing a generation plan. Preview images are paid even though their URLs expire.

What credits cost#

Bigger purchases give more credits per dollar, so a minute of talking costs $18 with the smallest pack and $13.33 from $1,000. Any amount from $10 works in Billing.

Amounts below $50 give 6⅔ credits per dollar, $50 to $199.99 give 8, $200 to $999.99 give 8.5, and $1,000 or more give 9.

Check your balance#

Run masko credits (or --json), or await Masko.client().credits() in the TypeScript SDK. masko whoami shows the account and workspace it belongs to.

curl https://api.masko.ai/v1/credits \
  -H "Authorization: Bearer $MASKO_API_KEY"

{
  "data": {
    "subscription": 450,
    "topup": 100,
    "total": 550
  }
}

Subscription credits are spent before top-up credits. Buy credits and see terms in Billing; asset hosting is billed separately.

Buy credits from an API or agent#

Create a Stripe-hosted checkout page for your credential's workspace; it never charges a saved card or buys automatically. Team purchases require the active team owner.

curl https://api.masko.ai/v1/credit-checkouts \
  -H "Authorization: Bearer $MASKO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: credit-purchase-001" \
  -d '{"amount_cents":2000}'

• amount_cents: whole USD cents from 1000 to 1000000 ($10 to $10,000). Send no organization ID, price, credit quantity, payment method or return URL.
• The response has id, url, credits, amount_cents, currency, organization_id, expires_at and status_url. Open url to confirm the final amount on Stripe; never give card details to an agent.
• After a timeout, reuse the same Idempotency-Key and body (replays last 24 hours). If the URL expired, check status before buying again.

curl https://api.masko.ai/v1/credit-checkouts/CHECKOUT_ID \
  -H "Authorization: Bearer $MASKO_API_KEY"

Only its creator can read a checkout, from the same workspace. A paid checkout with credits_added: false is still delivering credits, so check again rather than paying twice; balance is the workspace balance, not a receipt. Only Stripe's verified webhook grants credits, once; reading status never does.

Connected agents get create_credit_checkout (amount_cents and a stable UUID operation_id) and get_credit_checkout (id). Create a checkout only when the user asks to buy credits; it is a hosted link, not an automatic payment. ChatGPT does not get these tools: it spends the credits already in the workspace you connected, and you buy credits in Billing.

Approve a plan#

For canvas generation, dry-run first, then submit the same selection, approved plan ID and graph hash, so a changed graph cannot silently cost more.

Credits are allocated when work is accepted, and a client timeout does not prove failure. Check the job or run before retrying, and use persisted idempotency keys where supported; /generate has no run-level replay.

Insufficient credits#

A rejected request returns HTTP 402:

{
  "error": {
    "code": "insufficient_credits",
    "message": "Insufficient credits",
    "details": {
      "required": 21,
      "balance": 5
    }
  }
}

Rely on error.code; messages and optional details differ by endpoint.

Failures and refunds#

A partly failed run can still hold successful paid assets. Runs report allocated_credits, credits_refunded and refund_status where available; a missing refund value promises nothing.

If the source video succeeded but transparent formats failed, use media repair instead of a new paid generation (generation progress and repair).