---
title: "Kilo Code 配置 OpenAI 兼容的自定义供应商 | BroadRouter"
description: "把 Kilo Code 接到 BroadNet Inference，作为 OpenAI Compatible 自定义供应商：可在 VS Code 对话框或 kilo.json 中配置模型 ID、上限和工具开关。"
url: https://broadrouter.com/zh/guides/kilo-code-openai-compatible/
lang: zh-Hans
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

本页由英文原文借助 AI 翻译。 [阅读英文原文](https://broadrouter.com/guides/kilo-code-openai-compatible/) (2026-11-16 更新).

# 在 Kilo Code 中使用 BroadNet Inference（OpenAI Compatible 供应商）

更新于 2026-11-16

在 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 供应商文档](https://kilo.ai/docs/ai-providers/openai-compatible)。

## 在 VS Code 中配置

1.  **获取密钥。** 在 BroadNet 控制台创建一个按量付费密钥，或者使用[不限量套餐](https://broadrouter.com/zh/guides/unlimited-llm-api-sessions/)密钥。
    
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`。

```jsonc
{
  "$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 }
        }
      }
    }
  }
}
```

```bash
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](https://broadrouter.com/zh/models/glm-5.3/) | 列出了工具和结构化输出；1M 上下文 |
| 截图、阿拉伯语 | [Qwen3.8 27B](https://broadrouter.com/zh/models/qwen3.8-27b/) | 工具和图片；262K 上下文 |
| 长会话、固定价格 | [DeepSeek V4.1 Flash](https://broadrouter.com/zh/models/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`。[为什么回答会是空的](https://broadrouter.com/zh/guides/reasoning-tokens-empty-response/)。
-   **429。** 按量付费密钥每分钟允许 30 个请求，同时最多 4 个进行中的请求。参见[错误码与重试](https://broadrouter.com/zh/guides/errors-and-retries/)。
-   **在一个套餐密钥上并行运行的子 agent 等待或失败。** 一个套餐会话同一时间只处理一个请求，所以请给每个并行的子 agent 单独分配一个会话。
-   **连接错误。** Base URL 必须以 `/v1` 结尾。如果你的密钥设置了 [IP 白名单](https://broadrouter.com/zh/guides/api-keys-ip-allow-lists/)，请加入你机器的地址。

## 本指南涉及的术语

[子智能体（subagent）](https://broadrouter.com/zh/glossary/subagent/)

子智能体是主智能体为处理一项明确任务而启动的独立智能体。它有自己的上下文窗口、系统提示词和工具权限，完成工作后只把结果或摘要返回给主智能体，从而让主对话保持精简。

[AI 智能体（AI agent）](https://broadrouter.com/zh/glossary/agent/)

AI 智能体是由语言模型自主决定步骤、朝目标推进的系统：它决定调用哪些工具、读取结果，然后重复，直到给出最终回答或触及上限。在固定位置调用模型的固定脚本，通常称为工作流（workflow）。

[Base URL（base\_url）](https://broadrouter.com/zh/glossary/base-url/)

base URL 是 API 固定的根地址，例如 https://api.example.com/v1，客户端会把它加在每个端点路径（例如 /chat/completions）前面。在 OpenAI 兼容 SDK 中，修改 base URL，再配合 API 密钥和模型 ID，就能让同一份代码改用另一家服务商。

[大模型包月套餐（flat-rate LLM plan）](https://broadrouter.com/zh/glossary/flat-rate-llm-plan/)

大模型包月套餐（固定价格套餐）是按一个周期（如一个月）收取固定费用、提供大模型 API 使用权的计价方式，不按 token 计费。这类套餐通常会限制别的东西，如并发、速度、模型或使用时间窗口，所以限制条件和价格同样重要。

[按量付费（pay-as-you-go）](https://broadrouter.com/zh/glossary/pay-as-you-go/)

按量付费是一种计价模式：你只为实际用量付费，按 token、请求次数或音频分钟等单位计量，没有订阅费，也没有最低消费承诺。大多数大模型 API 都这样计费，从预付余额中扣减或定期开具账单。

[语音转文字（speech-to-text）](https://broadrouter.com/zh/glossary/speech-to-text/)

语音转文字，也叫自动语音识别（ASR），是把口语音频转换成书面文字的技术。语音转文字 API 接收音频文件或音频流并返回转写文本，通常按音频分钟计价。准确率用词错误率衡量，会随口音、方言和录音质量变化。

[API 密钥（API key）](https://broadrouter.com/zh/glossary/api-key/)

API 密钥是一串用于识别和授权 API 调用方的秘密字符串。大模型 API 通常要求把它放在 Authorization: Bearer 请求头里，任何持有该密钥的人都能发起请求，费用记在拥有该密钥的账户上。

[Chat Completions API（对话补全接口）](https://broadrouter.com/zh/glossary/chat-completions-api/)

Chat Completions API 是 OpenAI 的 HTTP 端点 POST /v1/chat/completions，它接收模型名称和一组带角色标记的消息，返回模型的下一条消息。它的请求与响应结构已成为 OpenAI 兼容服务商和各类 SDK 通用的格式。

## 常见问题

### 为什么填了 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。

## 相关指南

-   [在 Cline 中使用 BroadNet Inference（OpenAI Compatible 提供商）](https://broadrouter.com/zh/guides/cline-openai-compatible/)
-   [把 BroadNet Inference 添加为 opencode 的自定义供应商](https://broadrouter.com/zh/guides/opencode-custom-provider/)
-   [面向智能体的不限量 LLM API 套餐如何运作](https://broadrouter.com/zh/guides/unlimited-llm-api-sessions/)
-   [推理模型为什么返回空回答](https://broadrouter.com/zh/guides/reasoning-tokens-empty-response/)
-   [所有可与 BroadNet Inference 配合使用的工具 （英文）](https://broadrouter.com/integrations/)：SDK、编程智能体、聊天界面和自动化工具，并附每个工具的具体设置

用你的真实业务负载试一试。 新账户可获得 US$5 初始额度，用于 Gemma和转写。DeepSeek、GLM和Qwen3.8 需要先充值。

[开始使用](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=zh-guides-kilo-code-openai-compatible&utm_content=page-cta) ·

**来源**

-   [Kilo Code 文档：Using OpenAI-Compatible Providers（核对于 2026-11-15）](https://kilo.ai/docs/ai-providers/openai-compatible)
-   [Kilo Code 文档：Custom Models（id、tool\_call、limit 字段）（核对于 2026-11-15）](https://kilo.ai/docs/code-with-ai/agents/custom-models)
-   [BroadNet Inference API 参考文档（核对于 2026-11-15） （英文）](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=zh-guides-kilo-code-openai-compatible&utm_content=sources)
