---
title: "Apakah itu API serasi OpenAI? Cara ia berfungsi | BroadRouter"
description: "API serasi OpenAI menerima permintaan sama seperti OpenAI, jadi SDK sedia ada berfungsi dengan menukar base URL, kunci dan model. Apa yang sama, apa yang berbeza."
url: https://broadrouter.com/ms/glossary/openai-compatible-api/
lang: ms
updated: 2026-11-15
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/glossary/openai-compatible-api/) (dikemas kini 2026-11-15).

# API serasi OpenAI (OpenAI-compatible API)

Dikemas kini 2026-11-15

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.

Juga dikenali sebagai: API serasi OpenAI, serasi dengan OpenAI, OpenAI-compatible API, OpenAI API compatible, OpenAI-style API, OpenAI drop-in replacement

Format API OpenAI telah menjadi bahasa bersama alatan LLM. Banyak penyedia kini menerimanya, jadi satu pustaka klien boleh berhubung dengan banyak backend.

## Cara ia berfungsi

API yang serasi menyalin bahagian OpenAI API yang diperlukan oleh klien:

-   laluan yang sama, seperti `/v1/chat/completions` dan `/v1/audio/transcriptions`;
-   bentuk JSON yang sama: tatasusunan `messages` sebagai input, `choices[0].message.content` sebagai output, dan blok `usage` dengan bilangan token;
-   [kunci API](https://broadrouter.com/ms/glossary/api-key/) yang dihantar sebagai `Authorization: Bearer <key>`;
-   [penstriman](https://broadrouter.com/ms/glossary/streaming/) sebagai server-sent events apabila `stream` ialah true.

Bertukar penyedia hanyalah perubahan konfigurasi. Dengan Python SDK rasmi:

```python
from openai import OpenAI
import os

client = OpenAI(base_url="https://inference.broadnet.ai/v1", api_key=os.environ["BROADNET_API_KEY"])
reply = client.chat.completions.create(
    model="broadnet/gemma-4-26b-a4b",
    messages=[{"role": "user", "content": "Say hello in Arabic."}],
)
print(reply.choices[0].message.content)
```

Hanya tiga nilai berubah daripada contoh OpenAI: [base URL](https://broadrouter.com/ms/glossary/base-url/), kunci dan ID model.

## Mengapa ia penting

Keserasian mengurangkan kos bertukar. SDK, rangka kerja ejen, plugin IDE dan [router](https://broadrouter.com/ms/glossary/llm-router/) yang menggunakan format OpenAI berfungsi tanpa kod baharu. Anda boleh menguji penyedia kedua dalam beberapa minit dan mengekalkan pilihan untuk berpindah.

Tetapi serasi tidak bermaksud serupa. Contohnya, lapisan keserasian Anthropic sendiri mengabaikan `strict` pada alatan dan membiarkan `prompt_tokens_details` kosong. Perbezaan biasa ialah:

-   parameter yang diabaikan atau ditolak;
-   cara [token penaakulan](https://broadrouter.com/ms/glossary/reasoning-tokens/) dikira dalam `max_tokens`;
-   sama ada usage dilaporkan pada penghujung strim;
-   had kadar dan kod ralat.

## Di BroadNet Inference

BroadNet Inference menyediakan `POST /v1/chat/completions`, `POST /v1/audio/transcriptions` dan `GET /v1/models` di `https://inference.broadnet.ai/v1`. Kunci dihantar hanya sebagai `Authorization: Bearer <key>`. Panduan [Python](https://broadrouter.com/ms/guides/openai-python-sdk/) dan [Node](https://broadrouter.com/ms/guides/openai-node-sdk/) menunjukkan persediaan penuh, dan [LangChain](https://broadrouter.com/ms/guides/langchain-openai-base-url/) berfungsi dengan cara yang sama.

Dua perbezaan yang perlu dirancang: DeepSeek V4.1 Flash, GLM 5.3 dan Qwen3.8 27B membuat penaakulan sebelum menjawab, dan penaakulan itu dikira dalam `max_tokens`. Selain itu, kunci bayar ikut guna membenarkan 30 permintaan seminit dan 4 serentak. [Senarai semak migrasi](https://broadrouter.com/ms/blog/openai-compatible-api-migration-checklist/) merangkumi selebihnya.

## Kesilapan biasa

-   Mengekalkan nama model OpenAI seperti `gpt-6-astra` (model utama OpenAI di halaman modelnya, disemak 2026-11-15). Gunakan ID model penyedia.
-   Menganggap sesuatu parameter berfungsi hanya kerana permintaan berjaya. Sesetengah penyedia mengabaikan medan yang tidak dikenali tanpa sebarang amaran.

## Soalan lazim

### Adakah serasi OpenAI bermaksud setiap ciri OpenAI berfungsi?

Tidak. Ia bermaksud bentuk teras permintaan dan respons adalah sepadan. Medan tertentu mungkin diabaikan atau ditolak. Contohnya, lapisan keserasian Anthropic mendokumenkan medan yang diabaikannya dan medan yang memulangkan ralat 400. Baca senarai penyedia sebelum anda bergantung pada sesuatu parameter.

### Adakah saya memerlukan SDK lain?

Tidak. SDK OpenAI rasmi menerima base URL tersuai. Dalam Python, hantar base\_url; dalam Node, hantar baseURL; atau tetapkan pembolehubah persekitaran OPENAI\_BASE\_URL.

### Endpoint manakah yang disokong oleh BroadNet Inference?

POST /v1/chat/completions untuk chat dan POST /v1/audio/transcriptions untuk speech-to-text. GET /v1/models juga wujud; dokumentasi BroadNet menggambarkannya sebagai metadata katalog awam untuk pemantau luaran, jadi ambil ID model untuk permintaan daripada rujukan API.

## Lihat juga

-   [Base URL (URL asas)](https://broadrouter.com/ms/glossary/base-url/) (istilah)
-   [Kunci API (API key)](https://broadrouter.com/ms/glossary/api-key/) (istilah)
-   [Penghala LLM (LLM router)](https://broadrouter.com/ms/glossary/llm-router/) (istilah)
-   [Penstriman (streaming)](https://broadrouter.com/ms/glossary/streaming/) (istilah)
-   [Penyedia inferens (inference provider)](https://broadrouter.com/ms/glossary/inference-provider/) (istilah)
-   [Server-sent events (SSE)](https://broadrouter.com/ms/glossary/sse/) (istilah)
-   [Chat Completions API](https://broadrouter.com/ms/glossary/chat-completions-api/) (istilah)
-   [Cara guna OpenAI Python SDK dengan BroadNet Inference](https://broadrouter.com/ms/guides/openai-python-sdk/) (panduan)
-   [Cara guna OpenAI Node.js SDK dengan BroadNet Inference](https://broadrouter.com/ms/guides/openai-node-sdk/) (panduan)
-   [Cara guna LangChain dengan BroadNet Inference](https://broadrouter.com/ms/guides/langchain-openai-base-url/) (panduan)
-   [Permintaan pertama ke BroadNet Inference dengan curl](https://broadrouter.com/ms/guides/curl-quickstart/) (panduan)
-   [Beralih ke API serasi OpenAI: senarai semak migrasi](https://broadrouter.com/ms/blog/openai-compatible-api-migration-checklist/) (artikel)
-   [OpenRouter vs pelan kadar tetap untuk ejen AI: mana lebih murah?](https://broadrouter.com/ms/blog/openrouter-alternative-flat-rate/) (artikel)

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-glossary-openai-compatible-api&utm_content=page-cta) ·

**Sumber**

-   [Rujukan OpenAI API, create chat completion](https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/create)
-   [Anthropic, keserasian OpenAI SDK dan batasannya](https://platform.claude.com/docs/en/api/openai-sdk)
-   [OpenAI Python SDK (base\_url dan OPENAI\_BASE\_URL)](https://github.com/openai/openai-python)
-   [Rujukan API BroadNet Inference (Bahasa Inggeris)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ms-glossary-openai-compatible-api&utm_content=sources)
-   [OpenAI, Models (disemak 2026-11-15)](https://developers.openai.com/api/docs/models)
