BroadRouter

在 Cline 中使用 BroadNet Inference(OpenAI Compatible 提供商)

更新于

在 Cline 设置中,把 API Provider 设为 OpenAI Compatible,Base URL 设为 https://inference.broadnet.ai/v1,API Key 填你的 BroadNet 密钥,Model 填 BroadNet 模型 ID,例如 broadnet/glm-5.3 或 broadnet/deepseek-v4.1-flash。然后在 Model Configuration 里设置上下文窗口,让 Cline 知道一次最多能发送多少内容。

Cline 是一个在 VS Code 里运行的编程智能体。它通过 OpenAI Compatible 提供商连接任何 OpenAI 兼容 API,而 BroadNet Inference 在 https://inference.broadnet.ai/v1 上使用标准的 chat completions 格式。下面的步骤参照 Cline 自己的提供商文档。如果你更喜欢终端里的智能体,请看 Aider 指南。

配置步骤

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

  2. 打开 Cline 设置。 点击 Cline 面板里的齿轮图标。

  3. 选择提供商。 在 API Provider 下拉菜单中选择 OpenAI Compatible。

  4. 填写连接字段。

    字段 值
    Base URL https://inference.broadnet.ai/v1
    API Key 你的 BroadNet 密钥
    Model broadnet/glm-5.3(或下表中的其他 ID)
  5. 设置 Model Configuration。 展开 Model Configuration,填写所选模型的上下文窗口。把 Max Output Tokens 设得足够大,给思考留出空间;几千 token 是稳妥的起点。只有接受图片的模型才打开图片支持。你还可以从价格页面填入输入和输出价格,让 Cline 显示的费用接近实际账单。

  6. 测试。 先跑一个小任务,例如 “explain this file”(解释这个文件)。有回答就说明连接正常。

模型 ID 要原样输入,包括 broadnet/ 前缀。

选哪个模型

模型 ID 上下文 适合
GLM 5.3 broadnet/glm-5.3 1,048,576 依赖工具调用的智能体任务
DeepSeek V4.1 Flash broadnet/deepseek-v4.1-flash 1,048,576 在不限量套餐上长时间使用;文本和图片
Qwen3.8 27B broadnet/qwen3.8-27b 262,144 工具加图片;阿拉伯语文本
BroadNet Gemma 4 VL 26B broadnet/gemma-4-26b-a4b 32,768 用免费额度试用这套配置

BroadNet 的文档为 GLM 5.3 和 Qwen3.8 27B 列出了工具和结构化输出,但没有为 DeepSeek V4.1 Flash 列出工具调用,所以在买一个月之前,先用它跑一个简短的真实任务。一小时 Meteor 的价格是 $1,一个月 Full Moon 的价格是 $60;两者都在套餐页面上。详情见 DeepSeek V4.1 Flash 模型页面。

故障排查

  • 401 Unauthorized。 密钥缺失、错误或已过期,或者按量付费账户的额度已用完。重新粘贴密钥并检查余额。Cline 的文档建议确认密钥属于 Base URL 对应的服务商。
  • 找不到模型,或第一个请求失败。 检查 ID,它必须与 BroadNet 的模型 ID 完全一致。付费模型需要先充值;对话模型中,使用免费的 $5 额度时只有 broadnet/gemma-4-26b-a4b 可用。
  • 回答为空或中途停止。 思考内容计入输出上限。调高 Max Output Tokens。为什么回答会是空的。
  • 429 Too Many Requests。 按量付费密钥每分钟允许 30 个请求,同时最多 4 个进行中的请求。Cline 是一个接一个地发请求,所以出现 429 通常意味着还有别的应用在共用这个密钥。参见错误码与重试。
  • 开了好几个 Cline 窗口后回复变慢。 一个套餐会话同一时间只处理一个请求。同一个会话上同时跑两个 Cline 任务,它们会互相排队。每个并行任务买一个会话,或者阅读用固定价格运行并行编程智能体。
  • 连接错误。 检查 Base URL 是否以 /v1 结尾,以及你的网络是否允许出站 HTTPS。如果密钥设置了 IP 白名单,请把你机器的地址加进去。

常见问题

Cline 为什么返回空回复?

模型在写出回答之前就把输出额度花在了思考上。DeepSeek V4.1 Flash、GLM 5.3 和 Qwen3.8 27B 会先思考,而思考内容计入 max_tokens。请在 Model Configuration 里调高 Max Output Tokens。

可以用不限量套餐跑 Cline 吗?

可以。不限量套餐覆盖 DeepSeek V4.1 Flash,模型 ID 为 broadnet/deepseek-v4.1-flash。把套餐密钥填进 API Key 即可。一个 Cline 任务占用一个套餐会话。

为什么模型列表不会自动填充?

请在 Model 字段里手动输入模型 ID。BroadNet 的文档把 GET /v1/models 描述为供监控使用的公开目录元数据,所以不要指望它来填充模型选择器。

免费初始额度能用哪个 BroadNet 模型?

对话模型中只有 BroadNet Gemma 4 VL 26B,模型 ID 为 broadnet/gemma-4-26b-a4b;这笔额度也覆盖两个 Transcribe 模型。其他对话模型需要先充值。它的上下文只有 32,768 token,对大型代码库来说偏小。

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