Ошибки API: что значат и как исправить

Шлюз не узнал ключ: его нет, он с опечаткой или Claude Code отправляет не тот ключ. Подробнее →

Частые причины: Ключ скопирован не целиком (обрезан конец или попал пробел); Одновременно заданы ANTHROPIC_API_KEY и ANTHROPIC_AUTH_TOKEN с разными значениями; Claude Code залогинен в аккаунт Anthropic и игнорирует переменные окружения. Подробнее →

1) Проверьте ключ на tkbk.online/login — если кабинет открылся, ключ рабочий 2) Оставьте одну переменную: ANTHROPIC_AUTH_TOKEN=cr_… и уберите ANTHROPIC_API_KEY 3) Выполните /logout в Claude Code и перезапустите терминал, чтобы подхватились переменные. Подробнее →

Объём на ключе израсходован или дневной лимит подписки исчерпан. Запросы не проходят, пока баланс не пополнен. Подробнее →

Частые причины: Израсходован общий объём ключа; Подписка: достигнут лимит на сутки — сбросится в начале следующих суток; Срок подписки истёк. Подробнее →

1) Посмотрите остаток в кабинете tkbk.online/dashboard 2) Пополните ключ в кабинете картой, ЮMoney или SberPay (криптовалютой — в Telegram-боте) — ключ менять не нужно 3) Чтобы не попадать в эту ошибку, включите вход через Telegram: бот предупредит, когда баланс будет на исходе. Подробнее →

Сейчас нет свободной мощности для этой модели. Это временно: обычно проходит за секунды или минуты. Подробнее →

Частые причины: Пиковая нагрузка на модель; Временный сбой одного из каналов, пока шлюз переключается на резервный. Подробнее →

1) Повторите запрос через 2–10 секунд с экспоненциальной задержкой — официальные SDK делают это сами (max_retries) 2) Для некритичных задач используйте псевдоним tkbk-fast или tkbk-cheap — шлюз сам выберет доступную модель 3) Проверьте tkbk.online/status: там видно, если у модели сейчас проблема. Подробнее →

Запрос не приняли из-за ограничения. У ключей TKBK нет своего лимита на число и параллельность запросов, поэтому 429 обычно значит, что модель сейчас перегружена. Подробнее →

Частые причины: Модель временно перегружена: свободного канала не нашлось ни на основном, ни на резервных; С вашего IP много раз подряд пришёл неверный ключ — шлюз блокирует такой IP на 10 минут; Агент или скрипт шлёт запросы в цикле без пауз и сам себе создаёт пики. Подробнее →

1) Добавьте повтор с экспоненциальной задержкой при 429 (0,5 с, 1 с, 2 с, 4 с) 2) Проверьте, что во всех инструментах стоит один и тот же правильный ключ cr_… 3) Если 429 идёт долго на одной модели — переключитесь на соседнюю модель или напишите в поддержку. Подробнее →

Ответ формировался дольше лимита соединения (около 2 минут) у канала модели. Подробнее →

Частые причины: Очень длинный ответ без стриминга; Большой контекст и reasoning-модель «думает» долго; Временная медленная работа канала. Подробнее →

1) Включите стриминг (stream: true) — первые токены придут сразу, соединение не будет простаивать 2) Сократите max_tokens или разбейте задачу на части 3) Повторите запрос: шлюз направит его в другой канал. Подробнее →

Указан идентификатор модели, которой нет в каталоге. Подробнее →

Частые причины: Опечатка в названии модели; Модель устарела или не поддерживается; Модель OpenAI отправлена в формате Anthropic или наоборот. Подробнее →

1) Сверьте id модели с каталогом tkbk.online/models — копируйте id оттуда 2) Claude — через ANTHROPIC_BASE_URL (формат Messages); GPT, DeepSeek, GLM, Grok — через https://api.tkbk.online/openai/v1 3) Старые id Claude (claude-3-5-sonnet, opus-4…) шлюз сам переводит на свежую модель семейства. Подробнее →

Ключ выпущен для другой модели: например, отдельный ключ DeepSeek не открывает Claude. Подробнее →

Частые причины: Ключ одной модели (DeepSeek V4 Pro, GLM-5.3 и т. п.) используется для другой модели; Ключ-подписка с ограничением моделей. Подробнее →

1) Используйте модель, для которой куплен ключ (видно в кабинете) 2) Нужны все модели — возьмите обычный ключ: Claude, GPT, Gemini, DeepSeek, GLM и Grok в одном. Подробнее →

Запрос вместе с историей не помещается в окно контекста модели. Подробнее →

