---
title: "Thiết lập provider tương thích OpenAI trong Zed (GLM, Qwen)"
description: "Thêm BroadNet Inference vào Zed làm provider tương thích OpenAI trong settings.json, kèm model ID, giới hạn token, capabilities và biến môi trường chứa key."
url: https://broadrouter.com/vi/guides/zed-openai-compatible-provider/
lang: vi
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Được dịch từ tiếng Anh với sự hỗ trợ của AI. [Đọc bản gốc tiếng Anh](https://broadrouter.com/guides/zed-openai-compatible-provider/) (cập nhật ngày 2026-11-16).

# Dùng Zed với BroadNet Inference làm provider tương thích OpenAI

Cập nhật 2026-11-16

Trong settings.json của Zed, thêm một provider dưới language\_models.openai\_compatible, ví dụ broadnet, với api\_url là https://inference.broadnet.ai/v1 và available\_models liệt kê các ID của BroadNet như broadnet/glm-5.3, đặt max\_tokens bằng kích thước context. Zed đọc key từ BROADNET\_API\_KEY, hoặc bạn có thể lưu key trong Agent Settings.

Zed là trình soạn thảo code mã nguồn mở có sẵn agent. Nó kết nối với mọi server có API tương thích OpenAI qua loại provider `openai_compatible`. BroadNet Inference phục vụ chat completions chuẩn tại `https://inference.broadnet.ai/v1`, nên dùng được ngay. BroadRouter là trang web của chính BroadNet; các bước dưới đây làm theo [tài liệu truy cập API của Zed](https://zed.dev/docs/ai/use-api-access#openai-compatible) tính đến Zed 1.28.

## Thiết lập

1.  **Lấy key.** Tạo key trả theo mức dùng trong console BroadNet, hoặc dùng key của [gói không giới hạn](https://broadrouter.com/vi/guides/unlimited-llm-api-sessions/).
2.  **Thêm provider.** Mở Agent Settings bằng lệnh `agent: open settings` rồi bấm **Add Provider** trong mục LLM Providers, hoặc sửa trực tiếp `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.  **Đưa key cho Zed.** Export key trước khi khởi động Zed, hoặc dán key vào provider trong Agent Settings. Zed lưu key được dán vào keychain của hệ thống, không lưu trong `settings.json`.

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

4.  **Kiểm tra.** Mở Agent Panel, chọn **GLM 5.3 (BroadNet)** trong bộ chọn model và hỏi một câu nhỏ về file đang mở. Có câu trả lời nghĩa là kết nối đã chạy.

## Ý nghĩa các thiết lập

-   **`name`** là model ID mà Zed gửi đi. Dùng chính xác ID của BroadNet, kèm tiền tố `broadnet/`.
-   **`max_tokens`** trong schema của Zed là context window, không phải giới hạn output. Dùng 1.048.576 cho GLM 5.3 và DeepSeek V4.1 Flash, và 262.144 cho Qwen3.8 27B.
-   **`max_output_tokens`** giới hạn độ dài câu trả lời. Con số 16.000 ở trên là gợi ý của chúng tôi, không phải giới hạn của BroadNet. Phần suy luận cũng được tính vào đây, nên đừng đặt quá thấp.
-   **`max_tokens_parameter: true`** khiến Zed gửi giới hạn output dưới tên `max_tokens` thay vì `max_completion_tokens`. Tài liệu tham chiếu API của BroadNet mô tả trường `max_tokens`.
-   **`images`** mặc định là false với model tương thích OpenAI. Chỉ bật cho model nhận ảnh: Qwen3.8 27B, DeepSeek V4.1 Flash và BroadNet Gemma 4 VL 26B.
-   **`reasoning_effort`** là tùy chọn. Tài liệu BroadNet gợi ý `low` nếu bạn muốn phần suy nghĩ ngắn hơn.

## Nên chọn model nào

| Mục đích | Model | Lý do |
| --- | --- | --- |
| Agent sửa code với tool | `broadnet/glm-5.3` | BroadNet liệt kê tool và structured output; context 1M |
| Ảnh chụp màn hình và văn bản tiếng Ả Rập | `broadnet/qwen3.8-27b` | Tool cộng đầu vào ảnh; context 262K |
| Chat dài trên gói giá cố định | `broadnet/deepseek-v4.1-flash` | Model của gói không giới hạn; nhận đầu vào ảnh; BroadNet không liệt kê tool |

Zed mặc định `tools: true` cho model tương thích OpenAI. Tài liệu BroadNet không liệt kê tool calling cho DeepSeek V4.1 Flash, nên hãy thử một tác vụ agent thật trước khi dựa vào nó. Một giờ Meteor ($1) là cách rẻ để thử trước khi mua một tháng Full Moon ($60).

## Khắc phục sự cố

-   **401.** Key sai, hết hạn hoặc hết hạn mức. Nếu bạn đặt `BROADNET_API_KEY`, biến này được ưu tiên hơn keychain; hãy unset nó và khởi động lại Zed để dùng key đã lưu.
-   **404 ở mọi request.** Kiểm tra `api_url` có kết thúc bằng `/v1` không. Sau đó kiểm tra `name` có khớp chính xác với ID của BroadNet không. Model trả phí cần nạp tiền; tín dụng $5 chỉ dùng được cho `broadnet/gemma-4-26b-a4b` và hai model Transcribe.
-   **Câu trả lời rỗng.** Model đã dùng hết ngân sách output cho phần suy luận. Tăng `max_output_tokens` hoặc đặt `reasoning_effort` là `low`. [Vì sao câu trả lời trả về rỗng](https://broadrouter.com/vi/guides/reasoning-tokens-empty-response/).
-   **429.** Key trả theo mức dùng cho phép 30 request mỗi phút và 4 request đang chạy cùng lúc. Một phiên của gói chạy mỗi lần một request. Xem [lỗi và retry](https://broadrouter.com/vi/guides/errors-and-retries/).
-   **Dự án từ xa.** Zed khởi tạo provider trong ứng dụng cục bộ, nên khi làm việc qua SSH, key được lấy từ keychain hoặc môi trường cục bộ, không phải từ máy từ xa.

## Thuật ngữ trong hướng dẫn này

[API tương thích OpenAI (OpenAI-compatible API)](https://broadrouter.com/vi/glossary/openai-compatible-api/)

API tương thích OpenAI là một HTTP API nhận cùng định dạng request và phản hồi như OpenAI API, ví dụ POST /v1/chat/completions, nên SDK và công cụ của OpenAI dùng được nó chỉ bằng cách đổi base URL, API key và tên model.

[Trả theo mức dùng (pay-as-you-go)](https://broadrouter.com/vi/glossary/pay-as-you-go/)

Trả theo mức dùng (pay-as-you-go) là mô hình giá mà bạn chỉ trả cho những gì đã dùng, đo theo đơn vị như token, request hoặc phút âm thanh, không có gói đăng ký hay cam kết tối thiểu. Hầu hết API LLM tính phí theo cách này, trừ vào số dư trả trước hoặc qua hóa đơn định kỳ.

[Đầu ra có cấu trúc (structured output)](https://broadrouter.com/vi/glossary/structured-output/)

Đầu ra có cấu trúc (structured output) là tính năng của API LLM buộc câu trả lời của model theo định dạng do lập trình viên chỉ định, thường là JSON Schema, để code parse được tin cậy. Nó chặt hơn JSON mode, vốn chỉ đảm bảo JSON hợp lệ chứ không đảm bảo một cấu trúc cụ thể.

[Giới hạn tần suất (rate limit)](https://broadrouter.com/vi/glossary/rate-limit/)

Giới hạn tần suất (rate limit) là mức trần mà API đặt ra cho lượng sử dụng của một client trong một khoảng thời gian, như số request mỗi phút hoặc số token mỗi phút. Request vượt giới hạn bị từ chối, thường với HTTP 429 Too Many Requests, cho đến khi mức dùng giảm xuống dưới giới hạn.

[Gói LLM giá cố định (flat-rate LLM plan)](https://broadrouter.com/vi/glossary/flat-rate-llm-plan/)

Gói LLM giá cố định tính một mức giá cố định cho mỗi kỳ, ví dụ một tháng, để dùng API mô hình ngôn ngữ thay vì tính theo token. Gói này thường giới hạn thứ khác, như số request đồng thời, tốc độ, model hay khung giờ sử dụng, nên giới hạn quan trọng không kém giá.

[Chat Completions API](https://broadrouter.com/vi/glossary/chat-completions-api/)

Chat Completions API là endpoint HTTP của OpenAI, POST /v1/chat/completions, nhận tên model và danh sách message có gắn vai trò rồi trả về message tiếp theo của model. Cấu trúc request và response của nó đã trở thành định dạng chung mà các nhà cung cấp và SDK tương thích OpenAI dùng lại.

[Concurrency (request đồng thời)](https://broadrouter.com/vi/glossary/concurrency/)

Concurrency (request đồng thời) là số request mà một client đang xử lý cùng lúc. Các API LLM thường giới hạn nó theo key hoặc theo gói, tách biệt với số request mỗi phút, vì mỗi request đang mở chiếm dụng năng lực GPU cho tới khi response kết thúc.

[Context window (cửa sổ ngữ cảnh)](https://broadrouter.com/vi/glossary/context-window/)

Context window là số token tối đa mà model ngôn ngữ xử lý được trong một request. Nó bao gồm prompt, lịch sử hội thoại, định nghĩa tool, hình ảnh và đầu ra được sinh ra, kể cả token suy luận. Phần không vừa phải được cắt bớt, tóm tắt hoặc chia ra nhiều request.

## Câu hỏi thường gặp

### Zed đọc key của provider tùy chỉnh từ biến môi trường nào?

Zed tạo tên biến từ ID của provider viết hoa kiểu snake case, thêm \_API\_KEY. Provider tên broadnet sẽ đọc BROADNET\_API\_KEY. Nếu biến này không rỗng, nó được ưu tiên hơn key đã lưu trong keychain.

### Model của BroadNet có chạy trong Agent Panel của Zed không?

Có. Quyền truy cập API của Zed áp dụng cho Zed Agent, Inline Assistant, commit message và tóm tắt thread. Zed mặc định model tương thích OpenAI hỗ trợ tool, nên hãy chọn GLM 5.3 hoặc Qwen3.8 27B, hai model BroadNet liệt kê là có tool.

### Thiết lập này có thay đổi edit prediction của Zed không?

Không. Tài liệu Zed nói edit prediction có phần thiết lập provider riêng dưới edit\_predictions. Provider trong hướng dẫn này dành cho agent và các tính năng AI khác của Zed.

### Vì sao Zed báo model chỉ chạy được với Responses API?

Với BroadNet thì lẽ ra không. Hãy để capabilities.chat\_completions ở giá trị mặc định true. BroadNet phục vụ /v1/chat/completions và không liệt kê Responses API.

## Hướng dẫn liên quan

-   [Dùng Kilo Code với BroadNet Inference (provider OpenAI Compatible)](https://broadrouter.com/vi/guides/kilo-code-openai-compatible/)
-   [Dùng Cline với BroadNet Inference (provider OpenAI Compatible)](https://broadrouter.com/vi/guides/cline-openai-compatible/)
-   [Vì sao model suy luận trả về câu trả lời rỗng](https://broadrouter.com/vi/guides/reasoning-tokens-empty-response/)
-   [Mã lỗi BroadNet Inference và khi nào nên thử lại](https://broadrouter.com/vi/guides/errors-and-retries/)
-   [Mọi công cụ dùng được với BroadNet Inference (tiếng Anh)](https://broadrouter.com/integrations/): SDK, agent lập trình, giao diện chat và công cụ tự động hóa, kèm cấu hình chính xác cho từng công cụ

Hãy thử với khối lượng công việc thực tế của bạn. Tài khoản mới được tặng US$5 tín dụng ban đầu cho Gemma và chuyển giọng nói thành văn bản. DeepSeek, GLM và Qwen3.8 cần nạp tiền.

[Bắt đầu](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=vi-guides-zed-openai-compatible-provider&utm_content=page-cta) ·

**Nguồn**

-   [Tài liệu Zed, Use API Access, endpoint tương thích OpenAI (kiểm tra ngày 2026-11-15)](https://zed.dev/docs/ai/use-api-access#openai-compatible)
-   [Các bản phát hành Zed trên GitHub, mới nhất v1.28.1 (kiểm tra ngày 2026-11-15)](https://github.com/zed-industries/zed/releases)
-   [Tài liệu tham chiếu API BroadNet Inference (kiểm tra ngày 2026-11-15) (tiếng Anh)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=vi-guides-zed-openai-compatible-provider&utm_content=sources)
