GET `/v1/ai/credits`

Zinn® credit balance, whether to offer more, and the packs for sale.

Аутентификација

Пошаљите API кључ као bearer токен. Кључ мора имати дозволу sites.view; кључ без ње се одбија уз 403, а не 404.

Где се уноси ID ваше организације

Ова крајња тачка прихвата org_id као параметар упита. Изоставите га и позив ће обухватити цело подстабло вашег закупа; пошаљите га да бисте сузили позив на једну организацију.

Идентификатор ваше организације се налази на екрану са API кључевима на вашој контролној табли, поред самог кључа. То је исти идентификатор у сваком позиву који упутите.

Испробајте

Замените све што је у угластим заградама сопственим вредностима, а чувар места кључа кључем са своје контролне табле.

curl -X GET https://api.zinndigital.com/v1/ai/credits \
  -H "Authorization: Bearer zdk_live_…"

Пријављени сте? API конзола на вашој контролној табли попуњава ваш прави id организације и ваш сопствени кључ, и покреће захтев према живом API-ју како бисте могли да видите стварни одговор. Отворите ову крајњу тачку у API конзоли

Детаљи

Everything the three credit surfaces need, in one request: the balance, whether this customer is genuinely short, and the packs they can buy. The AI page, the header chip and the upsell banner all read this endpoint rather than each deciding "is this customer low?" for itself. Two behaviours reading one fact is how a header comes to nag somebody the banner has decided is fine, so state.is_low is computed server-side and every surface renders it. state.on_byo is true only when a live customer key exists for every provider we route to, so credits genuinely cannot be spent. The banner must stay silent in that case: selling credit to somebody whose every call runs on their own key sells them something that will never be spent. It is not "this org has a key" — a customer holding one Anthropic key still pays us for Google, OpenAI and xAI. Amounts are USD micros (1 minor unit = 10,000 micros; 1 USD = 1,000,000), because one model call costs a fraction of a cent and rounding each one up to a penny over-bills by two orders of magnitude. packs[].price_minor is ordinary integer minor units, because that is what the customer is charged. Requires sites.view.

Параметри

Назив	Тип	Обавезно	Шта је ово
`org_id (query)`	`Uuid`	Не	Which organization this is about. Required when the caller belongs to more than one; a caller in exactly one may omit it.

Одговор

Назив	Тип	Обавезно	Шта је ово
`state`	`AiCreditState`	Да	—
`packs`	`AiCreditPack[]`	Да	—
`settings`	`AiCreditSettings`	Да	The customer's standing instruction about topping up, and what has become of it. Owner, 2026-08-24, reading `/ai` on production:…
`history`	`AiCreditHistoryLine[]`	Да	The 25 most recent movements, newest first.
`funding_routes`	`AiProviderFunding[]`	Да	Who pays for the next call, per provider. Read on the SAME request as the balance, so a screen cannot render a funding claim from one moment beside a balance from another.
`spends`	`AiCreditSpend[]`	Да	Everything this credit buys — the metered surfaces derived from the engine's own meter, the credit-only spends that write no usage row, and the fixed-price AI products.

Грешке које ова крајња тачка може вратити

401 · 403 · 422 · 429

GET /v1/ai/credits