AIRouter

OpenCode · custom provider

Как подключить OpenCode к LLM API в рублях через AIRouter

OpenCode поддерживает provider-конфигурации. Для AIRouter используйте OpenAI-compatible provider, baseURL и осторожно передавайте API key через поддержанный secret/env mechanism вашей версии.

Прямая настройка Документация OpenCode: providers

Короткий ответ

Да, OpenCode можно подключить к AIRouter через custom OpenAI-compatible provider.

В конфиге задайте baseURL https://api.ai-router.app/v1, пример ключа и модель AIRouter.

Это подходит для базовых agent/coding сценариев после проверки выбранной модели.

Не переносите production workflow, пока не проверите нужные capabilities.

Что понадобится

Начните с регистрации AIRouter, проверьте модели и цены, пополните баланс от 100 ₽, а базовый OpenAI‑compatible quickstart держите под рукой в документации.

  • Установленный OpenCode.
  • AIRouter аккаунт, API‑ключ и выбранная модель.
  • Поддержанный механизм secret/env для API key или локальный приватный конфиг, который не попадёт в git.
  • Понимание, какие OpenCode tools нужны вашему workflow.

Quick test

Быстрая проверка перед рабочим сценарием

Начните с пополнения от 100 ₽ и короткого тестового запроса.

  1. Создайте аккаунт AIRouter.Создайте аккаунт и откройте кабинет.
  2. Выберите модель.Возьмите id из публичного каталога и начните с короткого текстового prompt.
  3. Пополните баланс от 100 ₽.Пополните баланс в кабинете и проверяйте итоговый статус в истории платежей.
  4. Отправьте короткий запрос.Например: «Проверь подключение и ответь коротко», затем проверяйте более сложные agent flows.

Пошаговая настройка

  1. Создайте opencode.jsonДобавьте custom provider airouter. Если ваша версия OpenCode поддерживает env/secret interpolation, используйте её; в публичных примерах оставляйте пример.
  2. Выберите модельЗамените <AIROUTER_MODEL> на модель, доступную в AIRouter.
  3. Проверьте простой promptНачните с короткого текстового запроса до включения сложных agent workflows.

Пример конфига

В публичных примерах используйте <AIROUTER_API_KEY>, <AIROUTER_MODEL> или переменную AIROUTER_API_KEY.

opencode.json

{"$schema":"https://opencode.ai/config.json","provider":{"airouter":{"npm":"@ai-sdk/openai-compatible","name":"AIRouter","options":{"baseURL":"https://api.ai-router.app/v1","apiKey":"<AIROUTER_API_KEY>"},"models":{"<AIROUTER_MODEL>":{}}}},"model":"airouter/<AIROUTER_MODEL>"}

environment

export AIROUTER_API_KEY=<AIROUTER_API_KEY>

Проверка

  • Запустите OpenCode с простым prompt в тестовой папке.
  • Убедитесь, что model указывается как airouter/<AIROUTER_MODEL>.
  • Если OpenCode ругается на capabilities, проверьте поддержку выбранной модели.

Частые ошибки

  • Смешать baseURL и полный path /chat/completions.
  • Указать ключ прямо в JSON.
  • Ожидать, что все OpenCode tools заработают с любой моделью.
  • Не заменить <AIROUTER_MODEL> на реальный id модели из каталога.

FAQ

Какой provider нужен OpenCode?

Custom provider на базе @ai-sdk/openai-compatible.

Как передать ключ?

Через механизм env/secret вашей версии OpenCode; если такого механизма нет, держите реальный ключ только в приватном локальном конфиге.

Почему model выглядит как airouter/<AIROUTER_MODEL>?

Это имя custom provider плюс model id внутри provider-конфига OpenCode.

Ограничения

Схема OpenCode может меняться; этот пример держится на OpenAI-compatible provider из документации.

Для сложных agent workflows сначала проверьте выбранную модель и нужные возможности на короткой задаче.

Если у модели нет нужных capabilities, OpenCode может ограничить часть сценариев.

Официальные источники

Документация OpenCode: providers

  • Официальная документация OpenCode providers подтверждает custom provider-конфигурацию и model routing.

← Все инструкции · Модели и цены · Начать