Перейти к содержимому
Зарегистрироваться бесплатно
API Reference

Как получить журналы запросов одного API Key

Получите до 1000 последних записей запросов одного BetterToken API Key. Узнайте, как читать время, Request ID, число токенов и сумму расхода в валюте записи.

Используйте GET https://bettertoken.ai/api/log/token, чтобы получить последние записи запросов одного BetterToken API Key.

Отправка запроса

Используйте тот же BetterToken API Key с префиксом sk-..., с которым вызываете модели. Перед запуском команды задайте его в локальной переменной окружения BETTERTOKEN_API_KEY.

Передайте Authorization: Bearer <API_KEY>. У запроса нет параметров и тела. Полный URL не содержит /v1.

Окно терминала
curl -sS 'https://bettertoken.ai/api/log/token' \
-H "Authorization: Bearer ${BETTERTOKEN_API_KEY}"

Успешный ответ

При успешном запросе success равен true, а data содержит массив записей этого Key. Последние добавленные записи идут первыми; возвращается не более 1000 записей.

У интерфейса нет пагинации, фильтра по времени или Request ID.

В примере показаны только часто используемые поля. Значения приведены для демонстрации.

{
"success": true,
"message": "",
"data": [
{
"created_at": 1795046400,
"type": 2,
"model_name": "gpt-6.2-sol",
"request_id": "example-request-id",
"prompt_tokens": 120,
"completion_tokens": 48,
"quota": 600,
"recorded_amount": "0.0012",
"currency": "USD"
}
]
}

Поля записи

ПолеЗначение
created_atВременная метка Unix в секундах.
model_nameID модели.
request_idЕсли поле присутствует, используйте его для сопоставления записи с запросом к модели.
prompt_tokensЗаписанное число входных токенов; зависит от интерфейса и способа тарификации.
completion_tokensЗаписанное число выходных токенов; зависит от интерфейса и способа тарификации.
type2 означает запись о расходе.
quotaЗначение квоты в записи, во внутренних единицах квоты.
recorded_amountСумма в виде десятичной строки. Возвращается для записей о расходе с сохранённым коэффициентом пересчёта.
currencyВалюта суммы, например USD.

Как учитывать суммы

Если recorded_amount отсутствует, не считайте сумму нулевой. Суммируйте записи отдельно для каждой валюты currency.

Дополнительные сведения

Суммарный расход и остаток этого Key описаны в разделе Квота API Key. Историю на уровне аккаунта можно посмотреть в BetterToken Workspace.