opencode adalah agen coding open source untuk terminal. Provider yang tidak ada di katalog bawaannya ditambahkan sebagai custom provider di opencode.jsonc. BroadNet Inference memakai format chat completions OpenAI, jadi ia memakai paket runtime OpenAI-compatible milik opencode. Panduan ini mengikuti dokumentasi opencode versi terbaru (V2).
Setup
- Ekspor kunci Anda di shell yang menjalankan opencode:
export BROADNET_API_KEY='your-broadnet-key'
- Buat config-nya. Simpan di proyek Anda sebagai
opencode.jsonc, atau di~/.config/opencode/opencode.jsoncagar berlaku di mana saja.
{
"$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 }
}
}
}
}
}
- Jalankan opencode dan pilih model dengan
/models. Referensinyabroadnet/<key map>, misalnyabroadnet/glm-5.3. opencode mengirim nilaimodelIDke BroadNet.
File config digabungkan. opencode menerapkan file global lebih dulu, lalu file proyek yang ditemukan dari direktori saat ini ke atas (yang terjauh lebih dulu), lalu config .opencode/ jika ada, sehingga file proyek bisa menimpa provider global. Config sistem terkelola, jika perusahaan Anda memakainya, menimpa keduanya. Simpan kunci di environment, bukan di file, agar config bisa masuk version control.
Kenapa memakai alias
ID BroadNet sudah mengandung garis miring (broadnet/glm-5.3). Key di map models adalah yang ditampilkan dan dipilih opencode, sedangkan modelID adalah yang dikirimnya. Key pendek membuat referensi tetap mudah dibaca.
Atur capabilities dan limit sendiri. Untuk model di luar katalognya, opencode mengasumsikan dukungan tool JSON, input teks dan gambar, konteks 200.000 token, dan 32.000 token output. Dokumentasinya menyebut ini asumsi fallback, bukan nilai yang terdeteksi. Nilai output 16000 di atas adalah saran kami, bukan limit BroadNet; nilai itu menyisakan ruang untuk penalaran.
Config V1 lama
opencode V2 masih membaca format V1, jadi blok lama seperti ini tetap berfungsi:
{
"$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" }
}
}
}
}
Dalam bentuk native V2, provider menjadi providers, npm menjadi package (aisdk:@ai-sdk/openai-compatible jika Anda ingin tetap memakai paket AI SDK), dan options.baseURL serta options.apiKey pindah ke bawah settings. Panduan migrasi V1 opencode memetakan setiap field.
Model mana yang dipilih
| Tugas | Model | Catatan |
|---|---|---|
| Agentic coding dengan tools | GLM 5.3 | Tools dan output terstruktur tercantum; konteks 1M |
| Screenshot, bahasa Arab | Qwen3.8 27B | Tools dan gambar; konteks 262K |
| Sesi seharian, harga tetap | DeepSeek V4.1 Flash | Paket unlimited; tools tidak dicantumkan BroadNet |
opencode mengandalkan tool call. Dokumentasi BroadNet tidak mencantumkan tool calling untuk DeepSeek V4.1 Flash, jadi config di atas menandainya sebagai asumsi yang perlu diuji. Coba tugas nyata dengan satu jam Meteor ($1) sebelum membeli satu bulan Full Moon ($60).
Troubleshooting
- 401. Kunci di
BROADNET_API_KEYsalah, kedaluwarsa, atau jatah bayar sesuai pemakaiannya habis. Pastikan variabel itu terisi di proses yang menjalankan opencode. - Model tidak ditemukan atau ditolak. Pilih key map-nya (
broadnet/glm-5.3), dan pastikanmodelIDsama persis dengan ID BroadNet. Referensi peka huruf besar-kecil. Model berbayar memerlukan top up; kredit $5 hanya mencakupbroadnet/gemma-4-26b-a4b. - Jawaban kosong. Naikkan
limit.output. Kenapa jawaban kembali kosong. - 429. Kunci bayar sesuai pemakaian mengizinkan 30 permintaan per menit dan 4 permintaan yang berjalan bersamaan. Percobaan ulang juga dihitung. Lihat error dan percobaan ulang.
- Subagen di paket. Setiap sesi paket menangani satu permintaan dalam satu waktu, jadi subagen paralel akan mengantre kecuali masing-masing punya sesi sendiri.
