Discounts
A multiplier on list price, applied per entrypoint.
How discounts work
Your charge is list price × multiplier. The multiplier is specific to your account and to one entrypoint. An entrypoint is a group of models, not a single model.
One multiplier covers every model behind its entrypoint. You hold at most one active discount per entrypoint, and entrypoints you pay list price for have no row at all.
Checking your discounts
GET /v1/discounts takes no parameters and returns only your own rows. It uses the same API key for authentication as every other endpoint.
200 carries a single discounts array, sorted by entrypoint. The API returns standard error codes with a JSON error body.
No active discount is a normal
200, not an error. An empty array means list price applies everywhere.
multiplier and nothing precomputed, so derive any percentage you want to display yourself.
PollingThis is a free poll and it never takes a job slot. It still counts toward your requests per minute, and a discount changes rarely, so caching the response for minutes is fine. There is no webhook for discount changes.
Reading the multiplier
Themultiplier field is the fraction of list price you pay.
Time windows
Every discount has a start date and may have an end date.
The endpoint returns only the discounts that are active now. One that has not started yet, or that has already ended, is left out entirely rather than returned as an inactive row.