BroadRouter
开始使用

在 Kilo Code 中使用 BroadNet Inference(OpenAI Compatible 供应商)

更新于

在 Kilo Code 中打开 Settings,进入 Providers,点击 Custom provider。Provider API 选 OpenAI Compatible,Base URL 设为 https://inference.broadnet.ai/v1,粘贴 BroadNet 密钥,再手动添加模型 ID,例如 broadnet/glm-5.3。在 kilo.json 中,用 npm @ai-sdk/openai-compatible 加 options.baseURL,并设置 limit.context 和 limit.output。

Kilo Code 是一个开源的编程 agent,可在 VS Code 和终端中使用。任何提供 OpenAI Chat Completions API 的供应商都可以作为自定义供应商添加。BroadNet Inference 在 https://inference.broadnet.ai/v1 上提供这种格式。BroadRouter 是 BroadNet 自己的网站;本指南依据 2026 年 11 月 15 日时的 Kilo 供应商文档。

在 VS Code 中配置

  1. 获取密钥。 在 BroadNet 控制台创建一个按量付费密钥,或者使用不限量套餐密钥。

  2. 打开 Settings(齿轮图标),进入 Providers 标签页。

  3. 滚动到底部,点击 Custom provider。

  4. 填写对话框:

    字段 值
    Provider ID broadnet
    Display name BroadNet Inference
    Provider API OpenAI Compatible
    Base URL https://inference.broadnet.ai/v1
    API key 你的 BroadNet 密钥
    Models 手动添加 broadnet/glm-5.3(见下文)
  5. 点击 Submit。模型会出现在模型选择器中。

  6. 测试。 发起一个任务,比如“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 白名单,请加入你机器的地址。

常见问题

为什么填了 Base URL 后,Kilo Code 没有列出 BroadNet 的聊天模型?

Kilo 从端点的 /v1/models 列表获取模型。我们在 2026 年 11 月 15 日检查时,BroadNet 公开的 /v1/models 只列出了两个语音转写模型,所以请手动添加聊天模型 ID。

BroadNet 模型的 limit.context 应该填多少?

GLM 5.3 和 DeepSeek V4.1 Flash 填 1048576,Qwen3.8 27B 填 262144,BroadNet Gemma 4 VL 26B 填 32768。Kilo 的文档说,自定义模型不设 limit 时会被当作 0,这会关闭自动上下文管理。

Kilo Code 能用 BroadNet 的不限量套餐吗?

能。套餐覆盖 DeepSeek V4.1 Flash,ID 为 broadnet/deepseek-v4.1-flash。把套餐密钥填作 API key 即可。BroadNet 的文档没有为这个模型列出工具调用,所以请先测试一个 agent 任务。

Provider API 应该选 OpenAI Compatible 还是 OpenAI Responses?

OpenAI Compatible。BroadNet 在 /v1/chat/completions 上提供 chat completions,没有列出 Responses API。

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