AI Gateway
Ключ и лимиты
GET /v1/key (ключ, расход за 30 дней, баланс и лимит), GET /v1/generation (стоимость запроса по id), заголовки лимитов и ответ 429 LLM-чата Clipia AI Gateway.
GET /v1/key показывает, какой ключ вы используете, сколько он потратил за последние 30 дней, сколько кредитов доступно на аккаунте и какой у ключа лимит запросов. Стоимость отдельного запроса к чату возвращает GET /v1/generation по id ответа.
Информация о ключе
/v1/keycurl 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 генерации.
/v1/generationcurl "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, и только потом повторяйте запрос — это надёжнее фиксированной задержки.
LangChain
Подключите Clipia AI Gateway к LangChain через ChatOpenAI с base_url Clipia — чат, инструменты, агенты и структурированный вывод на Claude, GPT и Gemini.
Clipia для AI-агентов
Подключите Clipia к Claude Code, claude.ai, ChatGPT, Cursor, VS Code, Codex и Gemini CLI — более 60 моделей фото и видео в чате агента по ключу или OAuth.