Частые причины: Длинная история диалога или большие файлы в запросе; Модель с меньшим контекстом, чем нужно. Подробнее →

1) В Claude Code выполните /compact — история сожмётся 2) Возьмите модель с большим контекстом (контекст указан в tkbk.online/models) 3) Передавайте только нужные куски файлов; для больших баз знаний — эмбеддинги и поиск. Подробнее →

Соединение с API оборвалось на стороне сети клиента или прокси. Подробнее →

Частые причины: Корпоративный прокси или VPN рвёт долгие соединения; Нестабильный интернет; Неверный ANTHROPIC_BASE_URL (опечатка в домене). Подробнее →

1) Проверьте доступность: curl https://api.tkbk.online/v1/models -H "x-api-key: cr_…" 2) Отключите VPN/прокси для api.tkbk.online или добавьте его в исключения 3) Claude Code сам повторяет запросы — если ошибка разовая, ничего делать не нужно. Подробнее →

Поток ответа оборвался до завершения — чаще всего сетевой сбой или долгий ответ reasoning-модели. Подробнее →

Частые причины: Нестабильное соединение; Очень долгое «размышление» модели без промежуточных данных; Неверный base_url в config.toml. Подробнее →

1) Проверьте config.toml: base_url = "https://api.tkbk.online/openai/v1" и ключ в переменной OPENAI_API_KEY 2) Повторите — Codex продолжит с того же места 3) Для быстрых задач выберите модель с меньшим reasoning (например, gpt-6-luna). Подробнее →

Cursor проверяет ключ запросом к указанному адресу и не получил успешного ответа. Подробнее →

Частые причины: Не включён Override OpenAI Base URL или адрес без /openai/v1; Ключ вставлен в поле Anthropic, а адрес указан для OpenAI. Подробнее →

1) Settings → Models → OpenAI API Key: вставьте cr_… и включите Override OpenAI Base URL = https://api.tkbk.online/openai/v1 2) Добавьте нужные модели вручную (gpt-6.1-sol, deepseek-v4-pro, glm-5.3) и нажмите Verify. Подробнее →

Нода отправила параметры, которые модель не принимает, или неверный base URL в credentials. Подробнее →

Частые причины: В credentials не указан Base URL; Выбрана модель, которой нет в каталоге; Параметры, неподдерживаемые моделью (например, temperature у reasoning-моделей). Подробнее →

1) Credentials → OpenAI: API Key = cr_…, Base URL = https://api.tkbk.online/openai/v1 2) Впишите id модели вручную из tkbk.online/models 3) Уберите temperature/top_p для reasoning-моделей GPT. Подробнее →

Кратковременный сбой на стороне шлюза или канала модели. Подробнее →

Частые причины: Канал модели перезапускается или недоступен; Плановые работы. Подробнее →

1) Повторите запрос через несколько секунд 2) Посмотрите tkbk.online/status 3) Если ошибка держится больше 5 минут — напишите в поддержку, указав request id из ответа. Подробнее →

Claude Code запросил модель, которую ключ не открывает или которой нет. Подробнее →

Частые причины: В /model выбрана несуществующая модель; Задана ANTHROPIC_MODEL с опечаткой. Подробнее →

1) Выполните /model и выберите claude-opus-5-5, claude-sonnet-5 или claude-fable-5-1 2) Проверьте переменные ANTHROPIC_MODEL и ANTHROPIC_SMALL_FAST_MODEL. Подробнее →

У каждого ответа шлюза есть идентификатор запроса — по нему поддержка находит запрос в журнале (тело запроса мы не храним). Подробнее →

Частые причины: Нужен разбор конкретной ошибки. Подробнее →

1) Скопируйте заголовок request-id (или поле id в ошибке) 2) Напишите в поддержку: время, модель, request id и текст ошибки. Подробнее →

Прокси или антивирус проверяет HTTPS и подставляет свой сертификат, а Claude Code такому сертификату не доверяет. Подробнее →

Частые причины: Корпоративный прокси или файрвол расшифровывает HTTPS и подписывает трафик своим корневым сертификатом; Антивирус с проверкой защищённых соединений (HTTPS-сканирование); Неверные дата и время на компьютере — тогда сертификат выглядит просроченным. Подробнее →

1) Откройте https://api.tkbk.online/health в браузере и посмотрите, кто выдал сертификат: если там имя прокси или антивируса, соединение перехватывается 2) Возьмите у администратора корневой сертификат прокси (файл .pem) и укажите его в NODE_EXTRA_CA_CERTS, затем перезапустите claude 3) Или установите этот сертификат в системное хранилище: Claude Code доверяет встроенным и системным сертификатам (при установке через npm — на Node.js 22.15 и новее). Подробнее →

