---
title: "Base URL serasi OpenAI dalam n8n dengan OpenAI Chat Model"
description: "Halakan kelayakan OpenAI n8n ke BroadNet Inference melalui medan Base URL, kemudian guna nod OpenAI Chat Model mengikut ID dengan Responses API dimatikan."
url: https://broadrouter.com/ms/guides/n8n-openai-compatible/
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/n8n-openai-compatible/) (dikemas kini 2026-11-16).

# Guna BroadNet Inference dalam n8n (kelayakan OpenAI, Base URL)

Dikemas kini 2026-11-16

Dalam n8n, cipta kelayakan OpenAI dengan kunci BroadNet anda sebagai API Key dan Base URL ditetapkan kepada https://inference.broadnet.ai/v1. Dalam nod OpenAI Chat Model, tukar Model daripada From List kepada ID, masukkan ID BroadNet seperti broadnet/glm-5.3, dan matikan Use Responses API supaya n8n memanggil chat completions.

n8n ialah alat automasi aliran kerja. Kelayakan (credential) **OpenAI** n8n mempunyai medan **Base URL**, jadi nod **OpenAI Chat Model** (dan nod OpenAI lain yang menggunakan kelayakan itu) boleh memanggil sebarang API serasi OpenAI. BroadNet Inference ialah salah satu daripadanya. Halaman dokumentasi n8n untuk kelayakan itu tidak menunjukkan medan Base URL, jadi nama medan di bawah turut disemak berbanding kod sumber n8n, yang dipautkan dalam sumber.

## Persediaan

1.  **Cipta kelayakan.** Dalam n8n, pergi ke **Credentials**, cipta kelayakan **OpenAI** baharu, dan isikan:
    
    | Medan | Nilai |
    | --- | --- |
    | API Key | kunci BroadNet anda |
    | Organization ID (optional) | biarkan kosong |
    | Base URL | `https://inference.broadnet.ai/v1` |
    
    Simpan. n8n menguji kelayakan itu dengan memanggil `/models` pada Base URL.
    
2.  **Tambah nod model.** Tambah nod **AI Agent** atau **Basic LLM Chain**, kemudian sambungkan sub-nod **OpenAI Chat Model** dan pilih kelayakan tersebut.
    
3.  **Tetapkan model mengikut ID.** Dalam **Model**, tukar mod daripada **From List** kepada **ID** dan masukkan `broadnet/glm-5.3`.
    
4.  **Matikan Use Responses API.** Dalam kod sumber n8n, togol ini wujud mulai versi nod 1.3 dan dihidupkan secara lalai di situ. BroadNet menyediakan chat completions, jadi matikannya.
    
5.  **Tetapkan pilihan.** Di bawah **Options**, biarkan **Maximum Number of Tokens** pada nilai lalainya (-1) atau tetapkan kepada beberapa ribu. **Max Retries** lalainya 2; naikkan jika anda mahu n8n mencuba semula panggilan yang gagal dengan lebih kerap.
    
6.  **Jalankan aliran kerja** sekali dengan prompt ujian.
    

n8n memaparkan notis apabila anda menggunakan Base URL bukan OpenAI: bukan semua model mungkin serasi chat atau menyokong tools calling atau format respons JSON. Untuk BroadNet, chat berfungsi pada setiap model chat, tetapi dokumentasi BroadNet menyenaraikan tools dan output berstruktur hanya untuk GLM 5.3 dan Qwen3.8 27B.

## Model mana yang patut dipilih

| Aliran kerja | Model | Sebab |
| --- | --- | --- |
| AI Agent dengan alatan | `broadnet/glm-5.3` | Tools dan output berstruktur disenaraikan oleh BroadNet |
| Imej, mesej bahasa Arab | `broadnet/qwen3.8-27b` | Tools, input imej, diuji dalam bahasa Arab |
| Pengelasan volum tinggi | `broadnet/gemma-4-26b-a4b` | Harga setiap token yang rendah; tiada penaakulan disenaraikan |
| Dokumen panjang | `broadnet/deepseek-v4.1-flash` | Konteks 1M; tools tidak disenaraikan |

