Быстрый старт

Первый запрос

Готовые curl для Claude, OpenAI, разбор структуры ответа и таблица типовых кодов ошибок.

Обновлено 21 июл. 2026 г.6 мин
#первый запрос#curl#claude#openai#ошибки#коды

Три готовых запроса — по одному на вендора. Подставьте свой ключ cr_… вместо cr_your_key. Все примеры — на чистом curl, без SDK.

#Claude — messages

POST /claude/v1/messages
curl https://api.tkbk.io/claude/v1/messages \
  -H "Authorization: Bearer cr_your_key" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 512,
    "messages": [{"role": "user", "content": "Привет! Кратко: что такое tkbk.io?"}]
  }'

#OpenAI и Codex — chat completions

POST /openai/v1/chat/completions
curl https://api.tkbk.io/openai/v1/chat/completions \
  -H "Authorization: Bearer cr_your_key" \
  -H "content-type: application/json" \
  -d '{
    "model": "gpt-5",
    "messages": [{"role": "user", "content": "Ответь одним предложением: чем полезен API-шлюз?"}]
  }'

#Разбор ответа

Ответ приходит в исходном формате вендора. Для Claude ключевые поля — content (текст) и usage (сколько токенов списано).

ответ Claude (сокращённо)
{
  "id": "msg_01AbC…",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-5",
  "content": [{ "type": "text", "text": "tkbk.io — это единый API-шлюз…" }],
  "stop_reason": "end_turn",
  "usage": { "input_tokens": 18, "output_tokens": 42 }
}

Поле usage и есть основа биллинга: за эти input_tokens и output_tokens списываются деньги. Подробнее — в разделе Как считаются деньги.

#Типовые коды ошибок

КодЗначениеЧто делать
400Неверное тело или параметрыПроверьте JSON и model.
401Неверный или отозванный ключСверьте cr_… и заголовок авторизации.
402Недостаточно средствПополните баланс в кабинете.
404Неизвестный путь или модельПроверьте эндпоинт и точный id модели.
429Превышен лимит (rpm / дневной / окно)Подождите и включите ретраи с backoff.
5xxОшибка upstream или шлюзаПовтор с backoff; работает авто-фолбэк на резерв.
Не помогло?

Напишите в Telegram — поможем с настройкой и подберём тариф. Или вернитесь ко всем разделам документации.