BroadRouter
Mulai

Menambahkan BroadNet Inference ke opencode sebagai custom provider

Diperbarui

Di opencode.jsonc, tambahkan entri broadnet di bawah providers dengan package @opencode/ai/providers/openai-compatible, settings.baseURL https://inference.broadnet.ai/v1, dan env BROADNET_API_KEY. Petakan key model pendek ke ID BroadNet dengan modelID, misalnya broadnet/glm-5.3, lalu pilih model dengan /models. Config V1 lama yang memakai npm @ai-sdk/openai-compatible dan options.baseURL tetap berfungsi.

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

  1. Ekspor kunci Anda di shell yang menjalankan opencode:
export BROADNET_API_KEY='your-broadnet-key'
  1. Buat config-nya. Simpan di proyek Anda sebagai opencode.jsonc, atau di ~/.config/opencode/opencode.jsonc agar 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 }
        }
      }
    }
  }
}
  1. Jalankan opencode dan pilih model dengan /models. Referensinya broadnet/<key map>, misalnya broadnet/glm-5.3. opencode mengirim nilai modelID ke 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_KEY salah, 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 pastikan modelID sama persis dengan ID BroadNet. Referensi peka huruf besar-kecil. Model berbayar memerlukan top up; kredit $5 hanya mencakup broadnet/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.

Pertanyaan umum

Kenapa opencode tidak menemukan model BroadNet saya?

opencode membaca referensi sebagai provider/key map, dan ID peka huruf besar-kecil. Dengan config di bawah, pilih broadnet/glm-5.3, di mana glm-5.3 adalah key map-nya. Nilai modelID hanya yang dikirim ke BroadNet.

Config saya memakai provider dan npm dengan @ai-sdk/openai-compatible. Apakah itu salah?

Tidak. Itu format V1, dan panduan migrasi opencode menyebut format itu tetap didukung. Bentuk native V2 mengganti provider menjadi providers, npm menjadi package (aisdk:@ai-sdk/openai-compatible), dan options.baseURL menjadi settings.baseURL.

Kenapa balasan opencode kosong?

Model menghabiskan jatah output untuk penalaran. Naikkan limit.output untuk model itu. Di BroadNet, penalaran ikut dihitung dalam max_tokens.

Baca sebagai MarkdownTanya ChatGPTTanya ClaudeTanya Perplexity