---
title: "Setup provider OpenAI-API-compatible di Dify (base URL)"
description: "Hubungkan Dify ke BroadNet Inference lewat plugin model provider OpenAI-API-compatible, lengkap dengan nilai field, ukuran konteks, dan pengaturan function calling."
url: https://broadrouter.com/id/guides/dify-openai-api-compatible/
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/dify-openai-api-compatible/) (diperbarui 2026-11-16).

# BroadNet Inference di Dify lewat plugin OpenAI-API-compatible

Diperbarui 2026-11-16

Di Dify, instal plugin OpenAI-API-compatible dari Integrations, Model Provider, lalu klik Add Model. Pilih tipe LLM, masukkan ID model BroadNet seperti broadnet/glm-5.3, kunci BroadNet Anda, dan API Base URL https://inference.broadnet.ai/v1. Atur Completion mode ke Chat, ukuran konteks yang sebenarnya, batas output yang menyisakan ruang untuk penalaran, dan Tool Call hanya untuk GLM 5.3 atau Qwen3.8 27B.

Dify adalah platform open source untuk membangun aplikasi dan workflow LLM. Provider yang tidak tercantum namanya di Dify ditambahkan lewat plugin model provider **OpenAI-API-compatible**, yang diterbitkan tim Dify (langgenius). BroadNet Inference melayani chat completions standar di `https://inference.broadnet.ai/v1`, jadi cocok dengan plugin ini. BroadRouter adalah situs milik BroadNet sendiri; nama field di bawah diambil dari plugin versi 0.0.83.

## Penyiapan

1.  **Dapatkan kunci.** Buat kunci bayar sesuai pemakaian di konsol BroadNet.
    
