Kilo Code 是一个开源的编程 agent,可在 VS Code 和终端中使用。任何提供 OpenAI Chat Completions API 的供应商都可以作为自定义供应商添加。BroadNet Inference 在 https://inference.broadnet.ai/v1 上提供这种格式。BroadRouter 是 BroadNet 自己的网站;本指南依据 2026 年 11 月 15 日时的 Kilo 供应商文档。
在 VS Code 中配置
-
获取密钥。 在 BroadNet 控制台创建一个按量付费密钥,或者使用不限量套餐密钥。
-
打开 Settings(齿轮图标),进入 Providers 标签页。
-
滚动到底部,点击 Custom provider。
-
填写对话框:
字段 值 Provider ID broadnetDisplay name BroadNet Inference Provider API OpenAI Compatible Base URL https://inference.broadnet.ai/v1API key 你的 BroadNet 密钥 Models 手动添加 broadnet/glm-5.3(见下文) -
点击 Submit。模型会出现在模型选择器中。
-
测试。 发起一个任务,比如“explain this file”(解释这个文件)。有回答就说明连接正常。
Kilo 会尝试从端点的 /v1/models 填充模型列表。BroadNet 的文档把这个端点描述为供监控使用的目录元数据,我们在 2026 年 11 月 15 日检查时,它只列出了两个语音转写模型。请自己输入聊天模型 ID,不要选语音转写模型。
在 kilo.json 中配置(CLI,或需要设置上限和工具开关时)
Kilo 的对话框不能设置 token 上限和工具调用。它的文档建议在配置文件中设置:~/.config/kilo/kilo.json,或者项目中的 ./kilo.json。
{
"$schema": "https://app.kilo.ai/config.json",
"model": "broadnet/glm-5.3",
"provider": {
"broadnet": {
"npm": "@ai-sdk/openai-compatible",
"env": ["BROADNET_API_KEY"],
"options": {
"baseURL": "https://inference.broadnet.ai/v1"
},
"models": {
"glm-5.3": {
"id": "broadnet/glm-5.3",
"name": "GLM 5.3",
"tool_call": true,
"reasoning": true,
"limit": { "context": 1048576, "output": 16000 }
},
"qwen3.8-27b": {
"id": "broadnet/qwen3.8-27b",
"name": "Qwen3.8 27B",
"tool_call": true,
"reasoning": true,
"modalities": { "input": ["text", "image"], "output": ["text"] },
"limit": { "context": 262144, "output": 16000 }
},
"deepseek-v4.1-flash": {
"id": "broadnet/deepseek-v4.1-flash",
"name": "DeepSeek V4.1 Flash",
"reasoning": true,
"limit": { "context": 1048576, "output": 16000 }
}
}
}
}
}
export BROADNET_API_KEY='your-broadnet-key'
- 顶层的
model值broadnet/glm-5.3是服务商名称加上映射的键(glm-5.3),而不是 BroadNet ID。id字段才是 Kilo 发给 BroadNet 的模型 ID。Kilo 的文档说id默认等于映射的键,所以只要键不是完整的 BroadNet ID(比如这里的简短键),就要设置id。 - 一定要设置
limit.context和limit.output。Kilo 的文档说,对于在目录中找不到匹配项的自定义模型,这两个值都会被当作 0,从而关闭自动上下文管理。输出值 16,000 是我们的建议,给思考留出了空间。 - 我们有意没有给 DeepSeek V4.1 Flash 加
tool_call:BroadNet 的文档没有为它列出工具调用。自己测试过之后再加上。
选哪个模型
| 任务 | 模型 | 说明 |
|---|---|---|
| 使用工具的 agent 编程 | GLM 5.3 | 列出了工具和结构化输出;1M 上下文 |
| 截图、阿拉伯语 | Qwen3.8 27B | 工具和图片;262K 上下文 |
| 长会话、固定价格 | DeepSeek V4.1 Flash | 不限量套餐;BroadNet 未列出工具支持 |
买 Full Moon 月套餐($60)之前,先用一个 Meteor 小时($1)试试不限量套餐。
故障排查
- “Invalid API Key”或 401。 重新粘贴密钥。检查密钥是否还有额度,以及运行 Kilo 的进程中是否设置了
BROADNET_API_KEY。 - “Model Not Found”。 检查 ID 是否与 BroadNet 的完全一致,包括
broadnet/前缀。付费模型需要先充值;$5 额度只覆盖broadnet/gemma-4-26b-a4b和两个 Transcribe 模型。 - 回答为空,或提示“response may be incomplete”。 当推理模型把全部输出都花在思考上时,Kilo 会给出这个警告。调高
limit.output。为什么回答会是空的。 - 429。 按量付费密钥每分钟允许 30 个请求,同时最多 4 个进行中的请求。参见错误码与重试。
- 在一个套餐密钥上并行运行的子 agent 等待或失败。 一个套餐会话同一时间只处理一个请求,所以请给每个并行的子 agent 单独分配一个会话。
- 连接错误。 Base URL 必须以
/v1结尾。如果你的密钥设置了 IP 白名单,请加入你机器的地址。
