API reference · Pricing
Current public prices (no authentication)
/v1/pricing- TypeScript
client.pricing.getPriceSheet()- Python
client.pricing.get_price_sheet()- CLI
hayonix prices
The prices charged from now on, for every product. A new price list is charged from the moment it takes effect, and responses may be cached for up to 30 seconds.
None: this operation is public.
Examples
The samples read API_KEY and API_BASE_URL from the environment (see Setup). Values are examples.
curl -sS "$API_BASE_URL/pricing" \
-H "Authorization: Bearer $API_KEY"Request
Response
200 PriceSheet — The price sheet in force
objectstringrequiredAlways `price_sheet`: the type of this object
One of
price_sheetversionintegerrequiredVersion of the price list in force; it rises with each new one
effective_fromstring (date-time)requiredWhen these prices took effect (ISO 8601, UTC)
currencystringrequiredAlways `usd`
One of
usdpricesarray of objectrequiredEvery public price, by product, meter and price key
ShowHide 11 fields of
pricesproductstringrequiredProduct the price belongs to, for example `compute`, `inference`, `batch_inference`, `training` or `storage`
meterstringrequiredWhat is measured and charged, for example `gpu_second` or `output_token`
price_keystringrequiredWhat is priced: a hardware type code, a model’s price key, or `batch:` followed by one for batch prices
display_namestring | nullrequiredName to show people
display_unitstring | nullrequiredThe unit to show next to the price, for example `per 1M tokens`; null when none
unit_pricestringrequirednano-USD per unit_quantity units
pattern ^-?[0-9]+$
unit_quantitystringrequiredHow many units of the meter `unit_price` is for (decimal string)
per_secondstring | nullrequiredCompute: whole nano-USD per second (what is billed)
pattern ^-?[0-9]+$
per_hourstring | nullrequiredCompute: per_second × 3600 (derived)
pattern ^-?[0-9]+$
placeholderbooleanrequiredThis price is a development placeholder, not an offered price (the model is marked so in the catalog, or the price book in force is a placeholder book)
modelobject | nullrequiredThe public catalog model this price belongs to, if any
ShowHide 5 fields of
modelslugstringrequiredModel ID to send in inference requests (`publisher/name`)
display_namestringrequiredName to show people
kindstringrequiredWhat the model does: `chat`, `completion`, `embedding`, `rerank`, `image`, `speech_to_text` or `text_to_speech`
publisherstring | nullrequiredWho published the model; null when not recorded
context_lengthinteger | nullrequiredLargest context in tokens; null when it does not apply
notesstring | nullrequiredOperator notes on the price book version in force
placeholderbooleanrequiredThe price book in force is a placeholder book (its notes start with "PLACEHOLDER"): show it as a draft, not as offered prices
Example response
{
"object": "price_sheet",
"version": 1,
"effective_from": "2026-01-01T00:00:00.000Z",
"currency": "usd",
"prices": [
{
"product": "string",
"meter": "string",
"price_key": "string",
"display_name": "string",
"display_unit": "string",
"unit_price": "1500000000",
"unit_quantity": "string",
"per_second": "1500000000",
"per_hour": "1500000000",
"placeholder": true,
"model": {
"slug": "string",
"display_name": "string",
"kind": "string",
"publisher": "string",
"context_length": 1
}
}
],
"notes": "string",
"placeholder": true
}Errors
Errors use the standard envelope. What this operation can answer:
| Status | Type | When |
|---|---|---|
429 | rate_limit_error rate_limited | Too many requests; retry after retry-after seconds. |