Credits & limits

Credits pay for model work: the moments Claude draws, rebuilds, choreographs or edits something new. Prices are fixed per action, so you know the cost before you send the request. Moving, recolouring and exporting what you already have never costs anything. One credit is worth $0.01.

Prices per action#

GET /credits returns these same prices under prices, keyed by action name, so clients can show a cost before the user confirms.

Plans#

Each plan grants a monthly allowance. Here is what an allowance buys if you spend it all on one kind of action:

• Allowances reset monthly. At the start of each calendar month the balance is set back to the plan's allowance. Unused credits don't roll over.
• Rate limits apply to API keys. Requests authenticated with a key (REST, MCP, CLI, SDK) count against a one-minute window per workspace. Over it, you get 429 rate_limited with a Retry-After header. The studio in your browser isn't limited.
• Credits belong to the workspace. Everyone in a team workspace spends from one balance; seats cap how many people that is (pending invites count). See Workspaces, roles and seats.
• Extra credit packs: coming soon. There is no way to buy credits on top of a plan yet.

Plan features beyond credits are on the pricing page.

Always free#

These never touch your balance, on any plan:

• Presets: all fifteen, fitted to your rig (POST /mascots/{id}/animations { preset }).
• Recolor by palette token.
• Canvases: creating, editing and running state machines.
• Exports in every format, at every size.
• Previews: rendered stills from GET /mascots/{id}/preview.
• Embeds: bundles for <lumorig-player>, however many views they get.

Also free: uploads, importing a spec you wrote, restoring versions, share links, and reading anything.

Holds, refunds and ceilings#

1. Hold. When a model-backed job starts, its full price is taken from the balance. Without enough credits the request fails with 402 insufficient_credits and nothing is created. A batch of motions checks the total for every prompt before starting any of them.
2. Refund. If the job fails or is canceled, the credits are returned automatically. A succeeded job keeps the charge.
3. Ceiling. Every job has a hard cost ceiling on its model spend: price × $0.01 × 0.7. A job that passes it is stopped (and refunded). Suggestions and website analysis make a single short model call, so their spend is recorded when it returns rather than checked mid-call. Pass max_cost_usd to set a lower ceiling for one job; a higher value is ignored.

{ "prompt": "a cheerful lighthouse keeper", "max_cost_usd": 0.4 }

Every job also reports what it actually spent in cost_usd, and GET /usage totals model spend by job type.

Checking your balance#

curl https://lumorig.com/api/v1/credits \
  -H "Authorization: Bearer $LUMORIG_API_KEY"

{
  "object": "credits",
  "billing": true,
  "plan": { "id": "free", "label": "Free", "price_usd": 0, "monthly_credits": 200 },
  "balance": 120,
  "prices": {"generate":80,"generate_detailed":250,"reconstruct":120,"edit":40,"variant":60,"animate":20,"scene":50,"suggest":5,"analyze":5},
  "credit_usd": 0.01,
  "free": ["presets", "recolor", "canvases", "exports", "previews", "embeds"]
}

Limits#

Requests outside these bounds fail with 400 invalid_request.

• ErrorsWhat a 402 or a stopped job looks like.
• PricingPlans side by side.