Appearance
Частые ошибки и их решения
Сверьте текст ошибки с разделами ниже. Если ошибка повторяется, укажите поддержке клиент, модель и время запроса. Не отправляйте полный API-ключ.
401 / invalid token / токен недействителен
Причина: проблема с API Key (токеном). Чаще всего это:
- Key скопирован с ошибкой (лишний пробел, не хватает символов)
- Key уже удалён или отключён в панели управления
- В клиенте он вписан не туда, либо забыли
Bearer
Что делать:
- Вернитесь в Панель управления → Токены и убедитесь, что токен на месте и в нормальном статусе.
- Скопируйте его заново и замените целиком, следя за тем, чтобы по краям не было пробелов.
- Проверьте, что
base_urlтоже указан верно (см. инструкции по каждому клиенту).
Недостаточно средств / insufficient quota / INSUFFICIENT_BALANCE
Причина: закончился баланс счёта либо лимит этого токена.
Что делать: проверьте баланс и лимит токена в консоли. Если средства есть, обратитесь в поддержку.
Нет доступных каналов / в текущей группе нет доступных каналов / no available channel
Причина: для запрошенной модели в группе токена нет подходящего канала либо поставщик временно недоступен.
Что делать:
- Откройте Панель управления и посмотрите список доступных сейчас моделей, выберите одну из имеющихся.
- Убедитесь, что имя модели написано полностью точно (важны регистр букв и дефисы).
- Если имя и группа совпадают, а ошибка повторяется, обратитесь в поддержку для проверки доступности канала.
Модель не существует / model_not_found
Причина: имя модели написано с ошибкой, либо эта модель недоступна в вашей группе.
Что делать: так же, как в предыдущем пункте — откройте панель управления, сверьтесь со списком моделей и впишите имя в клиент символ в символ.
Обрыв потока / stream disconnected / Connection error / высокая нагрузка
Причина:
- Вышестоящий сервис перегружен в часы пик, либо кратковременные перебои в сети
- Временный сетевой сбой между шлюзом и поставщиком
Что делать:
- Просто повторите запрос один раз — чаще всего это срабатывает.
- Если повторяется часто → попробуйте другую модель (разные модели идут через разные вышестоящие сервисы).
- Если не проходит постоянно → сделайте скриншот и обратитесь в поддержку, мы проверим состояние каналов в админ-панели.
Превышено время ожидания / timeout
Причина: запрос или ответ поставщика выполняется дольше допустимого времени либо соединение прервалось.
Что делать: повторите запрос; при повторении укажите поддержке время, модель и клиент.
reasoning / интенсивность размышлений не работает
Причина: у двух интерфейсов разный синтаксис, и при их смешивании параметр игнорируется.
| Интерфейс | Правильный синтаксис |
|---|---|
/v1/chat/completions | строка: "reasoning_effort": "high" |
/v1/responses (Codex и др.) | объект: "reasoning": { "effort": "high" } |
Что делать: выберите синтаксис под используемый вами интерфейс. В Codex просто используйте параметр конфигурации model_reasoning_effort, писать вручную не нужно.
Страница панели управления выдаёт 500 / белый экран / ошибка при любом клике
Причина: если в браузере включён Google-перевод (автоматический перевод всей страницы), он конфликтует с панелью управления и вызывает ошибки при кликах.
Что делать:
- Отключите Google-перевод для этой страницы (значок перевода в адресной строке → показать оригинал) и обновите страницу.
- Мы уже добавили защиту на стороне сервера, но всё же рекомендуем не включать перевод всей страницы для таких панелей управления.
Известно и уже укреплено
Мы уже сделали обработку совместимости для этой проблемы. Если после обновления она всё ещё возникает, отключите перевод и обновите страницу один раз — обычно этого достаточно.
Всё равно не получается?
Отправьте в поддержку скриншот с оригинальным текстом ошибки + название используемого вами клиента и модели — так будет намного быстрее, чем объяснять словами.