Account API

Read-only API для баланса, usage и транзакций.

Авторизация

Создайте acct-… в Dashboard → API-доступ.

Header

Authorization: Bearer $GPU42_ACCOUNT_TOKEN

Методы

Метод	Endpoint	Результат
GET	`/v1/account/me`	Аккаунт
GET	`/v1/account/balance`	Текущий баланс
GET	`/v1/account/usage`	Usage за период
GET	`/v1/account/usage/by-key`	Usage по API-ключам и моделям
GET	`/v1/account/usage/records`	Записи по запросам; cursor pagination
GET	`/v1/account/transactions`	Транзакции; type=usage для списаний

Период

Параметр	Тип	Описание
`from`	`string`	Начало периода, включительно
`to`	`string`	Конец периода, не включается
`timezone`	`string`	IANA timezone; по умолчанию UTC

from и to принимают YYYY-MM-DD или RFC 3339. Максимальный период — 366 дней.

Запрос

Terminal

curl -sS -G https://api.42gpu.ru/v1/account/usage \
  -H "Authorization: Bearer $GPU42_ACCOUNT_TOKEN" \
  --data-urlencode "from=2026-09-01" \
  --data-urlencode "to=2026-09-02" \
  --data-urlencode "timezone=Europe/Moscow"

Ответ

200 OK

{
  "period_start": "2026-08-31T21:00:00Z",
  "period_end": "2026-09-01T21:00:00Z",
  "total_requests": 0,
  "total_input_tokens": 0,
  "total_output_tokens": 0,
  "total_tokens": 0,
  "total_cost": "0.00000000",
  "currency": "RUB",
  "timezone": "Europe/Moscow",
  "by_model": [],
  "by_provider": {}
}