Перейти к содержимому

AI Gateway

Ключ и лимиты

GET /v1/key (ключ, расход за 30 дней, баланс и лимит), GET /v1/generation (стоимость запроса по id), заголовки лимитов и ответ 429 LLM-чата Clipia AI Gateway.

GET /v1/key показывает, какой ключ вы используете, сколько он потратил за последние 30 дней, сколько кредитов доступно на аккаунте и какой у ключа лимит запросов. Стоимость отдельного запроса к чату возвращает GET /v1/generation по id ответа.

Информация о ключе

GET/v1/key
curl https://api.clipia.ai/v1/key \
  -H "Authorization: Bearer $CLIPIA_KEY"

Ответ 200

{
  "data": {
    "label": "prod key (····a1b2)",
    "limit": null,
    "usage": 1240.5,
    "limit_remaining": 8320,
    "is_free_tier": false,
    "rate_limit": { "requests": 120, "interval": "1m" }
  }
}

Свойство

Тип

Тот же баланс с разбивкой на кредиты подписки и купленные возвращает GET /v1/account.

Стоимость запроса

В ответе чата usage содержит только расход токенов (в потоке — в последнем чанке при stream_options: { "include_usage": true }, см. Chat Completions). Стоимость выполненного запроса в кредитах возвращает GET /v1/generation: в id передайте идентификатор ответа chatcmpl-… (для POST /v1/completions — cmpl-…) или request_id генерации.

GET/v1/generation
curl "https://api.clipia.ai/v1/generation?id=chatcmpl-3f9a1c7e2b41" \
  -H "Authorization: Bearer $CLIPIA_KEY"

Ответ 200

{
  "data": {
    "id": "chatcmpl-3f9a1c7e2b41",
    "total_cost": 0.046,
    "tokens_prompt": 28,
    "tokens_completion": 64,
    "native_tokens_prompt": 28,
    "native_tokens_completion": 64,
    "finish_reason": null,
    "model": "claude-opus-5-5",
    "provider": "Clipia",
    "streamed": null,
    "created_at": "2026-11-04T12:00:00.000Z"
  }
}

Свойство

Тип

Поиск идёт только по запросам вашего аккаунта: чужой или неизвестный id возвращает 404 not_found. Общий расход ключа за 30 дней показывает GET /v1/key, а журнал запросов — вкладка Логи в консоли разработчика.

Лимиты

На LLM-чат действуют те же лимиты, что и на остальной API:

  • 120 запросов в минуту на ключ и 600 на все ключи аккаунта; для подключения через OAuth — 60 запросов в минуту;
  • лимит параллельности, если он задан для ключа или аккаунта;
  • лимит токенов в минуту, если его задала команда Clipia, и бюджет кредитов, если его задал владелец ключа; по умолчанию не заданы.

Подробно — на странице «Лимиты».

Заголовки ответа

Свойство

Тип

В потоковых ответах (stream: true) этих заголовков нет: сервер отправляет только заголовки SSE. Значения лимитов тогда смотрите в обычном запросе, например в GET /v1/key.

Ответ 429

HTTP/1.1 429 Too Many Requests
Retry-After: 12
Content-Type: application/json
{
  "error": {
    "message": "API rate limit exceeded. Slow down and retry after the reset window.",
    "type": "rate_limit_error",
    "param": null,
    "code": "rate_limit_exceeded"
  }
}

Соблюдайте Retry-After

При 429 подождите столько секунд, сколько указано в Retry-After, и только потом повторяйте запрос — это надёжнее фиксированной задержки.