opencode là một coding agent mã nguồn mở chạy trong terminal. Các provider không có trong catalog sẵn có của nó được thêm làm custom provider trong opencode.jsonc. BroadNet Inference dùng định dạng chat completions của OpenAI, nên nó dùng gói runtime tương thích OpenAI của opencode. Hướng dẫn này làm theo tài liệu opencode hiện tại (V2).
Thiết lập
- Export key trong shell dùng để khởi động opencode:
export BROADNET_API_KEY='your-broadnet-key'
- Tạo file cấu hình. Đặt nó trong dự án với tên
opencode.jsonc, hoặc ở~/.config/opencode/opencode.jsoncđể dùng ở mọi nơi.
{
"$schema": "https://opencode.ai/config.json",
"model": "broadnet/glm-5.3",
"providers": {
"broadnet": {
"name": "BroadNet Inference",
"env": ["BROADNET_API_KEY"],
"package": "@opencode/ai/providers/openai-compatible",
"settings": {
"baseURL": "https://inference.broadnet.ai/v1"
},
"models": {
"glm-5.3": {
"modelID": "broadnet/glm-5.3",
"name": "GLM 5.3",
"capabilities": { "tools": true, "input": ["text"], "output": ["text"] },
"limit": { "context": 1048576, "output": 16000 }
},
"deepseek-v4.1-flash": {
"modelID": "broadnet/deepseek-v4.1-flash",
"name": "DeepSeek V4.1 Flash",
// BroadNet's docs don't list tool calling for this model: test it first
"capabilities": { "tools": true, "input": ["text", "image"], "output": ["text"] },
"limit": { "context": 1048576, "output": 16000 }
},
"qwen3.8-27b": {
"modelID": "broadnet/qwen3.8-27b",
"name": "Qwen3.8 27B",
"capabilities": { "tools": true, "input": ["text", "image"], "output": ["text"] },
"limit": { "context": 262144, "output": 16000 }
}
}
}
}
}
- Khởi động opencode và chọn model bằng
/models. Tham chiếu có dạngbroadnet/<key trong map>, ví dụbroadnet/glm-5.3. opencode gửi giá trịmodelIDtới BroadNet.
Các file cấu hình được gộp lại. opencode áp dụng file toàn cục trước, rồi tới các file dự án tìm thấy từ thư mục hiện tại đi ngược lên (file xa nhất trước), rồi tới cấu hình .opencode/ nếu có, nên file dự án có thể ghi đè provider toàn cục. Cấu hình hệ thống được quản lý tập trung, nếu công ty bạn dùng, sẽ ghi đè cả hai. Hãy giữ key trong biến môi trường, không để trong file, để có thể đưa file cấu hình vào version control.
Vì sao dùng alias
ID của BroadNet vốn đã chứa dấu gạch chéo (broadnet/glm-5.3). Key trong map models là thứ opencode hiển thị và cho chọn, còn modelID là thứ nó gửi đi. Key ngắn giúp tham chiếu dễ đọc.
Hãy tự đặt capabilities và limit. Với một model ngoài catalog, opencode giả định có hỗ trợ JSON tool, đầu vào văn bản và hình ảnh, context 200.000 token và 32.000 token đầu ra. Tài liệu của nó gọi đây là giả định dự phòng (fallback), không phải giá trị phát hiện được. Giá trị output 16000 ở trên là đề xuất của chúng tôi, không phải giới hạn của BroadNet; nó chừa chỗ cho phần suy luận.
Cấu hình V1 cũ
opencode V2 vẫn đọc định dạng V1, nên một khối có sẵn như thế này vẫn tiếp tục chạy:
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"broadnet": {
"npm": "@ai-sdk/openai-compatible",
"name": "BroadNet Inference",
"options": {
"baseURL": "https://inference.broadnet.ai/v1",
"apiKey": "{env:BROADNET_API_KEY}"
},
"models": {
"broadnet/glm-5.3": { "name": "GLM 5.3" }
}
}
}
}
Trong dạng V2 gốc, provider đổi thành providers, npm đổi thành package (aisdk:@ai-sdk/openai-compatible nếu bạn muốn giữ gói AI SDK), còn options.baseURL và options.apiKey chuyển xuống dưới settings. Hướng dẫn chuyển đổi V1 của opencode ánh xạ từng trường.
Nên chọn model nào
| Tác vụ | Model | Ghi chú |
|---|---|---|
| Lập trình bằng agent có tool | GLM 5.3 | Có ghi hỗ trợ tool và đầu ra có cấu trúc; context 1M |
| Ảnh chụp màn hình, tiếng Ả Rập | Qwen3.8 27B | Tool và hình ảnh; context 262K |
| Phiên làm việc cả ngày, giá cố định | DeepSeek V4.1 Flash | Gói không giới hạn; BroadNet không ghi hỗ trợ tool |
opencode dựa vào lời gọi tool. Tài liệu BroadNet không ghi hỗ trợ gọi tool cho DeepSeek V4.1 Flash, nên cấu hình trên đánh dấu điều này là giả định cần thử. Hãy chạy một task thật trên một giờ Meteor ($1) trước khi mua một tháng Full Moon ($60).
Xử lý sự cố
- 401. Key trong
BROADNET_API_KEYbị sai, hết hạn hoặc hết hạn mức trả theo mức dùng. Hãy chắc chắn biến này được đặt trong tiến trình chạy opencode. - Không tìm thấy model hoặc model bị từ chối. Chọn key trong map (
broadnet/glm-5.3), và kiểm tramodelIDkhớp chính xác với ID của BroadNet. Tham chiếu phân biệt chữ hoa chữ thường. Các 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. Hãy tăng
limit.output. 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 xử lý. Các lần thử lại cũng được tính. Xem lỗi và thử lại.
- Subagent trên một gói. Mỗi phiên của gói xử lý một request tại một thời điểm, nên các subagent song song sẽ xếp hàng, trừ khi mỗi subagent có phiên riêng.
