Zed 是一款内置智能体的开源代码编辑器。它通过 openai_compatible 提供商类型连接任何提供 OpenAI 兼容 API 的服务器。BroadNet Inference 在 https://inference.broadnet.ai/v1 提供标准的 chat completions,所以可以直接接入。BroadRouter 是 BroadNet 自己的网站;下面的步骤依据 Zed 1.28 时的 Zed API 接入文档。
配置步骤
- 获取密钥。 在 BroadNet 控制台创建一个按量付费密钥,或者使用不限量套餐密钥。
- 添加提供商。 可以用
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
}
}
]
}
}
}
}
- 把密钥交给 Zed。 在启动 Zed 之前导出环境变量,或者在 Agent Settings 中把密钥粘贴到该提供商里。Zed 会把粘贴的密钥存进系统钥匙串,而不是
settings.json。
export BROADNET_API_KEY='your-broadnet-key'
- 测试。 打开 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 工作时,密钥来自你本地的钥匙串或本地环境变量,而不是远程机器。
