---
title: "Setup custom provider OpenAI-compatible di goose | BroadRouter"
description: "Hubungkan agen AI goose ke BroadNet Inference sebagai custom provider OpenAI Compatible, lewat goose Desktop, goose configure, atau sebuah file JSON."
url: https://broadrouter.com/id/guides/goose-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/goose-custom-provider/) (diperbarui 2026-11-16).

# Menambahkan BroadNet Inference ke goose sebagai custom provider

Diperbarui 2026-11-16

Di goose, tambahkan custom provider bertipe OpenAI Compatible dengan API URL https://inference.broadnet.ai/v1/chat/completions, kunci BroadNet Anda, dan model yang tersedia seperti broadnet/glm-5.3. Gunakan tombol Add Custom Provider di goose Desktop, perintah goose configure di terminal, atau file JSON di ~/.config/goose/custom\_providers/. goose bergantung pada tool calling, jadi mulailah dengan GLM 5.3 atau Qwen3.8 27B.

goose adalah agen AI open source dengan aplikasi desktop dan CLI. Layanan yang tidak bawaan ditambahkan sebagai **custom provider**, dan goose mendukung provider yang kompatibel dengan OpenAI. BroadNet Inference menyajikan chat completions standar, jadi bisa dipakai dengan cara ini. BroadRouter adalah situs milik BroadNet sendiri; langkah-langkahnya mengikuti [dokumentasi provider goose](https://goose-docs.ai/docs/getting-started/providers/) per goose 1.59.

Dokumentasi goose memperingatkan bahwa goose “extensively uses tool calling” (terjemahan: banyak sekali memakai tool calling), dan model tanpa kemampuan itu hanya bisa chat dengan semua extension dimatikan. BroadNet mencantumkan tool calling untuk GLM 5.3 dan Qwen3.8 27B, jadi pakai salah satunya untuk pekerjaan agen.

## Opsi 1: goose Desktop

1.  Buka sidebar dan klik **Settings**, lalu tab **Models**.
    
2.  Klik **Configure providers**, lalu **Add Custom Provider** di bagian bawah.
    
3.  Isi detailnya:
    
    | Field | Nilai |
    | --- | --- |
    | Provider Type | **OpenAI Compatible** |
    | Display Name | BroadNet Inference |
    | API URL | `https://inference.broadnet.ai/v1/chat/completions` |
    | API Key | kunci BroadNet Anda |
    | Available Models | `broadnet/glm-5.3, broadnet/qwen3.8-27b` |
    | Streaming Support | aktif |
    
4.  Klik **Create Provider**, lalu pilih provider itu dan sebuah model.
    

## Opsi 2: goose CLI

Jalankan `goose configure`, pilih **Custom Providers**, lalu **Add A Custom Provider**, dan jawab pertanyaannya dengan nilai yang sama: tipe API OpenAI Compatible, API URL di atas, autentikasi **Yes** dengan API key statis, daftar model yang dipisahkan koma, dan streaming aktif.

## Opsi 3: file JSON

Buat `~/.config/goose/custom_providers/broadnet.json` (di Windows, `%APPDATA%\Block\goose\config\custom_providers\`):

```json
{
  "name": "broadnet",
  "engine": "openai",
  "display_name": "BroadNet Inference",
  "description": "BroadNet Inference, OpenAI-compatible",
  "api_key_env": "BROADNET_API_KEY",
  "base_url": "https://inference.broadnet.ai/v1/chat/completions",
  "models": [
    { "name": "broadnet/glm-5.3", "context_limit": 1048576 },
    { "name": "broadnet/qwen3.8-27b", "context_limit": 262144 },
    { "name": "broadnet/deepseek-v4.1-flash", "context_limit": 1048576 }
  ],
  "supports_streaming": true,
  "requires_auth": true
}
```

Lalu mulai sesi dengan provider itu:

```bash
export BROADNET_API_KEY='your-broadnet-key'
goose session start --provider broadnet
```

File ini boleh dimasukkan ke repositori untuk tim Anda, karena kuncinya tetap berada di environment.

## Uji

Mulailah dengan pertanyaan biasa, misalnya “apa yang bisa kamu lakukan?”. Jika ada jawaban, koneksinya berfungsi. Lalu minta sesuatu yang membutuhkan salah satu extension yang Anda aktifkan. Jika goose memanggil tool tersebut, tool calling juga berfungsi. Jika goose hanya membalas dengan teks dan tidak pernah memanggil tool, ganti ke `broadnet/glm-5.3`.

## Harga di goose

goose bisa memperkirakan biaya jika setiap model di file JSON punya `input_token_cost` dan `output_token_cost` dalam USD per token. Ambil angkanya dari [halaman harga](https://broadrouter.com/id/pricing/) BroadNet dan bagi harga per juta token dengan 1.000.000. Tanpa kedua field itu, goose memakai harga dari katalognya sendiri, yang bisa jadi tidak sama dengan harga BroadNet.

## Pemecahan masalah

-   **401.** Kuncinya salah, kedaluwarsa, atau jatahnya habis, atau `BROADNET_API_KEY` belum diatur di shell yang menjalankan goose.
-   **404.** Periksa API URL; seharusnya `https://inference.broadnet.ai/v1/chat/completions`. Pastikan ID model sama persis dengan ID BroadNet. Model berbayar memerlukan top up; kredit $5 hanya mencakup `broadnet/gemma-4-26b-a4b`, yang konteksnya 32.768 token terlalu kecil untuk pekerjaan agen.
-   **Jawaban kosong.** Pada DeepSeek V4.1 Flash, GLM 5.3, dan Qwen3.8 27B, penalaran ikut dihitung dalam batas 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. Dua sesi goose yang berbagi satu [sesi paket](https://broadrouter.com/id/guides/unlimited-llm-api-sessions/) akan mengantre, karena satu sesi paket menjalankan satu permintaan dalam satu waktu. Lihat [panduan error dan percobaan ulang](https://broadrouter.com/id/guides/errors-and-retries/).

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

[Streaming (respons streaming)](https://broadrouter.com/id/glossary/streaming/)

Streaming adalah cara mengembalikan respons model bahasa dalam potongan-potongan kecil selagi masih dihasilkan, bukan sebagai satu balasan utuh di akhir. API yang kompatibel dengan OpenAI melakukan streaming lewat server-sent events jika permintaan mengatur stream ke true.

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

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

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

[Kunci API (API key)](https://broadrouter.com/id/glossary/api-key/)

Kunci API adalah string rahasia yang mengidentifikasi dan mengotorisasi client yang memanggil API. API LLM biasanya mengharapkannya di header Authorization: Bearer, dan siapa pun yang memegang kunci itu bisa membuat permintaan yang ditagihkan ke akun pemiliknya.

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

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

Agen AI adalah sistem di mana model bahasa mengarahkan langkahnya sendiri menuju suatu tujuan: model memutuskan tool mana yang dipanggil, membaca hasilnya, dan mengulanginya sampai menghasilkan jawaban akhir atau mencapai batas. Skrip tetap yang memanggil model di titik-titik tertentu biasanya disebut workflow.

## Pertanyaan umum

### API URL goose harus diakhiri /v1 atau /v1/chat/completions?

Contoh custom provider dari goose sendiri memakai URL chat completions lengkap, jadi gunakan https://inference.broadnet.ai/v1/chat/completions. Cara ini juga membuat goose tetap memakai chat completions, format yang disajikan BroadNet.

### Model BroadNet mana yang paling cocok untuk goose?

GLM 5.3 (broadnet/glm-5.3). Dokumentasi goose menyebut goose banyak memakai tool calling, dan BroadNet mencantumkan tools hanya untuk GLM 5.3 dan Qwen3.8 27B.

### Bisakah goose dipakai dengan paket unlimited BroadNet?

Paket hanya mencakup DeepSeek V4.1 Flash, dan dokumentasi BroadNet tidak mencantumkan tool calling untuk model itu. Menurut goose, model tanpa tool calling hanya bisa chat dengan semua extension dimatikan, jadi uji dulu sebelum membeli satu bulan.

### Di mana goose menyimpan API key?

Di keychain sistem, atau di secrets.yaml jika keyring dimatikan. Jika memakai file JSON, goose membaca variabel yang namanya tertulis di api\_key\_env.

## Panduan terkait

-   [Memakai Kilo Code dengan BroadNet Inference (OpenAI Compatible)](https://broadrouter.com/id/guides/kilo-code-openai-compatible/)
-   [Menambahkan BroadNet Inference ke opencode sebagai custom provider](https://broadrouter.com/id/guides/opencode-custom-provider/)
-   [Cara kerja paket API LLM unlimited untuk agen](https://broadrouter.com/id/guides/unlimited-llm-api-sessions/)
-   [Kode error BroadNet Inference dan kapan harus mencoba ulang](https://broadrouter.com/id/guides/errors-and-retries/)
-   [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-goose-custom-provider&utm_content=page-cta) ·

**Sumber**

-   [Dokumentasi goose, Model providers dan Configure Custom Provider (diperiksa 2026-11-15)](https://goose-docs.ai/docs/getting-started/providers/)
-   [goose di GitHub (aaif-goose/goose), terbaru v1.59.1 (diperiksa 2026-11-15)](https://github.com/aaif-goose/goose)
-   [Referensi API BroadNet Inference (diperiksa 2026-11-15) (bahasa Inggris)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=id-guides-goose-custom-provider&utm_content=sources)
