BroadRouter
Начать

BroadNet Inference в opencode: свой провайдер

Обновлено

В opencode.jsonc добавьте в providers запись broadnet с package @opencode/ai/providers/openai-compatible, settings.baseURL равным https://inference.broadnet.ai/v1 и env равным BROADNET_API_KEY. Сопоставьте короткие ключи моделей с ID BroadNet через modelID, например broadnet/glm-5.3, и выберите модель командой /models. Старые конфиги V1 с npm @ai-sdk/openai-compatible и options.baseURL тоже работают.

opencode — агент для программирования в терминале с открытым исходным кодом. Провайдеры, которых нет в его встроенном каталоге, добавляются как custom providers (свои провайдеры) в opencode.jsonc. BroadNet Inference работает в формате OpenAI chat completions, поэтому использует OpenAI-совместимый пакет среды выполнения opencode. Руководство следует актуальной документации opencode (V2).

Настройка

  1. Экспортируйте ключ в той оболочке, из которой запускаете opencode:
export BROADNET_API_KEY='your-broadnet-key'
  1. Создайте конфиг. Положите его в проект как opencode.jsonc или в ~/.config/opencode/opencode.jsonc, чтобы он действовал везде. Комментарий в конфиге напоминает, что документация BroadNet не заявляет вызов инструментов для DeepSeek V4.1 Flash, поэтому это нужно сначала проверить.
{
  "$schema": "https://opencode.ai/config.json",
  "model": "broadnet/glm-5.3",
  "providers": {
    "broadnet": {
      "name": "BroadNet Inference",
      "env": ["BROADNET_API_KEY"],
      "package": "@opencode/ai/providers/openai-compatible",
      "settings": {
        "baseURL": "https://inference.broadnet.ai/v1"
      },
      "models": {
        "glm-5.3": {
          "modelID": "broadnet/glm-5.3",
          "name": "GLM 5.3",
          "capabilities": { "tools": true, "input": ["text"], "output": ["text"] },
          "limit": { "context": 1048576, "output": 16000 }
        },
        "deepseek-v4.1-flash": {
          "modelID": "broadnet/deepseek-v4.1-flash",
          "name": "DeepSeek V4.1 Flash",
          // BroadNet's docs don't list tool calling for this model: test it first
          "capabilities": { "tools": true, "input": ["text", "image"], "output": ["text"] },
          "limit": { "context": 1048576, "output": 16000 }
        },
        "qwen3.8-27b": {
          "modelID": "broadnet/qwen3.8-27b",
          "name": "Qwen3.8 27B",
          "capabilities": { "tools": true, "input": ["text", "image"], "output": ["text"] },
          "limit": { "context": 262144, "output": 16000 }
        }
      }
    }
  }
}
  1. Запустите opencode и выберите модель командой /models. Ссылка на модель имеет вид broadnet/<ключ в карте>, например broadnet/glm-5.3. В BroadNet opencode отправляет значение modelID.

Файлы конфигурации объединяются. opencode применяет сначала глобальный файл, затем файлы проекта, найденные от текущего каталога вверх (сначала самые дальние), затем конфиг из .opencode/, так что файл проекта может переопределить глобальный провайдер. Управляемый системный конфиг, если его использует ваша компания, переопределяет и то и другое. Храните ключ в окружении, а не в файле, тогда конфиг можно класть в систему контроля версий.

Зачем алиасы

ID BroadNet уже содержат слеш (broadnet/glm-5.3). Ключ в карте models — это то, что opencode показывает и выбирает, а modelID — то, что он отправляет. Короткие ключи делают ссылки читаемыми.

Задайте capabilities и limit сами. Для модели вне своего каталога opencode предполагает поддержку инструментов в JSON, ввод текста и изображений, контекст 200 000 токенов и 32 000 токенов на выходе. Его документация называет это резервными предположениями, а не определёнными значениями. Значение output 16000 выше — наше предложение, а не лимит BroadNet; оно оставляет место для рассуждений.

Старые конфиги V1

opencode V2 по-прежнему читает формат V1, так что существующий блок вроде этого продолжит работать:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "broadnet": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "BroadNet Inference",
      "options": {
        "baseURL": "https://inference.broadnet.ai/v1",
        "apiKey": "{env:BROADNET_API_KEY}"
      },
      "models": {
        "broadnet/glm-5.3": { "name": "GLM 5.3" }
      }
    }
  }
}

В нативном формате V2 provider превращается в providers, npm — в package (aisdk:@ai-sdk/openai-compatible, если хотите оставить пакет AI SDK), а options.baseURL и options.apiKey переезжают в settings. Руководство opencode по миграции с V1 сопоставляет каждое поле.

Какую модель выбрать

Задача Модель Примечания
Агентное программирование с инструментами GLM 5.3 Заявлены инструменты и структурированный вывод; контекст 1 млн
Скриншоты, арабский Qwen3.8 27B Инструменты и изображения; контекст 262K
Сессии на весь день по фиксированной цене DeepSeek V4.1 Flash Безлимитные тарифы; инструменты у BroadNet не заявлены

opencode опирается на вызовы инструментов. Документация BroadNet не заявляет вызов инструментов для DeepSeek V4.1 Flash, поэтому в конфиге это помечено как предположение, которое нужно проверить. Прогоните реальную задачу на часе Meteor ($1), прежде чем покупать месяц Full Moon ($60).

Решение проблем

  • 401. Ключ в BROADNET_API_KEY неверен, истёк или исчерпан лимит оплаты по факту. Убедитесь, что переменная задана в процессе, который запускает opencode.
  • Модель не найдена или отклонена. Выбирайте ключ в карте (broadnet/glm-5.3) и проверьте, что modelID точно совпадает с ID BroadNet. Ссылки чувствительны к регистру. Для платных моделей нужно пополнить баланс; грант $5 покрывает только broadnet/gemma-4-26b-a4b.
  • Пустые ответы. Увеличьте limit.output. Почему ответы приходят пустыми.
  • 429. Ключи с оплатой по факту допускают 30 запросов в минуту и 4 одновременно. Повторы тоже считаются. См. ошибки и повторные запросы.
  • Субагенты на тарифе. Каждая сессия тарифа обрабатывает один запрос за раз, поэтому параллельные субагенты встают в очередь, если у каждого нет своей сессии.

Вопросы и ответы

Почему opencode не находит мою модель BroadNet?

opencode ищет модель по ссылке вида провайдер/ключ в карте моделей, и ID чувствительны к регистру. С конфигом ниже выбирайте broadnet/glm-5.3, где glm-5.3 — ключ в карте. Значение modelID — только то, что отправляется в BroadNet.

В моём конфиге provider и npm с @ai-sdk/openai-compatible. Это ошибка?

Нет. Это формат V1, и руководство opencode по миграции говорит, что он по-прежнему поддерживается. В нативном формате V2 provider переименован в providers, npm — в package (aisdk:@ai-sdk/openai-compatible), а options.baseURL — в settings.baseURL.

Почему opencode возвращает пустые ответы?

Модель потратила бюджет на выход на рассуждения. Увеличьте limit.output для модели. В BroadNet рассуждения учитываются в max_tokens.

Открыть в MarkdownСпросить ChatGPTСпросить ClaudeСпросить Perplexity