Документация API

Полный каталог моделей (по сценариям)

Сценарии использования

Биллинг pay-as-you-go: с баланса в рублях списывается стоимость input- и output-токенов. Один ключ — все провайдеры. При нулевом балансе пополните кабинет — ключ продолжит работать.

Эндпоинты

API совместим с OpenAI Chat Completions и Anthropic Messages. Используйте Cursor, n8n, OpenAI SDK, Claude Code — один ключ rk_live_…, провайдер выбирается полем model (GPT, Claude, DeepSeek).

Legacy URL https://kupiapi.ru/api/v1/chat по-прежнему работает.

Anthropic Messages API (Claude Code, Anthropic SDK). Тот же ключ rk_live_…, модели claude-sonnet, claude-opus, claude-haiku (и версии 4.x).

Публичный список моделей в OpenAI-формате ({ object: "list", data: [...] }). Если передан валидный ключ, у привязанной к нему модели будет default: true.

Streaming

Эндпоинт /v1/chat/completions поддерживает stream: true — для OpenAI-совместимых моделей (GPT, DeepSeek и др.) ответ идёт как SSE. Заголовок x-kupiapi-stream-supported: true означает, что клиент может включать стриминг. Если upstream не отдал поток, возможен fallback на обычный JSON-ответ.

Частые ошибки интеграции

Проверьте эти пункты, если клиент (Cursor, n8n, SDK) не подключается с первого раза.

• Неверный Base URL. OpenAI-клиенты: https://kupiapi.ru/v1 — без слеша в конце. Anthropic в n8n: https://kupiapi.ru (без /v1). Не api.openai.com.
• Чужой ключ. Используйте только rk_live_… из кабинета KupiAPI, не sk-… OpenAI.
• Пробелы в ключе. Скопируйте ключ целиком, без пробелов и переносов строк.
• Нет поля model. Укажите модель явно или возьмите список через GET https://kupiapi.ru/v1/models.
• Legacy-ключ. Старые пакетные ключи работают только с одним провайдером — для всех моделей пополните кошелёк в кабинете.
• Нулевой баланс. Ошибка payment_required (HTTP 402) — пополните кабинет, ключ менять не нужно.

Формат ошибок

Все ошибки возвращаются в OpenAI-совместимом формате с заголовкомx-request-id для сопоставления с логами поддержки.

{
  "error": {
    "message": "Недостаточно средств на кошельке.",
    "type": "insufficient_quota",
    "code": "payment_required",
    "hint": "Пополните баланс в кабинете — API-ключ и Base URL менять не нужно."
  }
}

Возможные type: invalid_request_error, insufficient_quota, api_error, rate_limit_error, server_error.

Получить список моделей

curl https://kupiapi.ru/v1/models

Авторизация необязательна. Передача Authorization: Bearer … добавляет default: true к модели купленного ключа.

Баланс и пополнение

Основной способ — личный кабинет: /cabinet. Пополнение от 200 ₽ картой или СБП, списание по факту каждого запроса. API-ключ создаётся в кабинете и не меняется при пополнении.

1. Проверка баланса по API-ключу:

curl -X POST https://kupiapi.ru/api/keys/balance \
  -H "Content-Type: application/json" \
  -d '{"apiKey":"rk_live_…"}'

Возвращает billingMode: wallet, balanceRub, status. Полный ключ в ответе не возвращается.

2. Пополнение кошелька (авторизованный кабинет):

curl -X POST https://kupiapi.ru/api/cabinet/wallet-deposit \
  -H "Content-Type: application/json" \
  -H "Cookie: kupiapi_cabinet_session=…" \
  -d '{"amountRub":500}'

3. Пополнение с сайта (без сессии, по email):

curl -X POST https://kupiapi.ru/api/public/wallet-deposit \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com","amountRub":500}'

Возвращает paymentUrl — ссылку на Robokassa. После оплаты webhook зачислит рубли на кошелёк email; при первом пополнении выдаётся API-ключ. Legacy POST /api/checkout и /api/checkout/topup отключены (410).

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

Передайте API-ключ как Bearer-токен в заголовке Authorization.

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

curl https://kupiapi.ru/v1/chat/completions \
  -H "Authorization: Bearer rk_live_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4-mini",
    "messages": [
      {"role": "user", "content": "Привет!"}
    ],
    "temperature": 0.7,
    "max_tokens": 500
  }'

Тело запроса

Пример ответа

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1710000000,
  "model": "gpt-5.4-mini",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Привет! Чем могу помочь?"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 9,
    "completion_tokens": 12,
    "total_tokens": 21
  }
}

Ошибки API

Поле hint подсказывает, что исправить. В поддержку передавайте x-request-id из заголовка ответа.