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

OpenCode поддерживает подключение сторонних OpenAI-совместимых API через конфигурационный файл opencode.jsonc. Вы можете использовать модели из Hubris прямо в терминале OpenCode — с оплатой российской картой или через СБП, без зарубежных карт. Достаточно один раз настроить провайдера, указать API-ключ и перечислить нужные модели — OpenCode будет работать с ними так же, как со встроенными.

О том, как установить сам OpenCode, подключить его к VS Code или JetBrains-средам, мы рассказали в отдельной статье — OpenCode: настройка, API-ключ и подключение к VS Code, JetBrains и PyCharm. Здесь же сосредоточимся именно на API-конфигурации: как прописать провайдера, задать модели и выбрать подходящие для кода.

Настройка OpenAI-совместимого провайдера

Провайдер описывается в файле opencode.jsonc в блоке provider. Ключевые параметры:

• npm — пакет AI SDK. Для OpenAI-совместимых API, работающих по протоколу /v1/chat/completions, используется @ai-sdk/openai-compatible.
• options.baseURL — адрес API-эндпоинта. Для Hubris: https://api.hubris.pw/v1.
• options.apiKey — API-ключ. Можно указать напрямую или, что безопаснее, через переменную окружения в синтаксисе {env:ИМЯ_ПЕРЕМЕННОЙ}.

Минимальная конфигурация провайдера Hubris:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "hubris": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Hubris",
      "options": {
        "baseURL": "https://api.hubris.pw/v1",
        "apiKey": "{env:HUBRIS_API_KEY}"
      }
    }
  }
}

Переменную HUBRIS_API_KEY вы создаёте в своём окружении, а её значение — API-ключ, который выдаётся при регистрации на Hubris. Ключ имеет формат sk-gw- и открывает доступ ко всем моделям каталога (сейчас их 570, включая 20 бесплатных).

Конфигурация моделей

Модели перечисляются внутри провайдера в блоке models. Ключ модели — это её идентификатор в каталоге Hubris, например anthropic/claude-sonnet-5.5: именно он уходит в API, поэтому писать его нужно точно так, как в каталоге. Для каждой модели обязательно указать name (отображаемое имя), а для моделей не из встроенного каталога — явно задать лимиты в блоке limit:

• limit.context — размер контекстного окна в токенах;
• limit.output — максимальная длина ответа в токенах.

По умолчанию для неизвестных моделей OpenCode применяет резервные лимиты: 200 000 токенов контекста и 32 000 токенов ответа. Это работает, но чтобы использовать полные возможности модели, лучше указать реальные значения.

Пример конфигурации с несколькими моделями:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "hubris": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Hubris",
      "options": {
        "baseURL": "https://api.hubris.pw/v1",
        "apiKey": "{env:HUBRIS_API_KEY}"
      },
      "models": {
        "anthropic/claude-sonnet-5.5": {
          "name": "Claude Sonnet 5.5",
          "limit": { "context": 1000000, "output": 128000 }
        },
        "openai/gpt-6.1-sol-pro": {
          "name": "GPT-6.1 Sol Pro",
          "limit": { "context": 1050000, "output": 128000 }
        },
        "deepseek/deepseek-v4-flash-0731": {
          "name": "DeepSeek V4 Flash 0731",
          "limit": { "context": 1048576, "output": 943718 }
        }
      }
    }
  }
}

После настройки вы ссылаетесь на модели в формате provider_id/model_id — например, hubris/anthropic/claude-sonnet-5.5. Именно так модель указывается в ключе model верхнего уровня конфига или в CLI-флаге --model.

Для сторонних моделей OpenCode по умолчанию включает поддержку вызова инструментов, текстовый и графический ввод и текстовый вывод. Этого достаточно для работы с кодом, включая отправку скриншотов и диаграмм. Аудио и видео OpenCode не поддерживает — это ограничение самого инструмента, а не API.

Важный нюанс: OpenCode не запрашивает у OpenAI-совместимого сервера реальные лимиты контекста или список возможностей автоматически. Если фактические параметры модели отличаются от значений по умолчанию, их нужно указать в limit вручную — ориентируйтесь на данные из каталога Hubris, приведённые ниже.

Какие модели выбрать для кода

