API reference

API reference · Credits

Paid plans on offer, and this account's plan

GET/api/account/planSigned in session

A plan is bought from the personal credit balance (stablecoin funded) for 30 days at a time and multiplies the per key rate limit for every key the account minted. With a holder tier as well, the larger multiplier applies, never the product. It raises rate limits only: there is no request priority. Reading renews the account's own plan when it is due. Off unless the operator set ANTIMATTER_PLANS; a period already paid is honoured to its end either way.

Answer 200

The offer and the account's plan.

Fields of the 200 answer
FieldTypeWhat it is
enabledrequiredbooleanFalse unless the operator set ANTIMATTER_PLANS.
periodDaysinteger
baseRpmintegerANTIMATTER_API_RPM, the per key limit without a plan or holder tier.
plansrequiredarray of object
plans[].idstring
plans[].namestring
plans[].priceMicrosintegerWhat one 30 day period costs, from the credit balance.
plans[].rateMultipliernumberMultiplies ANTIMATTER_API_RPM per key.
plans[].includedCreditMicrosintegerCredit added at the start of every paid period; 0 for none.
plans[].requestsPerMinuteintegerThe per key limit this plan gives on this deployment.
plans[].studioobject or nullWhat the plan grants in Nova Studio, or null for nothing. Studio credit is spent on video, sound and 3D jobs before the balance, and on nothing else.
plans[].studio.creditMicrosintegerStudio credit each paid period; 0 for none.
plans[].studio.maxActiveJobsinteger or nullA render plan's shots at once, where the plan raises the deployment's own; else null.
plans[].studio.jobMarkupDiscountBpsintegerOff the margin of every take, never below the provider's price; 0 for none.
currentrequiredobject or nullThe active subscription, paid through periodEnd. Its terms are the ones it was paid on.
current.subscriptionIdinteger
current.planIdstring
current.namestring
current.periodinteger1 for the first paid period, one more per renewal.
current.periodStartinteger
current.periodEndinteger
current.priceMicrosinteger
current.rateMultipliernumber
current.includedCreditMicrosinteger
current.cancelAtPeriodEndboolean
current.nextPlanIdstring or nullA switch waiting for renewal.
current.renewsAtinteger or nullWhen the next charge falls due; null when it will not renew.
current.renewalPriceMicrosinteger or nullWhat that charge will be, from the configuration.
current.studioobject or nullWhat this period grants in Nova Studio and the studio credit left of it, as GET /api/studio/plan answers it; null for nothing.
current.studio.plan_idstring
current.studio.period_endinteger
current.studio.credit_microsinteger
current.studio.credit_left_microsinteger
current.studio.max_active_jobsinteger or null
current.studio.job_markup_discount_bpsinteger
lastEndedrequiredobject or nullWith no active plan, how the last one ended.
lastEnded.planIdstring
lastEnded.namestring
lastEnded.endedAtinteger
lastEnded.reasonstringOne of "cancelled", "lapsed", "withdrawn", "frozen".
lastEnded.periodEndinteger

Errors

  • 401OpenAI shaped error.

Every error answers in one shape, with its type, code and the field it names. The whole list is in the docs' Errors section.

Antimatter