---
title: "Apa itu API kompatibel OpenAI? Cara kerjanya | BroadRouter"
description: "API kompatibel OpenAI menerima permintaan yang sama dengan OpenAI, jadi SDK cukup diganti base URL, kunci, dan modelnya. Apa yang sama, apa yang beda, dan kenapa."
url: https://broadrouter.com/id/glossary/openai-compatible-api/
lang: id
updated: 2026-11-15
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/glossary/openai-compatible-api/) (diperbarui 2026-11-15).

# API kompatibel OpenAI

Diperbarui 2026-11-15

API kompatibel OpenAI adalah API HTTP yang menerima format permintaan dan respons yang sama dengan API OpenAI, seperti POST /v1/chat/completions, sehingga SDK dan tool OpenAI bisa memakainya hanya dengan mengganti base URL, kunci API, dan nama model.

Disebut juga: API kompatibel OpenAI, kompatibel dengan OpenAI, endpoint kompatibel OpenAI, alternatif API OpenAI, OpenAI-compatible API, OpenAI API compatible, OpenAI-style API, OpenAI drop-in replacement

Format API OpenAI menjadi bahasa bersama tooling LLM. Kini banyak penyedia menerimanya, sehingga satu library client bisa berbicara dengan banyak backend.

## Cara kerjanya

API yang kompatibel meniru bagian API OpenAI yang diandalkan client:

-   path yang sama, seperti `/v1/chat/completions` dan `/v1/audio/transcriptions`;
-   format JSON yang sama: array `messages` sebagai input, `choices[0].message.content` sebagai output, dan blok `usage` berisi jumlah token;
-   [kunci API](https://broadrouter.com/id/glossary/api-key/) yang dikirim sebagai `Authorization: Bearer <key>`;
-   [streaming](https://broadrouter.com/id/glossary/streaming/) sebagai server-sent events ketika `stream` bernilai true.

Berpindah cukup dengan mengubah konfigurasi. Dengan Python SDK resmi:

```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)
```

Dibanding contoh OpenAI, hanya tiga nilai yang berubah: [base URL](https://broadrouter.com/id/glossary/base-url/), kunci, dan ID model.

## Kenapa ini penting

Kompatibilitas menurunkan biaya berpindah. SDK, framework agen, plugin IDE, dan [router](https://broadrouter.com/id/glossary/llm-router/) yang memakai format OpenAI langsung berfungsi tanpa kode baru. Anda bisa menguji penyedia kedua dalam hitungan menit dan tetap punya opsi untuk pindah.

Tetapi kompatibel tidak sama dengan identik. Lapisan kompatibilitas Anthropic sendiri, misalnya, mengabaikan `strict` pada tools dan membiarkan `prompt_tokens_details` kosong. Perbedaan yang umum:

-   parameter yang diabaikan atau ditolak;
-   cara [token penalaran](https://broadrouter.com/id/glossary/reasoning-tokens/) dihitung dalam `max_tokens`;
-   apakah usage dilaporkan di akhir stream;
-   rate limit dan kode error.

## Di BroadNet Inference

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

Ada dua perbedaan yang perlu diantisipasi: DeepSeek V4.1 Flash, GLM 5.3, dan Qwen3.8 27B bernalar sebelum menjawab, dan penalaran itu dihitung dalam `max_tokens`. Selain itu, kunci bayar sesuai pemakaian mengizinkan 30 permintaan per menit dan 4 permintaan sekaligus. [Checklist migrasi](https://broadrouter.com/id/blog/openai-compatible-api-migration-checklist/) membahas sisanya.

## Kesalahan umum

-   Tetap memakai nama model OpenAI seperti `gpt-6-astra` (model andalan OpenAI di halaman model-nya, diperiksa 2026-11-15). Gunakan ID model dari penyedia.
-   Menganggap sebuah parameter berfungsi hanya karena permintaannya berhasil. Sebagian penyedia mengabaikan field yang tidak dikenal tanpa pemberitahuan.

## Pertanyaan umum

### Apakah kompatibel OpenAI berarti semua fitur OpenAI berfungsi?

Tidak. Artinya format inti permintaan dan responsnya sama. Field tertentu bisa diabaikan atau ditolak. Lapisan kompatibilitas Anthropic, misalnya, mendokumentasikan field yang diabaikannya dan yang mengembalikan error 400. Baca daftar dari penyedia sebelum mengandalkan suatu parameter.

### Apakah saya perlu SDK lain?

Tidak. SDK OpenAI resmi menerima base URL kustom. Di Python isi base\_url, di Node isi baseURL, atau atur environment variable OPENAI\_BASE\_URL.

### Endpoint apa saja yang didukung BroadNet Inference?

POST /v1/chat/completions untuk chat dan POST /v1/audio/transcriptions untuk speech-to-text. GET /v1/models juga tersedia; dokumentasi BroadNet menyebutnya metadata katalog publik untuk pemantau eksternal, jadi ambil ID model untuk permintaan dari referensi API.

## Lihat juga

-   [Base URL](https://broadrouter.com/id/glossary/base-url/) (istilah)
-   [Kunci API (API key)](https://broadrouter.com/id/glossary/api-key/) (istilah)
-   [LLM router](https://broadrouter.com/id/glossary/llm-router/) (istilah)
-   [Streaming (respons streaming)](https://broadrouter.com/id/glossary/streaming/) (istilah)
-   [Penyedia inferensi (inference provider)](https://broadrouter.com/id/glossary/inference-provider/) (istilah)
-   [Server-sent events (SSE)](https://broadrouter.com/id/glossary/sse/) (istilah)
-   [Chat Completions API](https://broadrouter.com/id/glossary/chat-completions-api/) (istilah)
-   [Memakai OpenAI Python SDK dengan BroadNet Inference](https://broadrouter.com/id/guides/openai-python-sdk/) (panduan)
-   [Memakai OpenAI Node.js SDK dengan BroadNet Inference](https://broadrouter.com/id/guides/openai-node-sdk/) (panduan)
-   [Memakai LangChain dengan BroadNet Inference](https://broadrouter.com/id/guides/langchain-openai-base-url/) (panduan)
-   [Permintaan pertama ke BroadNet Inference dengan curl](https://broadrouter.com/id/guides/curl-quickstart/) (panduan)
-   [Pindah ke API kompatibel OpenAI: checklist migrasi](https://broadrouter.com/id/blog/openai-compatible-api-migration-checklist/) (artikel)
-   [OpenRouter vs paket harga tetap untuk AI agent: mana yang lebih murah?](https://broadrouter.com/id/blog/openrouter-alternative-flat-rate/) (artikel)

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

**Sumber**

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