---
title: "Persediaan penyedia serasi OpenAI tersuai opencode | BroadRouter"
description: "Tambah BroadNet Inference ke ejen pengekodan opencode sebagai penyedia serasi OpenAI tersuai dalam opencode.jsonc, dengan alias model, capabilities dan had."
url: https://broadrouter.com/ms/guides/opencode-custom-provider/
lang: ms
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Diterjemahkan daripada bahasa Inggeris dengan bantuan AI. [Baca versi asal dalam bahasa Inggeris](https://broadrouter.com/guides/opencode-custom-provider/) (dikemas kini 2026-11-16).

# Tambah BroadNet Inference ke opencode sebagai penyedia tersuai

Dikemas kini 2026-11-16

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:

```bash
export BROADNET_API_KEY='your-broadnet-key'
```

2.  **Cipta konfigurasi.** Letakkannya dalam projek anda sebagai `opencode.jsonc`, atau dalam `~/.config/opencode/opencode.jsonc` untuk menggunakannya di mana-mana.

```jsonc
{
  "$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 }
        }
      }
    }
  }
}
```

3.  **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:

```json
{
  "$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](https://opencode.ai/docs/migrate-v1/) memetakan setiap medan.

## Model mana yang patut dipilih

| Tugas | Model | Nota |
| --- | --- | --- |
| Pengekodan ejen dengan tools | [GLM 5.3](https://broadrouter.com/ms/models/glm-5.3/) | Tools dan output berstruktur disenaraikan; konteks 1M |
| Tangkapan skrin, bahasa Arab | [Qwen3.8 27B](https://broadrouter.com/ms/models/qwen3.8-27b/) | Tools dan imej; konteks 262K |
| Sesi sepanjang hari, harga tetap | [DeepSeek V4.1 Flash](https://broadrouter.com/ms/models/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](https://broadrouter.com/ms/guides/reasoning-tokens-empty-response/).
-   **429.** Kunci bayar ikut guna membenarkan 30 permintaan seminit dan 4 serentak. Cubaan semula juga dikira. Lihat [ralat dan cuba semula](https://broadrouter.com/ms/guides/errors-and-retries/).
-   **Subagent pada pelan.** Setiap [sesi pelan](https://broadrouter.com/ms/guides/unlimited-llm-api-sessions/) mengendalikan satu permintaan pada satu masa, jadi subagent selari akan beratur melainkan masing-masing mempunyai sesi sendiri.

## Istilah dalam panduan ini

[Tool calling (panggilan alatan)](https://broadrouter.com/ms/glossary/tool-calling/)

Tool calling, juga dipanggil function calling, ialah ciri API LLM di mana model memulangkan permintaan berstruktur untuk menjalankan fungsi yang ditakrifkan oleh pembangun, bersama argumen JSON. Aplikasi menjalankan fungsi itu dan menghantar hasilnya kembali; model sendiri tidak pernah menjalankan kod.

[Bayar ikut guna (pay-as-you-go)](https://broadrouter.com/ms/glossary/pay-as-you-go/)

Bayar ikut guna ialah model harga di mana anda hanya membayar apa yang anda guna, dimeter mengikut unit seperti token, permintaan atau minit audio, tanpa langganan atau komitmen minimum. Kebanyakan API LLM mengebil dengan cara ini, daripada baki prabayar atau invois berkala.

[Subejen (subagent)](https://broadrouter.com/ms/glossary/subagent/)

Subejen (subagent) ialah ejen berasingan yang dimulakan oleh ejen utama untuk mengendalikan satu tugas yang khusus. Ia berjalan dengan tetingkap konteks, prompt sistem dan akses alatan sendiri, melakukan kerja itu, dan hanya memulangkan hasil atau ringkasan kepada ejen utama, supaya perbualan utama kekal kecil.

[Tetingkap konteks (context window)](https://broadrouter.com/ms/glossary/context-window/)

Tetingkap konteks ialah bilangan maksimum token yang boleh dikendalikan oleh model bahasa dalam satu permintaan. Ia meliputi prompt, sejarah perbualan, definisi alatan, imej dan output yang dijana, termasuk token penaakulan. Apa-apa yang tidak muat mesti dipotong, diringkaskan atau dipecahkan kepada beberapa permintaan.

[Keserentakan (concurrency)](https://broadrouter.com/ms/glossary/concurrency/)

Keserentakan ialah bilangan permintaan yang sedang berjalan serentak daripada satu klien. API LLM sering mengehadkannya bagi setiap kunci atau pelan, berasingan daripada permintaan seminit, kerana setiap permintaan yang terbuka memegang kapasiti GPU sehingga responsnya selesai.

[Token](https://broadrouter.com/ms/glossary/token/)

Token ialah unit teks yang dibaca dan ditulis oleh model bahasa: satu perkataan, sebahagian perkataan, tanda baca atau jujukan bait yang dihasilkan oleh tokenizer model itu. API LLM mengira, mengehadkan dan biasanya mengebil penggunaan dalam token.

[Chat Completions API](https://broadrouter.com/ms/glossary/chat-completions-api/)

Chat Completions API ialah endpoint HTTP OpenAI, POST /v1/chat/completions, yang menerima nama model dan senarai mesej bertanda peranan, lalu memulangkan mesej seterusnya daripada model. Bentuk permintaan dan responsnya menjadi format biasa yang digunakan semula oleh penyedia dan SDK yang serasi OpenAI.

[Ejen pengekodan AI (AI coding agent)](https://broadrouter.com/ms/glossary/coding-agent/)

Ejen pengekodan AI ialah alat perisian di mana model bahasa bekerja pada codebase dalam satu gelung: ia membaca fail, menyuntingnya, menjalankan arahan seperti ujian, membaca output dan menentukan langkah seterusnya sehingga tugas selesai atau had dicapai.

## 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.

## Panduan berkaitan

-   [Guna Cline dengan BroadNet Inference (penyedia OpenAI Compatible)](https://broadrouter.com/ms/guides/cline-openai-compatible/)
-   [Cara pelan API LLM tanpa had berfungsi untuk ejen](https://broadrouter.com/ms/guides/unlimited-llm-api-sessions/)
-   [Mengapa model penaakulan memulangkan jawapan kosong](https://broadrouter.com/ms/guides/reasoning-tokens-empty-response/)
-   [Cara guna Vercel AI SDK dengan BroadNet Inference](https://broadrouter.com/ms/guides/vercel-ai-sdk-openai-compatible/)
-   [Semua alat yang berfungsi dengan BroadNet Inference (Bahasa Inggeris)](https://broadrouter.com/integrations/): SDK, ejen pengekodan, antara muka sembang dan alat automasi, dengan tetapan tepat bagi setiap satu

Cuba dengan beban kerja sebenar anda. Akaun baharu bermula dengan kredit US$5 untuk Gemma dan transkripsi. DeepSeek, GLM dan Qwen3.8 memerlukan tambah nilai.

[Mulakan](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ms-guides-opencode-custom-provider&utm_content=page-cta) ·

**Sumber**

-   [Dokumentasi opencode, Providers (penyedia tersuai) (disemak 2026-11-14)](https://opencode.ai/docs/providers/)
-   [Dokumentasi opencode, Models (alias, capabilities, had) (disemak 2026-11-14)](https://opencode.ai/docs/models/)
-   [Dokumentasi opencode, Config locations (disemak 2026-11-14)](https://opencode.ai/docs/config/)
-   [Dokumentasi opencode, Migrate from V1 (disemak 2026-11-14)](https://opencode.ai/docs/migrate-v1/)
-   [Rujukan API BroadNet Inference (Bahasa Inggeris)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ms-guides-opencode-custom-provider&utm_content=sources)
