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

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

## Информация о ключе [#key]

<Method name="GET" path="/v1/key" />

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

**Ответ `200`**

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

<TypeTable
  type={{
    label: { type: 'string', description: 'Имя ключа и его последние четыре символа. Для подключения через OAuth — "Connected session".' },
    limit: { type: 'null', description: 'Отдельного лимита расхода у ключа нет, всегда null.' },
    usage: { type: 'number', description: 'Сколько кредитов этот ключ потратил за последние 30 дней с учётом возвратов.' },
    limit_remaining: { type: 'number', description: 'Сколько кредитов доступно на аккаунте сейчас. Баланс общий для всех ключей.' },
    is_free_tier: { type: 'boolean', description: 'Всегда false.' },
    'rate_limit.requests': { type: 'integer', description: 'Лимит запросов ключа в минуту.' },
    'rate_limit.interval': { type: 'string', description: 'Окно лимита, всегда "1m".' },
  }}
/>

Тот же баланс с разбивкой на кредиты подписки и купленные возвращает [`GET /v1/account`](/ru/docs/api-reference/account).

## Стоимость запроса [#cost]

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

<Method name="GET" path="/v1/generation" />

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

**Ответ `200`**

```json
{
  "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"
  }
}
```

<TypeTable
  type={{
    id: { type: 'string', description: 'Идентификатор, который вы передали в запросе.' },
    total_cost: { type: 'number', description: 'Списанные кредиты, дробное число.' },
    tokens_prompt: { type: 'integer | null', description: 'Токены ввода.' },
    tokens_completion: { type: 'integer | null', description: 'Токены ответа.' },
    native_tokens_prompt: { type: 'integer | null', description: 'То же, что tokens_prompt.' },
    native_tokens_completion: { type: 'integer | null', description: 'То же, что tokens_completion.' },
    finish_reason: { type: 'null', description: 'В журнале не хранится, всегда null.' },
    model: { type: 'string | null', description: 'Идентификатор модели, которая ответила.' },
    provider: { type: 'string', description: 'Всегда "Clipia".' },
    streamed: { type: 'null', description: 'В журнале не хранится, всегда null.' },
    created_at: { type: 'string', description: 'Время запроса, ISO 8601.' },
  }}
/>

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

## Лимиты [#limits]

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

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

Подробно — на странице [«Лимиты»](/ru/docs/api-reference/rate-limits).

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

<TypeTable
  type={{
    'RateLimit-Limit': { type: 'integer', description: 'Лимит запросов ключа в минуту.' },
    'RateLimit-Remaining': { type: 'integer', description: 'Сколько запросов ключа осталось в текущей минуте.' },
    'RateLimit-Reset': { type: 'integer', description: 'Момент сброса окна, Unix-время в секундах.' },
    'x-ratelimit-remaining-requests': { type: 'integer', description: 'То же, что RateLimit-Remaining, в формате OpenAI.' },
    'x-ratelimit-remaining-tokens': { type: 'integer', description: 'Сколько токенов осталось в текущей минуте. Только если задан лимит токенов.' },
    'Retry-After': { type: 'integer', description: 'Приходит с ответом 429: через сколько секунд можно повторить.' },
  }}
/>

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

### Ответ 429

```http
HTTP/1.1 429 Too Many Requests
Retry-After: 12
Content-Type: application/json
```

```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"
  }
}
```

<Callout type="info" title="Соблюдайте Retry-After">
При `429` подождите столько секунд, сколько указано в `Retry-After`, и только потом повторяйте запрос — это надёжнее фиксированной задержки.
</Callout>
