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。再用 modelID 把简短的模型键映射到 BroadNet 的 ID,例如 broadnet/glm-5.3,然后用 /models 选择模型。使用 npm @ai-sdk/openai-compatible 和 options.baseURL 的旧版 V1 配置仍然可用。

opencode 是一个运行在终端里的开源编程 agent。不在它内置目录中的供应商,要在 opencode.jsonc 里作为自定义供应商添加。BroadNet Inference 使用 OpenAI 对话补全格式,所以用的是 opencode 的 OpenAI 兼容运行时包。本指南依据 opencode 当前(V2)的文档。

配置步骤

  1. 在启动 opencode 的 shell 中导出密钥:
export BROADNET_API_KEY='your-broadnet-key'
  1. 创建配置文件。 放在项目里命名为 opencode.jsonc,或者放在 ~/.config/opencode/opencode.jsonc,在所有项目中生效。
{
  "$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。opencode 发送给 BroadNet 的是 modelID 的值。

配置文件会合并。opencode 先应用全局文件,然后从当前目录向上查找项目文件(最远的先应用),再应用 .opencode/ 中的配置,所以项目文件可以覆盖全局的供应商设置。如果你的公司使用托管的系统配置,它会覆盖以上两者。密钥请放在环境变量里而不是文件里,这样配置文件就可以放进版本控制。

为什么要用别名

BroadNet 的 ID 本身就带斜杠(broadnet/glm-5.3)。models 映射键是 opencode 显示和选择时用的名字,modelID 是它实际发送的值。简短的键让引用更易读。

capabilities 和 limit 请自己设置。对于目录外的模型,opencode 会假定它支持 JSON 工具调用、接受文本和图片输入、上下文为 200,000 token、输出为 32,000 token。它的文档称这些为兜底假设,而不是检测出来的值。上面 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(如果想继续使用 AI SDK 的包,就写 aisdk:@ai-sdk/openai-compatible),options.baseURL 和 options.apiKey 移到 settings 下。opencode V1 迁移指南列出了每个字段的对应关系。

选哪个模型

任务 模型 说明
带工具的 agent 编程 GLM 5.3 列出了工具和结构化输出;1M 上下文
截图、阿拉伯语 Qwen3.8 27B 工具和图片;262K 上下文
全天会话、固定价格 DeepSeek V4.1 Flash 不限量套餐;BroadNet 未列出工具

opencode 依赖工具调用。BroadNet 的文档没有为 DeepSeek V4.1 Flash 列出工具调用,所以配置里把它标成了需要测试的假设。买一个月 Full Moon($60)之前,先用一小时 Meteor($1)跑一个真实任务。

故障排查

  • 401。 BROADNET_API_KEY 中的密钥错误、已过期,或者按量付费额度已用完。确认运行 opencode 的进程里设置了这个变量。
  • 找不到模型或模型被拒绝。 选择映射键(broadnet/glm-5.3),并检查 modelID 是否与 BroadNet 的 ID 完全一致。引用区分大小写。付费模型需要先充值;$5 额度只能用于 broadnet/gemma-4-26b-a4b 和两个 Transcribe 模型。
  • 回答为空。 调高 limit.output。为什么回答会是空的。
  • 429。 按量付费密钥每分钟允许 30 个请求,同时最多 4 个在处理中。重试也会计入。见错误码与重试。
  • 在套餐上运行子 agent。 每个套餐会话一次只处理一个请求,所以并行的子 agent 会排队,除非每个都有自己的会话。

常见问题

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