Bandingkan harga di [halaman harga](https://broadrouter.com/ms/pricing/). Untuk audio, nod HTTP Request n8n boleh menghantar fail ke `/v1/audio/transcriptions`; [panduan speech-to-text bahasa Arab](https://broadrouter.com/ms/guides/arabic-speech-to-text-api/) menunjukkan medan borang yang perlu dihantar.

## Penyelesaian masalah

-   **Ujian kelayakan gagal.** Pastikan Base URL berakhir dengan `/v1` tanpa laluan tambahan. Jika panggilan chat juga memulangkan 401, kunci salah, tamat tempoh, atau elaun bayar ikut guna telah habis.
-   **Ralat model.** Gunakan mod **ID** dan masukkan ID BroadNet yang tepat dengan awalan `broadnet/`. GLM 5.3, Qwen3.8 27B dan DeepSeek V4.1 Flash memerlukan tambah nilai; kredit permulaan $5 meliputi BroadNet Gemma 4 VL 26B.
-   **“Bad request - please check your parameters”.** Dokumentasi n8n mencadangkan anda mengulangi panggilan dalam nod HTTP Request untuk melihat ralat penuh. Punca biasa di sini ialah togol Responses API.
-   **Output kosong.** Penaakulan dikira dalam **Maximum Number of Tokens**. Naikkan nilainya. [Mengapa jawapan kosong](https://broadrouter.com/ms/guides/reasoning-tokens-empty-response/).
-   **429 dalam gelung.** Kunci bayar ikut guna membenarkan 30 permintaan seminit dan 4 serentak. Dokumentasi n8n mencadangkan **Loop Over Items** dengan nod **Wait** untuk mengatur rentak kelompok. Lihat [ralat dan cuba semula](https://broadrouter.com/ms/guides/errors-and-retries/).
-   **Pelaksanaan selari pada kunci pelan.** [Sesi pelan tanpa had](https://broadrouter.com/ms/guides/unlimited-llm-api-sessions/) menjalankan satu permintaan pada satu masa. Pelaksanaan aliran kerja yang selari akan beratur melainkan setiap satu mempunyai sesi sendiri.

Lebih suka kod? Tetapan yang sama berfungsi dalam [LangChain](https://broadrouter.com/ms/guides/langchain-openai-base-url/), yang menjadi asas nod AI n8n.

## Istilah dalam panduan ini

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

Base URL ialah alamat akar tetap sesuatu API, seperti https://api.example.com/v1, yang diletakkan oleh klien di hadapan setiap laluan endpoint, seperti /chat/completions. Dalam SDK serasi OpenAI, menukar base URL, bersama kunci API dan ID model, menghalakan kod yang sama kepada penyedia lain.

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

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

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

Ejen AI ialah sistem di mana model bahasa mengarahkan langkahnya sendiri ke arah sesuatu matlamat: ia memutuskan alatan yang hendak dipanggil, membaca hasilnya dan mengulang sehingga menghasilkan jawapan akhir atau mencapai had. Skrip tetap yang memanggil model pada titik yang ditetapkan biasanya dipanggil aliran kerja (workflow).

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

[Output berstruktur (structured output)](https://broadrouter.com/ms/glossary/structured-output/)

Output berstruktur ialah ciri API LLM yang mengehadkan balasan model kepada format yang ditetapkan oleh pembangun, biasanya JSON Schema, supaya kod boleh menghuraikannya dengan boleh dipercayai. Ia lebih ketat daripada JSON mode, yang menjamin JSON yang sah tetapi bukan bentuk tertentu.

[API serasi OpenAI (OpenAI-compatible API)](https://broadrouter.com/ms/glossary/openai-compatible-api/)

API serasi OpenAI ialah API HTTP yang menerima format permintaan dan respons yang sama seperti OpenAI API, contohnya POST /v1/chat/completions, jadi SDK dan alat OpenAI boleh menggunakannya dengan hanya menukar base URL, kunci API dan nama model.

## Soalan lazim

### Mengapakah AI Agent n8n gagal dengan BroadNet?

Pastikan Use Responses API dimatikan dalam nod OpenAI Chat Model. Dalam versi nod 1.3 ia dihidupkan secara lalai, dan BroadNet menyediakan /v1/chat/completions, bukan Responses API. Tetapkan juga Model kepada mod ID dengan ID BroadNet yang tepat.

### Mengapakah senarai juntai bawah model kosong atau salah?

Mod From List membaca endpoint /models penyedia. Dokumentasi BroadNet menerangkan endpoint itu sebagai metadata katalog awam untuk pemantau. Tukar Model kepada mod ID dan taip ID model BroadNet.

### Mengapakah ejen n8n memulangkan output kosong?

Penaakulan telah menghabiskan Maximum Number of Tokens. Naikkan nilainya, atau biarkan pada nilai lalai -1.

### Di manakah medan Base URL dalam kelayakan OpenAI n8n?

Ia berada dalam kelayakan OpenAI itu sendiri, di bawah API Key dan Organization ID. Nilai lalainya ialah https://api.openai.com/v1. Gantikan dengan https://inference.broadnet.ai/v1, kekalkan /v1 dan jangan tambah laluan lain.

## Panduan berkaitan

-   [Cara transkripsikan nota suara WhatsApp dalam n8n](https://broadrouter.com/ms/guides/n8n-whatsapp-voice-note-transcription/)
-   [Cara guna LangChain dengan BroadNet Inference](https://broadrouter.com/ms/guides/langchain-openai-base-url/)
-   [API speech-to-text bahasa Arab, langkah demi langkah](https://broadrouter.com/ms/guides/arabic-speech-to-text-api/)
-   [Mengapa model penaakulan memulangkan jawapan kosong](https://broadrouter.com/ms/guides/reasoning-tokens-empty-response/)
-   [Kod ralat BroadNet Inference dan bila perlu cuba semula](https://broadrouter.com/ms/guides/errors-and-retries/)
-   [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-n8n-openai-compatible&utm_content=page-cta) ·

**Sumber**

-   [Dokumentasi n8n, nod OpenAI Chat Model (disemak 2026-11-14)](https://docs.n8n.io/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.lmchatopenai/)
-   [Dokumentasi n8n, isu lazim OpenAI Chat Model (disemak 2026-11-14)](https://docs.n8n.io/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.lmchatopenai/common-issues/)
-   [Dokumentasi n8n, kelayakan OpenAI (disemak 2026-11-14)](https://docs.n8n.io/integrations/builtin/credentials/openai/)
-   [Kod sumber n8n, medan kelayakan OpenAI (disemak 2026-11-14)](https://github.com/n8n-io/n8n/blob/master/packages/nodes-base/credentials/OpenAiApi.credentials.ts)
-   [Kod sumber n8n, nod OpenAI Chat Model (disemak 2026-11-14)](https://github.com/n8n-io/n8n/blob/master/packages/@n8n/nodes-langchain/nodes/llms/LMChatOpenAi/LmChatOpenAi.node.ts)
-   [Rujukan API BroadNet Inference (Bahasa Inggeris)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ms-guides-n8n-openai-compatible&utm_content=sources)