Cursor не пустил запрос к модели через ваш ключ: модель не добавлена, ключ вставлен не в то поле или план Cursor не разрешает свои ключи. Подробнее →

Частые причины: Модель не добавлена в настройках или её ID написан с ошибкой — ID пишется строчными, точно как в каталоге; В чате выбран режим Auto: для запросов через свой ключ модель нужно выбрать явно; Ключ вставлен в поле Anthropic API Key при включённом Override OpenAI Base URL — команда Cursor на форуме подтверждает, что такая связка даёт эту ошибку. Подробнее →

1) Cursor Settings → Models → API Keys: ключ cr_… — в поле OpenAI API Key, включите Override OpenAI Base URL и укажите https://api.tkbk.online/openai/v1 2) Поле Anthropic API Key оставьте выключенным 3) Добавьте модель вручную (Add model): gpt-6.1-sol — и выберите её в чате вместо Auto. Подробнее →

Шлюз не нашёл адрес или модель из настроек Cline: в Base URL лишний или пропущенный путь, или Model ID с ошибкой. Подробнее →

Частые причины: Провайдер OpenAI Compatible: в Base URL нет /v1 — Cline добавляет к адресу только /chat/completions; В Base URL вставлен полный путь …/v1/chat/completions — тогда путь удваивается; Model ID с опечаткой или модели нет в каталоге. Подробнее →

1) API Provider — OpenAI Compatible, Base URL — https://api.tkbk.online/v1 (ровно так, без /chat/completions) 2) OpenAI Compatible API Key — ключ cr_…, Model ID — точный ID из tkbk.online/models, например claude-sonnet-5 или deepseek-v4-pro 3) Проверьте адрес и ключ запросом списка моделей (команда ниже): если ваша модель в ответе есть, ошибка в настройках Cline. Подробнее →

Узел ИИ не дождался ответа модели за отведённое время или соединение оборвалось — библиотека называет оба случая таймаутом. Подробнее →

Частые причины: Долгий ответ: большой контекст, длинный ответ или модель с долгими размышлениями, а Timeout в опциях узла маленький; Соединение обрывается раньше — тогда ошибка приходит через несколько секунд, а не после ожидания; Self-hosted n8n не может достучаться до api.tkbk.online: DNS, прокси или файрвол сервера. Подробнее →

1) В узле OpenAI Chat Model → Options добавьте Timeout (в миллисекундах), например 300000 — это 5 минут, и Max Retries — 2–3 2) Ограничьте Maximum Number of Tokens и сократите контекст; для массовых задач возьмите быструю модель — claude-haiku-4-5 или deepseek-v4.1-flash 3) Проверьте credential: OpenAI — Base URL https://api.tkbk.online/v1, Anthropic — https://api.tkbk.online; в узле OpenAI Chat Model выключите Use Responses API. Подробнее →

SDK отправил ключ TKBK на сервер OpenAI: base URL не задан, а OpenAI ключ cr_… не узнаёт. Подробнее →

Частые причины: В клиенте не указан base_url (Python) или baseURL (Node.js), и переменная OPENAI_BASE_URL не задана; Задана только старая переменная OPENAI_API_BASE: её читали старые версии openai для Python (0.x) и читает LangChain, а современные SDK — нет; Переменная задана в одном терминале, а программа запущена из другого места (IDE, cron, Docker) без неё. Подробнее →

1) Python: OpenAI(base_url="https://api.tkbk.online/v1", api_key="cr_…") — или export OPENAI_BASE_URL=https://api.tkbk.online/v1 2) Node.js: new OpenAI({ baseURL: "https://api.tkbk.online/v1", apiKey: "cr_…" }) 3) Проверьте, куда идёт запрос: print(client.base_url) должен показать https://api.tkbk.online/v1/. Подробнее →

Тело запроса больше допустимого размера в байтах — ещё до подсчёта токенов. У Claude Messages API предел — 32 МБ. Подробнее →

Частые причины: Картинки, PDF и скриншоты в base64 — они быстро набирают десятки мегабайт; Длинная история агента с результатами инструментов: логи, вывод команд; Целые файлы вставлены в запрос вместо нужных фрагментов. Подробнее →

1) Claude Code: выполните /compact — он убирает накопленные картинки и вложения; не помогло — дважды Esc, чтобы вернуться до тяжёлого сообщения, или /clear 2) Указывайте файлы путём, а не вставкой содержимого: агент прочитает их по частям 3) Уменьшайте картинки: API принимает до 8000 пикселей по длинной стороне, а если в контексте больше 20 картинок — до 3000. Подробнее →