BroadRouter

在 Zed 中把 BroadNet Inference 配置为 OpenAI 兼容提供商

更新于

在 Zed 的 settings.json 中,于 language_models.openai_compatible 下添加一个提供商(例如 broadnet),把 api_url 设为 https://inference.broadnet.ai/v1,并在 available_models 中列出 broadnet/glm-5.3 等 BroadNet 模型 ID,max_tokens 设为上下文大小。Zed 从 BROADNET_API_KEY 读取密钥,也可以在 Agent Settings 中保存密钥。

Zed 是一款内置智能体的开源代码编辑器。它通过 openai_compatible 提供商类型连接任何提供 OpenAI 兼容 API 的服务器。BroadNet Inference 在 https://inference.broadnet.ai/v1 提供标准的 chat completions,所以可以直接接入。BroadRouter 是 BroadNet 自己的网站;下面的步骤依据 Zed 1.28 时的 Zed API 接入文档。

配置步骤

  1. 获取密钥。 在 BroadNet 控制台创建一个按量付费密钥,或者使用不限量套餐密钥。
  2. 添加提供商。 可以用 agent: open settings 命令打开 Agent Settings,在 LLM Providers 部分点击 Add Provider;也可以直接编辑 settings.json:
{
  "language_models": {
    "openai_compatible": {
      "broadnet": {
        "api_url": "https://inference.broadnet.ai/v1",
        "available_models": [
          {
            "name": "broadnet/glm-5.3",
            "display_name": "GLM 5.3 (BroadNet)",
            "max_tokens": 1048576,
            "max_output_tokens": 16000,
            "capabilities": {
              "tools": true,
              "images": false,
              "parallel_tool_calls": false,
              "prompt_cache_key": false,
              "chat_completions": true,
              "interleaved_reasoning": false,
              "max_tokens_parameter": true
            }
          },
          {
            "name": "broadnet/qwen3.8-27b",
            "display_name": "Qwen3.8 27B (BroadNet)",
            "max_tokens": 262144,
            "max_output_tokens": 16000,
            "capabilities": {
              "tools": true,
              "images": true,
              "parallel_tool_calls": false,
              "prompt_cache_key": false,
              "chat_completions": true,
              "interleaved_reasoning": false,
              "max_tokens_parameter": true
            }
          }
        ]
      }
    }
  }
}
  1. 把密钥交给 Zed。 在启动 Zed 之前导出环境变量,或者在 Agent Settings 中把密钥粘贴到该提供商里。Zed 会把粘贴的密钥存进系统钥匙串,而不是 settings.json。
export BROADNET_API_KEY='your-broadnet-key'
  1. 测试。 打开 Agent Panel,在模型选择器中选 GLM 5.3 (BroadNet),针对一个打开的文件问个小问题。得到回答就说明连接正常。

各项设置的含义

  • name 是 Zed 发送的模型 ID。请原样使用 BroadNet 的 ID,带上 broadnet/ 前缀。
  • max_tokens 在 Zed 的配置结构里表示上下文窗口,而不是输出上限。GLM 5.3 和 DeepSeek V4.1 Flash 用 1,048,576,Qwen3.8 27B 用 262,144。
  • max_output_tokens 限制回复长度。上面的 16,000 是我们的建议值,不是 BroadNet 的限制。思考(reasoning)也计入这个上限,所以不要设得太低。
  • max_tokens_parameter: true 让 Zed 以 max_tokens 而不是 max_completion_tokens 发送输出上限。BroadNet 的 API 参考文档描述的是 max_tokens 字段。
  • images 对 OpenAI 兼容模型默认为 false。只对接受图片的模型打开它:Qwen3.8 27B、DeepSeek V4.1 Flash 和 BroadNet Gemma 4 VL 26B。
  • reasoning_effort 是可选项。BroadNet 的文档建议,想缩短思考时可设为 low。

选哪个模型

用途 模型 原因
智能体借助工具编辑代码 broadnet/glm-5.3 BroadNet 标注支持工具调用和结构化输出;1M 上下文
截图和阿拉伯语文本 broadnet/qwen3.8-27b 工具调用加图片输入;262K 上下文
固定价格套餐上的长对话 broadnet/deepseek-v4.1-flash 不限量套餐所用的模型;支持图片输入;BroadNet 未标注工具调用

Zed 默认 OpenAI 兼容模型 tools: true。BroadNet 的文档没有为 DeepSeek V4.1 Flash 列出工具调用,所以在依赖它之前,先用一个真实的智能体任务测试一下。先买一小时 Meteor($1)试用,再决定是否买一个月 Full Moon($60),成本很低。

故障排查

  • 401。 密钥错误、已过期或额度用尽。如果你设置了 BROADNET_API_KEY,它会优先于钥匙串中的密钥;想改用保存的密钥,就取消这个变量并重启 Zed。
  • 每个请求都返回 404。 检查 api_url 是否以 /v1 结尾。再检查 name 是否与 BroadNet 的 ID 完全一致。付费模型需要先充值;$5 额度只覆盖 broadnet/gemma-4-26b-a4b 和两个 Transcribe 模型。
  • 回复为空。 模型把输出预算用在了思考上。调高 max_output_tokens,或把 reasoning_effort 设为 low。为什么回答会是空的。
  • 429。 按量付费密钥每分钟允许 30 个请求,同时最多 4 个。一个套餐会话同一时间运行一个请求。参见错误与重试。
  • 远程项目。 Zed 在本地应用中初始化提供商,所以通过 SSH 工作时,密钥来自你本地的钥匙串或本地环境变量,而不是远程机器。

常见问题

Zed 从哪个环境变量读取自定义提供商的密钥?

Zed 用提供商 ID 的大写下划线形式加上 _API_KEY 组成变量名。名为 broadnet 的提供商读取 BROADNET_API_KEY。非空的环境变量优先于保存在钥匙串中的密钥。

BroadNet 的模型能在 Zed 的 Agent Panel 里用吗?

能。Zed 的 API 接入覆盖 Zed Agent、Inline Assistant、提交信息和对话摘要。Zed 默认 OpenAI 兼容模型支持工具调用,所以请选择 GLM 5.3 或 Qwen3.8 27B,BroadNet 为这两个模型标注了工具调用。

这会改变 Zed 的编辑预测吗?

不会。Zed 的文档说,编辑预测在 edit_predictions 下有单独的提供商设置。本指南配置的提供商用于智能体和 Zed 的其他 AI 功能。

为什么 Zed 提示这个模型只能用 Responses API?

对 BroadNet 来说不应该出现这个提示。把 capabilities.chat_completions 保持默认值 true。BroadNet 提供 /v1/chat/completions,并没有列出 Responses API。

以 Markdown 格式阅读问 ChatGPT问 Claude问 Perplexity