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 tính đến Zed 1.28.
Thiết lập
- 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.
- Thêm provider. Mở Agent Settings bằng lệnh
agent: open settingsrồi bấm Add Provider trong mục LLM Providers, hoặc sửa trực tiếpsettings.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
}
}
]
}
}
}
}
- Đư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.
export BROADNET_API_KEY='your-broadnet-key'
- 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
namelà model ID mà Zed gửi đi. Dùng chính xác ID của BroadNet, kèm tiền tốbroadnet/.max_tokenstrong 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_tokensgiớ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: truekhiến Zed gửi giới hạn output dưới tênmax_tokensthay vìmax_completion_tokens. Tài liệu tham chiếu API của BroadNet mô tả trườngmax_tokens.imagesmặ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_effortlà tùy chọn. Tài liệu BroadNet gợi ýlownế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_urlcó kết thúc bằng/v1không. Sau đó kiểm tranamecó 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 chobroadnet/gemma-4-26b-a4bvà 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_tokenshoặc đặtreasoning_effortlàlow. Vì sao câu trả lời trả về rỗng. - 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.
- 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.
