opencode ialah ejen pengekodan sumber terbuka untuk terminal. Penyedia yang tiada dalam katalog terbina dalamnya ditambah sebagai penyedia tersuai dalam opencode.jsonc. BroadNet Inference menggunakan format chat completions OpenAI, jadi ia menggunakan pakej runtime serasi OpenAI milik opencode. Panduan ini mengikut dokumentasi opencode semasa (V2).
Persediaan
- Eksport kunci anda dalam shell yang memulakan opencode:
export BROADNET_API_KEY='your-broadnet-key'
- Cipta konfigurasi. Letakkannya dalam projek anda sebagai
opencode.jsonc, atau dalam~/.config/opencode/opencode.jsoncuntuk menggunakannya di mana-mana.
{
"$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 }
}
}
}
}
}
- Mulakan opencode dan pilih model dengan
/models. Rujukannya ialahbroadnet/<map key>, contohnyabroadnet/glm-5.3. opencode menghantar nilaimodelIDke BroadNet.
Fail konfigurasi digabungkan. opencode menggunakan fail global dahulu, kemudian fail projek yang ditemui dari direktori semasa ke atas (yang paling jauh dahulu), kemudian sebarang konfigurasi .opencode/, jadi fail projek boleh mengatasi penyedia global. Konfigurasi sistem terurus, jika syarikat anda menggunakannya, mengatasi kedua-duanya. Simpan kunci dalam persekitaran, bukan dalam fail, supaya konfigurasi boleh dimasukkan ke dalam kawalan versi.
Mengapa ada alias
ID BroadNet sudah mengandungi garis condong (broadnet/glm-5.3). Kunci peta models ialah apa yang dipaparkan dan dipilih oleh opencode, manakala modelID ialah apa yang dihantarnya. Kunci pendek memastikan rujukan mudah dibaca.
Tetapkan capabilities dan limit sendiri. Bagi model di luar katalognya, opencode menganggap ada sokongan JSON tool, input teks dan imej, konteks 200,000 token dan 32,000 token output. Dokumentasinya memanggil ini andaian fallback, bukan nilai yang dikesan. Nilai output 16000 di atas ialah cadangan kami, bukan had BroadNet; ia memberi ruang untuk penaakulan.
Konfigurasi V1 lama
opencode V2 masih membaca format V1, jadi blok sedia ada seperti ini terus 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 V2 asli, provider menjadi providers, npm menjadi package (aisdk:@ai-sdk/openai-compatible jika anda mahu mengekalkan pakej AI SDK), dan options.baseURL serta options.apiKey berpindah ke bawah settings. Panduan migrasi V1 opencode memetakan setiap medan.
Model mana yang patut dipilih
| Tugas | Model | Nota |
|---|---|---|
| Pengekodan ejen dengan tools | GLM 5.3 | Tools dan output berstruktur disenaraikan; konteks 1M |
| Tangkapan skrin, bahasa Arab | Qwen3.8 27B | Tools dan imej; konteks 262K |
| Sesi sepanjang hari, harga tetap | DeepSeek V4.1 Flash | Pelan tanpa had; tools tidak disenaraikan oleh BroadNet |
opencode bergantung pada panggilan tool. Dokumentasi BroadNet tidak menyenaraikan tool calling untuk DeepSeek V4.1 Flash, jadi konfigurasi menandakannya sebagai andaian yang perlu diuji. Jalankan tugas sebenar pada satu jam Meteor ($1) sebelum anda membeli sebulan Full Moon ($60).
Penyelesaian masalah
- 401. Kunci dalam
BROADNET_API_KEYsalah, tamat tempoh, atau kehabisan elaun bayar ikut guna. Pastikan pemboleh ubah itu ditetapkan dalam proses yang menjalankan opencode. - Model tidak dijumpai atau ditolak. Pilih kunci peta (
broadnet/glm-5.3), dan pastikanmodelIDsepadan tepat dengan ID BroadNet. Rujukan adalah sensitif huruf besar-kecil. Model berbayar memerlukan tambah nilai; kredit $5 hanya meliputibroadnet/gemma-4-26b-a4bdan dua model Transcribe. - Jawapan kosong. Naikkan
limit.output. Mengapa jawapan kosong. - 429. Kunci bayar ikut guna membenarkan 30 permintaan seminit dan 4 serentak. Cubaan semula juga dikira. Lihat ralat dan cuba semula.
- Subagent pada pelan. Setiap sesi pelan mengendalikan satu permintaan pada satu masa, jadi subagent selari akan beratur melainkan masing-masing mempunyai sesi sendiri.