Выбор модели зависит от задачи. Для сложного рефакторинга и многофайловых правок нужны флагманские модели с большим контекстом. Для повседневной генерации кода и автодополнения — быстрые и недорогие. Все цены ниже — в рублях за миллион токенов (вход / выход), с максимальными лимитами контекста и ответа.

Флагманские модели для серьёзной разработки

Claude Sonnet 5.5 и GPT-6.1 Sol Pro — основной выбор для профессиональной разработки. Claude Sonnet 5.5 особенно силён в многофайловых правках и понимании крупных кодовых баз, а GPT-6.1 Sol Pro показывает отличные результаты в генерации нового кода и архитектурных задачах.

Быстрые и недорогие модели

Для повседневной работы — генерации boilerplate, простых правок, автодополнения — отлично подходят недорогие модели. GPT-6 Luna и Claude Haiku 5.5 при цене 13 ₽ за миллион входных токенов справляются с большинством рутинных операций. DeepSeek V4 Flash 0731 с контекстом более миллиона токенов и входом за 2 ₽ — один из самых экономичных вариантов для работы с крупными файлами.

Специализированные кодовые модели

ByteDance Seed-2.0-Code (63 ₽ / 379 ₽, контекст 262 144, лимит ответа 131 072) — модель, специально обученная для задач программирования. Стоит рассмотреть как альтернативу флагманским моделям для чисто кодовых задач.

Подробнее о конкретных линейках моделей — в обзорах Claude API из России и DeepSeek API из России. Если вы пользуетесь Claude Code как альтернативой OpenCode, обратитесь к статье Claude Code в России: настройка и API.

Оплата в рублях и пополнение баланса

Hubris принимает оплату российской банковской картой, через СБП и по счёту для юридических лиц. После пополнения баланса вы платите только за фактические запросы — стоимость списывается автоматически с баланса за каждый вызов API. Никакой подписки или предоплаты за конкретную модель не требуется: один ключ даёт доступ ко всем 570 моделям.

Для организаций доступна оплата по счёту с закрывающими документами — подробнее в статье Оплата нейросетей юридическим лицом.

Частые вопросы

Нужно ли платить за API-ключ?

Нет. API-ключ формата sk-gw- выдаётся при регистрации. Вы платите только за использование моделей — стоимость каждого запроса списывается с баланса.

Можно ли использовать один ключ для разных моделей?

Да. Один API-ключ Hubris даёт доступ ко всем 570 моделям каталога. В конфигурации OpenCode вы просто перечисляете нужные модели в блоке models провайдера — все они работают через один и тот же эндпоинт с одним ключом.

OpenCode не видит модель — что делать?

Проверьте, что идентификатор модели в конфигурации (ключ внутри models) и ссылка на неё в формате provider_id/model_id записаны верно. Например, для модели anthropic/claude-sonnet-5.5 у провайдера hubris полная ссылка будет hubris/anthropic/claude-sonnet-5.5. Частая ошибка — сокращённое имя вроде claude-sonnet-5-5: такого идентификатора в каталоге нет, и запрос не пройдёт. Модель также должна быть явно перечислена в конфигурации — OpenCode не получает список моделей с сервера автоматически.

Какие лимиты указывать для моделей?

Точные значения контекстного окна и лимита ответа для каждой модели приведены в таблицах выше. Если не указать limit, OpenCode применит значения по умолчанию — 200 000 токенов контекста и 32 000 токенов ответа. Для современных моделей с контекстом более миллиона токенов это может быть недостаточно — лучше указать реальные цифры.

Работает ли OpenCode с изображениями через Hubris?

Да. OpenCode по умолчанию включает модальность image для ввода. Вы можете отправлять скриншоты, диаграммы и фрагменты кода в виде изображений, и модель их прочитает. Инструмент чтения файлов передаёт в модель изображения форматов PNG, JPEG, GIF, WebP и документы PDF до 20 МБ.

Чем OpenCode отличается от Claude Code?

Claude Code — проприетарный инструмент Anthropic, рассчитанный прежде всего на модели Claude. OpenCode — открытый инструмент (open-source) с поддержкой более 75 провайдеров, включая любые OpenAI-совместимые API и локальные серверы вроде Ollama. Через Hubris оба инструмента можно оплачивать в рублях.