2.  **Instal plugin.** Di Dify, buka **Integrations** > **Model Provider**, cari **OpenAI-API-compatible** di antara provider yang bisa diinstal (atau buka di [Marketplace](https://marketplace.dify.ai/plugin/langgenius/openai_api_compatible)), lalu instal. Anda harus menjadi owner atau admin workspace.
    
3.  **Tambahkan model.** Klik **Add Model** di kartu provider dan isi:
    
    | Field | Nilai |
    | --- | --- |
    | Model Type | LLM |
    | Model Name | `broadnet/glm-5.3` |
    | Model display name | GLM 5.3 (BroadNet) |
    | API Key | kunci BroadNet Anda |
    | API Base URL | `https://inference.broadnet.ai/v1` |
    | Completion mode | Chat |
    | Model context size | `1048576` |
    | Upper bound for max tokens | `16000` |
    | Function Call Type | Tool Call |
    | Vision Support | Not Support |
    | Structured Output | Support |
    | API Type | Chat Completions API (/chat/completions) |
    | Token parameter name | Use max\_tokens |
    
4.  **Simpan.** Dify memeriksa kredensial sebelum menambahkan model.
    
5.  **Uji.** Buat aplikasi Chatbot, pilih **GLM 5.3 (BroadNet)** di pemilih model, lalu kirim pesan di panel pratinjau.
    

Ulangi **Add Model** untuk setiap model BroadNet yang ingin Anda pakai. Nama model harus sama persis dengan ID BroadNet, termasuk prefiks `broadnet/`.

## Nilai per model

| Model Name | Ukuran konteks | Function Call Type | Vision Support |
| --- | --- | --- | --- |
| `broadnet/glm-5.3` | 1048576 | Tool Call | Not Support |
| `broadnet/qwen3.8-27b` | 262144 | Tool Call | Support |
| `broadnet/deepseek-v4.1-flash` | 1048576 | Not Support (belum diuji) | Support |
| `broadnet/gemma-4-26b-a4b` | 32768 | Not Support | Support |

Alasan pilihan ini:

-   **Context size** default-nya 4.096 di plugin. Jika dibiarkan, Dify memangkas memori dan konteks hasil retrieval jauh di bawah yang bisa diterima model.
-   **Upper bound for max tokens** juga default-nya 4.096. Tiga dari model ini bernalar sebelum menjawab, dan penalaran ikut dihitung dalam batas ini, jadi beri ruang. 16.000 adalah saran kami, bukan batas dari BroadNet.
-   **Token parameter name** yang diatur ke `max_tokens` cocok dengan field di referensi API BroadNet. Default plugin adalah menebak dari nama model.
-   **API Type** tetap di Chat Completions. BroadNet tidak mencantumkan Responses API.

## Transkripsi

Plugin ini juga bisa menambahkan model speech-to-text. BroadNet melayani `/v1/audio/transcriptions` dengan `broadnet/cohere-transcribe-arabic` untuk bahasa Arab dan `broadnet/cohere-transcribe` untuk 14 bahasa. Menurut README plugin, untuk speech-to-text plugin menambahkan path versi sendiri, sehingga contohnya memakai host tanpa `/v1` (di sini, `https://inference.broadnet.ai`). Kami belum menguji jalur ini lewat Dify; periksa dulu dengan file WAV pendek. Lihat [panduan speech-to-text bahasa Arab](https://broadrouter.com/id/guides/arabic-speech-to-text-api/).

## Pemecahan masalah

-   **Pemeriksaan kredensial gagal.** Periksa kunci, API Base URL (diakhiri `/v1` untuk LLM), dan nama model. Model berbayar memerlukan top up; kredit $5 hanya mencakup `broadnet/gemma-4-26b-a4b`.
-   **Balasan kosong di workflow.** Max tokens pada node LLM terlalu rendah untuk model penalaran. Naikkan. [Kenapa jawaban kembali kosong](https://broadrouter.com/id/guides/reasoning-tokens-empty-response/).
-   **Node Agent tidak pernah memanggil tools.** Pakai GLM 5.3 atau Qwen3.8 27B dengan Function Call Type diatur ke Tool Call.
-   **429 saat beban tinggi.** Kunci bayar sesuai pemakaian mengizinkan 30 permintaan per menit dan 4 permintaan yang berjalan bersamaan. Cabang paralel dan node iterasi bisa melampauinya; turunkan paralelismenya. Lihat [panduan error dan percobaan ulang](https://broadrouter.com/id/guides/errors-and-retries/).

## Istilah dalam panduan ini

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

[Base URL](https://broadrouter.com/id/glossary/base-url/)

Base URL adalah alamat root tetap sebuah API, seperti https://api.example.com/v1, yang ditempatkan client di depan setiap path endpoint, seperti /chat/completions. Di SDK yang kompatibel dengan OpenAI, mengganti base URL bersama kunci API dan ID model akan mengarahkan kode yang sama ke penyedia lain.

[Speech-to-text (ucapan ke teks)](https://broadrouter.com/id/glossary/speech-to-text/)

Speech-to-text, juga disebut automatic speech recognition (ASR), adalah teknologi yang mengubah audio ucapan menjadi teks tertulis. API speech-to-text menerima file atau stream audio dan mengembalikan transkrip, biasanya dihargai per menit audio. Akurasinya diukur dengan word error rate dan bervariasi menurut aksen, dialek, dan kualitas rekaman.

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

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

[Context window (jendela konteks)](https://broadrouter.com/id/glossary/context-window/)

Context window adalah jumlah token maksimum yang bisa diolah model bahasa dalam satu permintaan. Cakupannya meliputi prompt, riwayat percakapan, definisi tool, gambar, dan output yang dihasilkan, termasuk token penalaran. Apa pun yang tidak muat harus dipotong, diringkas, atau dibagi ke beberapa permintaan.

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

[Output terstruktur (structured output)](https://broadrouter.com/id/glossary/structured-output/)

Output terstruktur adalah fitur API LLM yang membatasi balasan model pada format yang ditentukan developer, biasanya JSON Schema, agar kode bisa mem-parse-nya dengan andal. Fitur ini lebih ketat daripada JSON mode, yang menjamin JSON valid tetapi tidak menjamin bentuk tertentu.

## Pertanyaan umum

### Apakah BroadNet bisa dipakai di Dify Cloud dan juga Dify self-hosted?

Bisa. BroadNet Inference adalah endpoint HTTPS publik, jadi Dify Cloud bisa menjangkaunya. Dokumentasi Dify menyebut hanya owner dan admin workspace yang bisa mengelola model provider, dan kunci yang Anda tambahkan berlaku untuk seluruh workspace.

### Apakah API Base URL perlu memakai /v1?

Ya, untuk model LLM. Contoh dari plugin itu sendiri memakai base URL yang diakhiri /v1 untuk model chat, dan README-nya memperingatkan bahwa untuk beberapa tipe model lain plugin menambahkan path versi sendiri.

### Function Call Type mana yang harus dipilih?

Tool Call untuk GLM 5.3 dan Qwen3.8 27B, yang dicantumkan BroadNet dengan tools. Pilih Not Support untuk DeepSeek V4.1 Flash kecuali Anda sudah menguji tool call di model itu sendiri.

### Apakah kredit AI Dify berlaku untuk model BroadNet?

Tidak. Dokumentasi Dify menyebut kredit AI tidak berlaku untuk provider yang Anda jalankan dengan akun sendiri. BroadNet menagih kunci yang Anda masukkan.

## Panduan terkait

-   [Memakai BroadNet Inference di n8n (kredensial OpenAI, Base URL)](https://broadrouter.com/id/guides/n8n-openai-compatible/)
-   [Menghubungkan Open WebUI ke BroadNet Inference](https://broadrouter.com/id/guides/open-webui-openai-api/)
-   [Kenapa model reasoning mengembalikan jawaban kosong](https://broadrouter.com/id/guides/reasoning-tokens-empty-response/)
-   [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-dify-openai-api-compatible&utm_content=page-cta) ·

**Sumber**

-   [Dokumentasi Dify, Model Providers (diperiksa 2026-11-15)](https://docs.dify.ai/en/cloud/use-dify/workspace/model-providers)
-   [Dify Marketplace, plugin OpenAI-API-compatible dari langgenius, versi 0.0.83 (diperiksa 2026-11-15)](https://marketplace.dify.ai/plugin/langgenius/openai_api_compatible)
-   [Kode sumber plugin, field provider openai\_api\_compatible (diperiksa 2026-11-15)](https://github.com/langgenius/dify-official-plugins/tree/main/models/openai_api_compatible)
-   [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-dify-openai-api-compatible&utm_content=sources)
