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

Всё, что нужно для интеграции с нашим API. Если чего-то не хватает — напишите на support@kupiapi.ru.

Доступные модели

Провайдер	Модель	ID
OpenAI	GPT-5.4 mini	gpt-5.4-mini
OpenAI	GPT-5.4	gpt-5.4
Anthropic	Claude Sonnet 4.6	claude-sonnet-4.6
Anthropic	Claude Opus 4.7	claude-opus-4.7

Эндпоинт

POST https://kupiapi.ru/api/v1/chat

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

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

Authorization: Bearer rk_live_xxxxxxxx

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

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

Тело запроса

Поле	Тип	Обязательно	Описание
messages	array	Да	Массив сообщений с полями `role` и `content`
temperature	number	Нет	От 0 до 2. По умолчанию 1.
max_tokens	number	Нет	Максимальное количество токенов в ответе.

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

{
  "id": "chatcmpl-abc123",
  "provider": "openai",
  "model": "gpt-5.4-mini",
  "content": "Привет! Чем могу помочь?",
  "finishReason": "stop",
  "usage": {
    "promptTokens": 9,
    "completionTokens": 12,
    "totalTokens": 21
  }
}

Ошибки

401invalid_api_key

API-ключ отсутствует, некорректен или не найден.

403tokens_exhausted

Все токены по этому ключу израсходованы. Купите новый ключ.

400invalid_request

Тело запроса некорректно (проверьте массив messages).

502upstream_error

AI-провайдер вернул ошибку. Попробуйте позже.

Важно

Каждый API-ключ привязан к конкретной модели, выбранной при покупке.
Расход токенов отслеживается по ключу. Когда лимит исчерпан, ключ деактивируется.
Учитываются и prompt-, и completion-токены.
Купите новый ключ в любой момент, чтобы получить свежий лимит токенов.
По вопросам ошибок и интеграции пишите на support@kupiapi.ru.