`GET /v1/usage`

Просмотрите свой ресурс или состояние процесса без запуска новой генерации.

Пример запроса#

curl 'https://platform.tongai.io/v1/usage' \  -H "Authorization: Bearer $TONG_API_KEY"

Настройки

curl --version

Аутентификация#

Используйте серверный API-ключ для своего аккаунта или OAuth для аккаунта каждого клиента. Не передавайте ключи в запросах модели или аргументах инструментов.

usage:read

Параметры#

fromstringНеобязательно

Дата и время в формате ISO 8601, например 2026-10-22T09:00:00Z.

tostringНеобязательно

Дата и время в формате ISO 8601, например 2026-10-22T09:00:00Z.

channelstringНеобязательно

Допустимые значения"api""mcp"

credential_idstringНеобязательно

Шестнадцатеричный ID из 24 символов.

toolstringНеобязательно

Минимальная длина: 1 символов.

Максимальная длина: 100 символов.

modelstringНеобязательно

Выберите публичный ID модели Tong из актуальных возможностей.

Минимальная длина: 1 символов.

Максимальная длина: 150 символов.

categorystringНеобязательно

Минимальная длина: 1 символов.

Максимальная длина: 60 символов.

statestringНеобязательно

Допустимые значения"accepted""running""needs_review""paused""reconciling""succeeded""failed""cancelled"

searchstringНеобязательно

Максимальная длина: 150 символов.

activitystringНеобязательно

Допустимые значения"creative""all"

outcomestringНеобязательно

Допустимые значения"success""error""pending""cancelled"

limitintegerНеобязательно

Минимум: 1.

Максимум: 100.

По умолчанию: 40.

Тело запроса#

Этот эндпоинт не имеет тела запроса.

Схема ответа#

Ответ

JSON

{}

`HTTP 200`

application/json

object

Ошибки и ограничения#

HTTP	Ошибка	Восстановление
`400`	Недопустимый запрос`REQUEST_INVALID`	Перед повтором исправьте поля, указанные в ошибке.
`401`	Недействительные учётные данные`CREDENTIAL_INVALID`	Проверьте учётные данные, срок действия и отзыв доступа.
`402`	Недостаточно кредитов`INSUFFICIENT_CREDITS`	Пополните кредиты аккаунта, которому принадлежат учётные данные, и продолжите сохранённую работу.
`403`	Доступ запрещён`SCOPE_REQUIRED`	Используйте учётные данные с нужными разрешениями и доступом к выбранному ресурсу.
`404`	Ресурс недоступен`RESOURCE_UNAVAILABLE`	Проверьте ID ресурса и его принадлежность авторизованному аккаунту.
`409`	Конфликт намерений`IDEMPOTENCY_CONFLICT`	Повторно используйте намерение только с исходным запросом. Для другого действия создайте новый UUID.
`429`	Превышен лимит частоты`RATE_LIMITED`	Подождите время из Retry-After, прежде чем повторить тот же запрос.
`503`	Временно недоступно`DEPENDENCY_UNAVAILABLE`	Выждите Retry-After и повторите с тем же намерением. После тайм-аута проверьте сохранённую операцию.

АутентификацияAPI-ключи расходуют кредиты аккаунта-владельца. OAuth позволяет каждому пользователю тратить свои кредиты.Ошибки и ограничения частотыИзучите ошибки, безопасно повторяйте запросы и восстанавливайте неудачные генерации.Запросы и журналыПринятый запрос не означает завершённую генерацию. Отслеживайте сохранённое задание до готовности результата.