API для агентов ИИ позволяет программисту или приложению отправлять запросы на создание моделей, выбирать модель и получать ответы. Для OdiRouter настройка сводится к API-ключу, базовому URL OdiRouter, точному идентификатору модели и интерфейсу запросов, необходимому вашему клиенту. Официальная документация OdiRouter quick start описывает первый запрос и шаги, позволяющие не допустить попадания учётных данных в клиентский код.
Проверьте конфигурацию, прежде чем подключать агента к производственному рабочему процессу. Привычное имя модели может устареть, а локальный файл конфигурации не доказывает, что клиент отправляет запросы тому провайдеру, которого вы выбрали.
Что требуется для настройки API ИИ-агентов
Укажите следующие значения до того, как ваш агент выполнит первый запрос:
API-ключ OdiRouter, сохранённый в переменной окружения.
Базовый URL
https://api.odirouter.ai/v1.Точный идентификатор модели из
GET https://api.odirouter.ai/v1/models.Интерфейс запросов, поддерживаемый клиентом, например
/chat/completions,/messagesили/responses.Небольшой тест, подтверждающий, что клиент использует OdiRouter, а не провайдера по умолчанию.
В кратком руководстве OdiRouter рекомендуется использовать переменные окружения для API-ключей, а для самого API — вызовы из бэкенда или серверных маршрутов. Не храните ключи в коде браузера, общих репозиториях и файлах конфигурации проекта, которые могут читать другие участники.
Подготовьте ключ API и идентификатор модели OdiRouter.
Войдите в OdiRouter, создайте API-ключ и загрузите его в окружение, используемое вашим агентом или бэкендом. В описании quick-start guide также рекомендуется использовать отдельные ключи для разных задач и менять ключи местами, если есть подозрение на несанкционированное использование.
Перед добавлением модели в файл конфигурации выполните запрос GET https://api.odirouter.ai/v1/models и скопируйте полученный идентификатор. Это позволяет избежать использования отображаемого имени, устаревшего идентификатора или модели, к которой активный ключ не имеет доступа.
Настройте Codex CLI с помощью OdiRouter
OdiRouter Codex CLI guide документирует пользовательский провайдер, использующий Responses API. Поместите настройки провайдера в файл пользовательского уровня ~/.codex/config.toml. Не полагайтесь на конфигурацию провайдера на уровне проекта для хранения учётных данных.
model = "YOUR_MODEL_ID"
model_provider = "odirouter"
model_reasoning_effort = "high"
[model_providers.odirouter]
name = "OdiRouter"
base_url = "https://api.odirouter.ai/v1"
env_key = "ODIROUTER_API_KEY"
wire_api = "responses"Задайте ключ в сеансе оболочки, из которого запускается агент:
export ODIROUTER_API_KEY="YOUR_API_KEY"Начните с небольшой задачи в репозитории или короткого запроса. Если клиент сообщает, что использует другого провайдера, убедитесь, что model_provider = "odirouter" присутствует в пользовательской конфигурации, затем перезапустите клиент. Если модель не удаётся найти, снова получите список моделей и используйте возвращённый идентификатор в точности.
Используйте OpenAI SDK, когда агент работает внутри приложения
Агенту не обязательно запускаться через локальный CLI. OdiRouter OpenAI SDK guide показывает, как существующий клиент OpenAI SDK может вызывать OdiRouter с ключом API OdiRouter и базовым URL.
Сохраните поток работы клиента, который уже использует ваше приложение. Установите base_url или baseURL в значение https://api.odirouter.ai/v1, загрузите ODIROUTER_API_KEY из серверного окружения и передайте точный идентификатор модели OdiRouter. Это подходит для сервисов, фоновых задач и кода рабочих процессов, где приложение обрабатывает повторные попытки и ведение журналов.
Руководство по SDK также предупреждает не раскрывать ключ в браузерной сборке. Перенесите вызов модели в серверный маршрут или внутренний процесс, если клиентский пакет может прочитать ключ.
Проверьте первый запрос перед использованием в продакшене
Для первого запроса используйте узкую подсказку. Подтвердите, что:
Клиент отправляет запросы на адрес
https://api.odirouter.ai/v1.Процесс считывает
ODIROUTER_API_KEYбез вывода его на экран.Идентификатор выбранной модели отображается в конечной точке моделей OdiRouter.
Запрос использует интерфейс, ожидаемый клиентом, включая Responses API для конфигурации провайдера Codex CLI.
Затем изучите журналы запросов OdiRouter и информацию об использовании на панели управления. Это подтверждает, что запрос достиг ожидаемого маршрута для учетной записи и модели до того, как более масштабный рабочий процесс агента начнет повторять звонки.
Устранение распространённых ошибок конфигурации
401 или недействительный ключ. Убедитесь, что ODIROUTER_API_KEY задан в окружении процесса и содержит активный ключ API OdiRouter. Не указывайте ключ в заявке, репозитории или истории команд.
403 или ошибка доступа. Проверьте статус ключа, баланс аккаунта и доступ к выбранной модели. В руководстве Codex CLI это указано среди проверок при ответе о запрете доступа.
Модель не найдена. Используйте точный идентификатор из GET https://api.odirouter.ai/v1/models. Привычное название не является идентификатором API.
Клиент использует другого провайдера. В Codex CLI проверьте блок провайдера пользовательского уровня и model_provider = "odirouter". При интеграции SDK убедитесь, что клиент, созданный на сервере, имеет базовый URL OdiRouter.
Ошибка Responses API. Для Codex CLI убедитесь, что базовый URL заканчивается на /v1 и что wire_api = "responses" остаётся в блоке провайдера.
Продолжите работу с официальными руководствами по интеграции
В документации OdiRouter также перечислены интеграции для Claude Code, Claude Desktop, OpenCode, Hermes Agent, OpenClaw, инструментов рабочих процессов и SDK. Используйте руководство для клиента, с которым вы работаете, затем следуйте той же схеме: храните ключ API в окружении, выберите точный идентификатор модели, выполните небольшой тестовый вызов и проверьте запрос.
Подробные инструкции см. в OdiRouter quick start, Codex CLI integration guide и OpenAI SDK guide.