Устранение неполадок с подключением

Выполняйте эти проверки по порядку. За один раз меняйте только один параметр.

1. Проверьте ключ API

  • Удалите пробелы в начале и конце.
  • Убедитесь, что ключ включён, не просрочен и его квота не исчерпана.
  • Убедитесь, что процесс может прочитать настроенную переменную окружения.
  • Не вставляйте полный ключ в журналы или сообщения в поддержку.

2. Проверьте протокол и URL

ПротоколBase URLОперация, добавляемая клиентом
Chat Completionshttps://getrouter.ai/v1/chat/completions
Responseshttps://getrouter.ai/v1/responses
Claude Messageshttps://getrouter.ai/v1/messages
Geminihttps://getrouter.ai/v1beta/models/...

Ошибка 404 часто означает, что клиент дважды добавил /v1 или путь операции.

3. Проверьте модель

  • Скопируйте точный идентификатор модели со страницы Модели.
  • Убедитесь, что ключу разрешено использовать эту модель.
  • Убедитесь, что модель поддерживает запрашиваемые протокол и возможность.
  • Если инструмент не может загрузить список моделей, укажите модель вручную.

4. Разберите распространённые статусы

СтатусЧто проверить в первую очередь
400Неподдерживаемое поле, некорректный запрос или несовместимость возможностей
401ключ API отсутствует или недействителен
403Ограничение ключа, модели, группы или политики
404Неверный URL или путь либо неизвестная модель
429Баланс, квота, число одновременных запросов или ограничение частоты
5xxВременная ошибка вышестоящего провайдера или шлюза

5. Проверьте минимальный запрос

Отключите инструменты, файлы, изображения, длинный контекст, режим JSON и пользовательские настройки рассуждений. Отправьте одну короткую текстовую инструкцию. Затем включайте дополнительные возможности по одной.

Как безопасно обратиться за помощью

Сообщите инструмент и его версию, протокол, идентификатор модели, конфигурацию Base URL без секретов, статус HTTP, текст ошибки, Request ID, а также время с часовым поясом. Никогда не передавайте полный ключ API.