---
title: "Zed 配置 OpenAI 兼容提供商（GLM、Qwen） | BroadRouter"
description: "在 Zed 编辑器的 settings.json 中把 BroadNet Inference 添加为 OpenAI 兼容提供商，包括模型 ID、token 限制、能力开关和密钥环境变量。"
url: https://broadrouter.com/zh/guides/zed-openai-compatible-provider/
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/zed-openai-compatible-provider/)（2026-11-16 更新）。

# 在 Zed 中把 BroadNet Inference 配置为 OpenAI 兼容提供商

更新于 2026-11-16

在 Zed 的 settings.json 中，于 language\_models.openai\_compatible 下添加一个提供商（例如 broadnet），把 api\_url 设为 https://inference.broadnet.ai/v1，并在 available\_models 中列出 broadnet/glm-5.3 等 BroadNet 模型 ID，max\_tokens 设为上下文大小。Zed 从 BROADNET\_API\_KEY 读取密钥，也可以在 Agent Settings 中保存密钥。

Zed 是一款内置智能体的开源代码编辑器。它通过 `openai_compatible` 提供商类型连接任何提供 OpenAI 兼容 API 的服务器。BroadNet Inference 在 `https://inference.broadnet.ai/v1` 提供标准的 chat completions，所以可以直接接入。BroadRouter 是 BroadNet 自己的网站；下面的步骤依据 Zed 1.28 时的 [Zed API 接入文档](https://zed.dev/docs/ai/use-api-access#openai-compatible)。

## 配置步骤

1.  **获取密钥。** 在 BroadNet 控制台创建一个按量付费密钥，或者使用[不限量套餐](https://broadrouter.com/zh/guides/unlimited-llm-api-sessions/)密钥。
2.  **添加提供商。** 可以用 `agent: open settings` 命令打开 Agent Settings，在 LLM Providers 部分点击 **Add Provider**；也可以直接编辑 `settings.json`：

```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
            }
          }
        ]
      }
    }
  }
}
```

3.  **把密钥交给 Zed。** 在启动 Zed 之前导出环境变量，或者在 Agent Settings 中把密钥粘贴到该提供商里。Zed 会把粘贴的密钥存进系统钥匙串，而不是 `settings.json`。

```bash
export BROADNET_API_KEY='your-broadnet-key'
```

4.  **测试。** 打开 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`。[为什么回答会是空的](https://broadrouter.com/zh/guides/reasoning-tokens-empty-response/)。
-   **429。** 按量付费密钥每分钟允许 30 个请求，同时最多 4 个。一个套餐会话同一时间运行一个请求。参见[错误与重试](https://broadrouter.com/zh/guides/errors-and-retries/)。
-   **远程项目。** Zed 在本地应用中初始化提供商，所以通过 SSH 工作时，密钥来自你本地的钥匙串或本地环境变量，而不是远程机器。

## 本指南涉及的术语

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

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

[大模型包月套餐（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 都这样计费，从预付余额中扣减或定期开具账单。

[并发（concurrency）](https://broadrouter.com/zh/glossary/concurrency/)

并发（concurrency）是客户端在同一时刻正在进行中的请求数。大模型 API 往往按密钥或套餐单独限制并发，与每分钟请求数分开计算，因为每个未完成的请求在响应结束前都会占用 GPU 资源。

[结构化输出（structured output）](https://broadrouter.com/zh/glossary/structured-output/)

结构化输出是大模型 API 的一项功能，它把模型的回复约束为开发者指定的格式（通常是 JSON Schema），让代码能可靠地解析。它比 JSON mode 更严格：JSON mode 只保证输出是合法 JSON，不保证特定结构。

[速率限制（rate limit）](https://broadrouter.com/zh/glossary/rate-limit/)

速率限制是 API 对客户端在一个时间窗口内的使用量设定的上限，例如每分钟请求数或每分钟 token 数。超出限制的请求会被拒绝，通常返回 HTTP 429 Too Many Requests，直到用量回落到限制以下。

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

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

## 常见问题

### Zed 从哪个环境变量读取自定义提供商的密钥？

Zed 用提供商 ID 的大写下划线形式加上 \_API\_KEY 组成变量名。名为 broadnet 的提供商读取 BROADNET\_API\_KEY。非空的环境变量优先于保存在钥匙串中的密钥。

### BroadNet 的模型能在 Zed 的 Agent Panel 里用吗？

能。Zed 的 API 接入覆盖 Zed Agent、Inline Assistant、提交信息和对话摘要。Zed 默认 OpenAI 兼容模型支持工具调用，所以请选择 GLM 5.3 或 Qwen3.8 27B，BroadNet 为这两个模型标注了工具调用。

### 这会改变 Zed 的编辑预测吗？

不会。Zed 的文档说，编辑预测在 edit\_predictions 下有单独的提供商设置。本指南配置的提供商用于智能体和 Zed 的其他 AI 功能。

### 为什么 Zed 提示这个模型只能用 Responses API？

对 BroadNet 来说不应该出现这个提示。把 capabilities.chat\_completions 保持默认值 true。BroadNet 提供 /v1/chat/completions，并没有列出 Responses API。

## 相关指南

-   [在 Kilo Code 中使用 BroadNet Inference（OpenAI Compatible 供应商）](https://broadrouter.com/zh/guides/kilo-code-openai-compatible/)
-   [在 Cline 中使用 BroadNet Inference（OpenAI Compatible 提供商）](https://broadrouter.com/zh/guides/cline-openai-compatible/)
-   [推理模型为什么返回空回答](https://broadrouter.com/zh/guides/reasoning-tokens-empty-response/)
-   [BroadNet Inference 错误码，以及什么时候该重试](https://broadrouter.com/zh/guides/errors-and-retries/)
-   [所有可与 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-zed-openai-compatible-provider&utm_content=page-cta) ·

**来源**

-   [Zed 文档：Use API Access，OpenAI 兼容端点（核对于 2026-11-15）](https://zed.dev/docs/ai/use-api-access#openai-compatible)
-   [Zed 在 GitHub 上的发布页，最新为 v1.28.1（核对于 2026-11-15）](https://github.com/zed-industries/zed/releases)
-   [BroadNet Inference API 参考文档（核对于 2026-11-15）（英文）](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=zh-guides-zed-openai-compatible-provider&utm_content=sources)
