BroadRouter
Mulakan

Tambah BroadNet Inference ke opencode sebagai penyedia tersuai

Dikemas kini

Dalam opencode.jsonc, tambah entri broadnet di bawah providers dengan package @opencode/ai/providers/openai-compatible, settings.baseURL ditetapkan kepada https://inference.broadnet.ai/v1 dan env kepada BROADNET_API_KEY. Petakan kunci model pendek kepada ID BroadNet dengan modelID, seperti broadnet/glm-5.3, kemudian pilih model dengan /models. Konfigurasi V1 lama yang menggunakan npm @ai-sdk/openai-compatible dan options.baseURL masih berfungsi.

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

  1. Eksport kunci anda dalam shell yang memulakan opencode:
export BROADNET_API_KEY='your-broadnet-key'
  1. Cipta konfigurasi. Letakkannya dalam projek anda sebagai opencode.jsonc, atau dalam ~/.config/opencode/opencode.jsonc untuk 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 }
        }
      }
    }
  }
}
  1. Mulakan opencode dan pilih model dengan /models. Rujukannya ialah broadnet/<map key>, contohnya broadnet/glm-5.3. opencode menghantar nilai modelID ke 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_KEY salah, 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 pastikan modelID sepadan tepat dengan ID BroadNet. Rujukan adalah sensitif huruf besar-kecil. Model berbayar memerlukan tambah nilai; kredit $5 hanya meliputi broadnet/gemma-4-26b-a4b dan 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.

Soalan lazim

Mengapakah opencode tidak menjumpai model BroadNet saya?

opencode menyelesaikan rujukan sebagai provider/kunci peta, dan ID adalah sensitif huruf besar-kecil. Dengan konfigurasi di bawah, pilih broadnet/glm-5.3, iaitu glm-5.3 ialah kunci peta. Nilai modelID hanyalah apa yang dihantar ke BroadNet.

Konfigurasi saya menggunakan provider dan npm dengan @ai-sdk/openai-compatible. Adakah itu salah?

Tidak. Itu format V1, dan panduan migrasi opencode menyatakan ia masih disokong. Bentuk V2 asli menamakan semula provider kepada providers, npm kepada package (aisdk:@ai-sdk/openai-compatible) dan options.baseURL kepada settings.baseURL.

Mengapakah jawapan opencode kosong?

Model telah menghabiskan bajet outputnya untuk penaakulan. Naikkan limit.output bagi model itu. Penaakulan dikira dalam max_tokens pada BroadNet.

Baca sebagai MarkdownTanya ChatGPTTanya ClaudeTanya Perplexity