Три GET-эндпоинта только для чтения: текущий баланс, сводка использования и история движений по счёту. Все требуют авторизации (Bearer или x-api-key).
/v1/balanceБаланс в нано единицах валюты аккаунта — поле currency (1 единица = 1e9 нано, целые числа без округления). Для аккаунтов USD это нано-USD. Поля *_rub_nano и rub_per_usd — устаревшее справочное отображение в рублях (для аккаунта RUB равны балансу без пересчёта).
curl https://api.evomodels.xyz/v1/balance \
-H "Authorization: Bearer sk-ev-ВАШ_КЛЮЧ"{
"currency": "USD",
"balance_nano": "5000000000",
"live_nano": "120000000",
"available_nano": "4880000000",
"balance_rub_nano": "391580000000",
"available_rub_nano": "382220000000",
"rub_per_usd": 78.316
}| Параметр | Тип | Описание |
|---|---|---|
currencyопционально | string | Валюта аккаунта — единица всех *_nano полей (USD | RUB). |
balance_nanoопционально | string | Зачисленный баланс в нано валюты аккаунта. |
live_nanoопционально | string | Зарезервировано под запросы «в полёте». |
available_nanoопционально | string | Доступно к трате: balance − live. |
balance_rub_nanoопционально | string | Устар.: баланс в нано-₽ (справочно). |
available_rub_nanoопционально | string | Устар.: доступно в нано-₽. |
rub_per_usdопционально | number | Устар.: курс ₽/USD (1 для аккаунта RUB). |
/v1/usageАгрегированная сводка по токенам и стоимости. Диапазон — через ?since= и ?until= (ISO-8601), необязательные.
curl "https://api.evomodels.xyz/v1/usage?since=2026-06-01&until=2026-06-27" \
-H "x-api-key: sk-ev-ВАШ_КЛЮЧ"{
"currency": "USD",
"prompt_tokens": 184320,
"completion_tokens": 51200,
"cached_tokens": 40960,
"reasoning_tokens": 8192,
"cost_nano": "734000000",
"request_count": 142
}/v1/billing/historyЖурнал движений по счёту (object: "list" с limit, offset, массивом data). Каждая запись — зачисление или списание; request_id совпадает с x-request-id запроса.
curl https://api.evomodels.xyz/v1/billing/history \
-H "Authorization: Bearer sk-ev-ВАШ_КЛЮЧ"{
"object": "list",
"limit": 50,
"offset": 0,
"data": [
{
"id": "bil_01ABCxyz...",
"type": "debit",
"amount_nano": "-2340000",
"balance_after_nano": "4877660000",
"request_id": "req_01DEFuvw...",
"created_at": "2026-06-27T11:42:08Z"
}
]
}credit), а само пополнение делается в Панели. Список моделей — GET /v1/models.