Диагностика интеграций
Большинство проблем интеграции вызваны неверным Base URL, отсутствующим API key, недоступным ID модели или тем, что инструмент не загрузил новую конфигурацию.
Частые ошибки
Заголовок раздела «Частые ошибки»| Симптом | Вероятная причина | Исправление |
|---|---|---|
| 401 или invalid API key | Ключ отсутствует или неверен | Создайте новый API key и отправляйте его как Authorization: Bearer YOUR_API_KEY |
| 404 model not found | Неверный ID модели | Запросите GET https://www.odirouter.ai/v1/models и скопируйте точный ID модели |
| Инструмент добавляет путь дважды | Полный endpoint вставлен в поле Base URL | Для Base URL используйте только https://www.odirouter.ai/v1 |
Инструмент вызывает /chat/completions/chat/completions | Полный endpoint вставлен в поле Base URL | Для Base URL используйте только https://www.odirouter.ai/v1 |
| Streaming зависает | Клиент не парсит SSE или модель не поддерживает streaming | Отключите streaming или выберите модель со streaming |
| Claude Code не подключается | Переменные окружения не загружены | Установите ANTHROPIC_BASE_URL в https://www.odirouter.ai и перезапустите claude |
Проверка вне инструмента
Заголовок раздела «Проверка вне инструмента»Запустите команду перед отладкой IDE или платформы рабочих процессов:
curl -sS "https://www.odirouter.ai/v1/chat/completions" \ -H "Authorization: Bearer ${ODIROUTER_API_KEY}" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-5.5", "messages": [ { "role": "user", "content": "Reply with: OdiRouter integration works" } ] }'Если прямой вызов работает, а инструмент нет, проблема в конфигурации провайдера инструмента. Если прямой вызов не работает, сначала исправьте API key, ID модели или баланс аккаунта.
Правила Base URL
Заголовок раздела «Правила Base URL»- Поля Base URL для OpenAI-совместимых интеграций используют
https://www.odirouter.ai/v1. - Поля Base URL для Anthropic-совместимых интеграций используют
https://www.odirouter.ai; полный Messages endpoint:https://www.odirouter.ai/v1/messages. - Поля полного endpoint должны использовать
https://www.odirouter.ai/v1/chat/completions. - Рабочие процессы multimodal queue используют
https://www.odirouter.ai/model/v1/queue/{endpoint}.