OpenCode + IRI Gateway

Зачем IRI Gateway

Один API-ключ вместо десятка аккаунтов у провайдеров. Биллинг в рублях, уровни IRI и конкретные модели, бесплатный режим IRI Zero. Base URL: https://api.agi-iri.ru/v1/

Шаги подключения

1. Установите OpenCode
2. Добавьте custom provider IRI Gateway
3. Base: https://api.agi-iri.ru/v1/
4. Выберите model из каталога IRI

Подсказка: config.json → providers.iri_gateway

Рекомендуемые модели

Полный каталог — /gateway/models/

Подробная настройка

Что получится

OpenCode — помощник для работы с кодом, который запускается в терминале. Через IRI Gateway он берёт модели по одному ключу, а оплата идёт в рублях с баланса Gateway. Настройка занимает три шага и около пяти минут.

Шаг 1. Выпустите ключ

Откройте кабинет Gateway, раздел «API-ключи» и нажмите «Создать API-ключ». Ключ выглядит как vsk_live_… и показывается один раз, поэтому сразу скопируйте его. Подробно по шагам — в статье как получить ключ. Для платных моделей нужен баланс: как пополнить.

Шаг 2. Создайте файл настроек

Создайте файл opencode.json в папке проекта. Если хотите, чтобы настройка работала во всех проектах, положите его в ~/.config/opencode/opencode.json. Скопируйте в файл этот блок целиком:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "iri": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "IRI Gateway",
      "options": {
        "baseURL": "https://api-ru.agi-iri.ru/v1",
        "apiKey": "{env:IRI_API_KEY}"
      },
      "models": {
        "iri-live": { "name": "IRI Live" },
        "exact/opus-5.5": { "name": "Opus 5.5" }
      }
    }
  },
  "model": "iri/iri-live"
}

Сам ключ в файл не пишется. OpenCode возьмёт его из переменной IRI_API_KEY, которую нужно создать одной командой.

Windows (командная строка или PowerShell), после команды закройте и снова откройте терминал:

setx IRI_API_KEY "ваш_ключ"

macOS и Linux:

export IRI_API_KEY="ваш_ключ"

На macOS и Linux эта команда действует до закрытия терминала. Чтобы не вводить её каждый раз, добавьте ту же строку в файл ~/.zshrc или ~/.bashrc.

Шаг 3. Запустите OpenCode

В папке проекта выполните opencode. Сразу будет выбрана модель IRI Live. Чтобы сменить модель, введите /models и выберите нужную из списка.

Другие модели добавляются строкой в блок models. ID нужно брать точно из списка моделей в кабинете: уровни вида iri-live или ninja-…, конкретные модели вида exact/opus-5.5.

Если не работает

• Нет соединения или долгое ожидание: замените в файле адрес на https://api.agi-iri.ru/v1.
• Модель «недоступна» или не найдена: скопируйте её ID из списка моделей в кабинете, он должен совпадать до символа.
• Ошибка 402: на балансе нет денег, пополните его.
• Ошибка 401: ключ не дошёл или введён с ошибкой. Проверьте, что терминал перезапущен после setx.

Читайте также: Как подключить API к любому инструменту