---
title: "Setup custom provider OpenAI-compatible di opencode | BroadRouter"
description: "Tambahkan BroadNet Inference ke agen coding opencode sebagai custom provider OpenAI-compatible di opencode.jsonc, lengkap dengan alias model, kapabilitas, dan limit."
url: https://broadrouter.com/id/guides/opencode-custom-provider/
lang: id
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Diterjemahkan dari bahasa Inggris dengan bantuan AI. [Baca versi asli bahasa Inggris](https://broadrouter.com/guides/opencode-custom-provider/) (diperbarui 2026-11-16).

# Menambahkan BroadNet Inference ke opencode sebagai custom provider

Diperbarui 2026-11-16

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:

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

2.  **Buat config-nya.** Simpan di proyek Anda sebagai `opencode.jsonc`, atau di `~/.config/opencode/opencode.jsonc` agar berlaku di mana saja.

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

```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 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](https://opencode.ai/docs/migrate-v1/) memetakan setiap field.

## Model mana yang dipilih

| Tugas | Model | Catatan |
| --- | --- | --- |
| Agentic coding dengan tools | [GLM 5.3](https://broadrouter.com/id/models/glm-5.3/) | Tools dan output terstruktur tercantum; konteks 1M |
| Screenshot, bahasa Arab | [Qwen3.8 27B](https://broadrouter.com/id/models/qwen3.8-27b/) | Tools dan gambar; konteks 262K |
| Sesi seharian, harga tetap | [DeepSeek V4.1 Flash](https://broadrouter.com/id/models/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](https://broadrouter.com/id/guides/reasoning-tokens-empty-response/).
-   **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](https://broadrouter.com/id/guides/errors-and-retries/).
-   **Subagen di paket.** Setiap [sesi paket](https://broadrouter.com/id/guides/unlimited-llm-api-sessions/) menangani satu permintaan dalam satu waktu, jadi subagen paralel akan mengantre kecuali masing-masing punya sesi sendiri.

## Istilah dalam panduan ini

[Tool calling (function calling)](https://broadrouter.com/id/glossary/tool-calling/)

Tool calling, disebut juga function calling, adalah fitur API LLM di mana model mengembalikan permintaan terstruktur untuk menjalankan fungsi yang didefinisikan developer, lengkap dengan argumen JSON. Aplikasi yang menjalankan fungsi itu dan mengirim hasilnya kembali; model tidak pernah menjalankan kode sendiri.

[Bayar sesuai pemakaian (pay-as-you-go)](https://broadrouter.com/id/glossary/pay-as-you-go/)

Bayar sesuai pemakaian (pay-as-you-go) adalah model harga di mana Anda hanya membayar yang Anda pakai, dihitung per satuan seperti token, permintaan, atau menit audio, tanpa langganan atau komitmen minimum. Sebagian besar API LLM menagih dengan cara ini, dari saldo prabayar atau tagihan berkala.

[Agen coding AI (AI coding agent)](https://broadrouter.com/id/glossary/coding-agent/)

Agen coding AI adalah alat perangkat lunak di mana model bahasa bekerja pada codebase dalam sebuah loop: membaca file, mengeditnya, menjalankan perintah seperti tes, membaca output, dan memutuskan langkah berikutnya sampai tugas selesai atau batas tercapai.

[Konkurensi (concurrency)](https://broadrouter.com/id/glossary/concurrency/)

Konkurensi (concurrency) adalah jumlah permintaan yang sedang berjalan dari sebuah client pada saat yang sama. API LLM sering membatasinya per kunci atau per paket, terpisah dari batas permintaan per menit, karena setiap permintaan yang terbuka menahan kapasitas GPU sampai responsnya selesai.

[Rate limit (batas laju)](https://broadrouter.com/id/glossary/rate-limit/)

Rate limit adalah batas yang diterapkan API pada seberapa banyak client boleh memakainya dalam rentang waktu tertentu, misalnya permintaan per menit atau token per menit. Permintaan yang melebihi batas ditolak, biasanya dengan HTTP 429 Too Many Requests, sampai pemakaian kembali di bawah batas.

[Subagent (sub-agen)](https://broadrouter.com/id/glossary/subagent/)

Subagent adalah agen terpisah yang dijalankan oleh agen utama untuk menangani satu tugas yang terfokus. Subagent berjalan dengan context window, system prompt, dan akses tool sendiri, mengerjakan tugasnya, lalu hanya mengembalikan hasil atau ringkasan ke agen utama, sehingga percakapan utama tetap ringkas.

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

Token adalah satuan teks yang dibaca dan ditulis model bahasa: sebuah kata, bagian kata, tanda baca, atau urutan byte yang dihasilkan tokenizer model. API LLM menghitung, membatasi, dan biasanya menagih pemakaian dalam token.

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

Chat Completions API adalah endpoint HTTP milik OpenAI, POST /v1/chat/completions, yang menerima nama model dan daftar pesan bertanda peran lalu mengembalikan pesan berikutnya dari model. Bentuk request dan response-nya menjadi format umum yang dipakai ulang oleh penyedia dan SDK yang kompatibel dengan OpenAI.

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

## Panduan terkait

-   [Memakai Cline dengan BroadNet Inference (provider OpenAI Compatible)](https://broadrouter.com/id/guides/cline-openai-compatible/)
-   [Cara kerja paket API LLM unlimited untuk agen](https://broadrouter.com/id/guides/unlimited-llm-api-sessions/)
-   [Kenapa model reasoning mengembalikan jawaban kosong](https://broadrouter.com/id/guides/reasoning-tokens-empty-response/)
-   [Memakai Vercel AI SDK dengan BroadNet Inference](https://broadrouter.com/id/guides/vercel-ai-sdk-openai-compatible/)
-   [Semua alat yang bisa dipakai dengan BroadNet Inference (bahasa Inggris)](https://broadrouter.com/integrations/): SDK, agen coding, antarmuka chat, dan alat otomatisasi, lengkap dengan pengaturan persis untuk masing-masing

Coba dengan beban kerja Anda yang sebenarnya. Akun baru mendapat kredit US$5 untuk Gemma dan transkripsi. DeepSeek, GLM, dan Qwen3.8 memerlukan top up.

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

**Sumber**

-   [Dokumentasi opencode, Providers (custom provider) (diperiksa 2026-11-14)](https://opencode.ai/docs/providers/)
-   [Dokumentasi opencode, Models (alias, kapabilitas, limit) (diperiksa 2026-11-14)](https://opencode.ai/docs/models/)
-   [Dokumentasi opencode, lokasi Config (diperiksa 2026-11-14)](https://opencode.ai/docs/config/)
-   [Dokumentasi opencode, migrasi dari V1 (diperiksa 2026-11-14)](https://opencode.ai/docs/migrate-v1/)
-   [Referensi API BroadNet Inference (bahasa Inggris)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=id-guides-opencode-custom-provider&utm_content=sources)
