---
title: "Migrasi ke API kompatibel OpenAI: checklist lengkap | BroadRouter"
description: "Mengganti base_url itu bagian mudahnya. Yang sering rusak: ID model, token penalaran, usage saat streaming, error, rate limit, dan kunci API. Checklist dengan kode."
url: https://broadrouter.com/id/blog/openai-compatible-api-migration-checklist/
lang: id
updated: 2026-11-14
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/blog/openai-compatible-api-migration-checklist/) (diperbarui 2026-11-16).

# Pindah ke API kompatibel OpenAI: checklist migrasi

Oleh tim BroadNet Inference · 5 menit baca · Dipublikasikan 2026-11-14 · Diperbarui 2026-11-16

Untuk pindah ke API kompatibel OpenAI, ganti tiga pengaturan (base\_url, api\_key, dan model), lalu periksa apa yang berbeda: ID model, cara token penalaran dihitung ke max\_tokens, cara streaming melaporkan usage, error mana yang perlu di-retry, rate limit, dan keamanan kunci. Untuk BroadNet Inference, base URL-nya https://inference.broadnet.ai/v1.

## Poin penting

-   Tiga pengaturan berubah: `base_url`, `api_key`, dan `model`.
-   Inventarisasi setiap endpoint dan field yang dipakai aplikasi Anda sebelum pindah, lalu uji satu per satu.
-   Model penalaran menghitung proses berpikir ke `max_tokens`; batas kecil menghasilkan jawaban kosong.
-   Minta usage dalam stream dengan `stream_options`, atau pelacakan biaya Anda jadi buta.
-   Petakan kode error ke retry atau perbaiki sebelum memindahkan trafik produksi.
-   Jalankan penyedia lama dan baru berdampingan pada trafik nyata selama sehari sebelum beralih penuh.

**Di halaman ini**

1.  0\. Apa yang dipakai aplikasi Anda saat ini?
2.  1\. Tiga pengaturan apa yang berubah?
3.  2\. Apa ID model yang baru?
4.  3\. Kenapa jawaban kosong setelah pindah?
5.  4\. Apakah streaming masih melaporkan usage?
6.  5\. Error mana yang perlu di-retry?
7.  6\. Apa rate limit yang baru?
8.  7\. Apakah prompt Anda masih muat?
9.  8\. Bagaimana dengan kunci dan retensi data?
10.  9\. Bagaimana beralih dengan aman?
11.  Apa saja kesalahan migrasi yang umum?
12.  Posisi BroadNet Inference

Sebagian besar penyedia LLM kini memakai [format API OpenAI](https://broadrouter.com/id/glossary/openai-compatible-api/). Itu membuat pindah penyedia terlihat seperti perubahan satu baris, dan untuk mendapatkan jawaban pertama memang begitu. Untuk menjalankan trafik produksi, kerjakan daftar ini sampai tuntas. Setiap butir berasal dari cara nyata migrasi gagal.

## 0\. Apa yang dipakai aplikasi Anda saat ini?

Sebelum mengubah apa pun, catat apa saja yang menjadi ketergantungan aplikasi Anda. Cari setiap panggilan ke SDK di kode dan daftarkan. Jika Anda memanggil API Whisper OpenAI, perhatikan bahwa OpenAI mencantumkan `whisper-1` akan dihentikan pada 26 Februari 2027; [alternatif API Whisper](https://broadrouter.com/id/blog/whisper-api-alternative/) membahas sisi audionya.

| Fitur | Tempat mencari | Uji setelah pindah |
| --- | --- | --- |
| Chat completions | Setiap `chat.completions.create` | Prompt yang sama, bandingkan jawaban |
| Streaming | `stream=True` | Chunk masuk, diakhiri `[DONE]`, usage ada |
| Tool calling | `tools=` | Tool call ter-parse dan berjalan |
| Output terstruktur | `response_format=` | JSON lolos validasi skema Anda |
| Gambar | Bagian gambar dalam pesan | Model menerimanya |
| Transkripsi audio | `audio.transcriptions` | Teks dan bahasa benar |
| Embeddings, file, batch | Endpoint lain | Pastikan penyedia memang menawarkannya |

Baris terakhir itu penting. “Kompatibel OpenAI” biasanya mencakup chat completions lebih dulu. Katalog BroadNet Inference mencantumkan model chat di `/v1/chat/completions` dan model speech-to-text di `/v1/audio/transcriptions`; jika Anda memakai endpoint lain, biarkan di penyedia Anda saat ini atau cari penggantinya.

## 1\. Tiga pengaturan apa yang berubah?

```python
from openai import OpenAI
import os

client = OpenAI(
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
)
```

Nama pengaturan [base URL](https://broadrouter.com/id/glossary/base-url/) berbeda per library: `base_url` di Python SDK dan ChatOpenAI dari LangChain, `baseURL` di Node.js SDK. Menurut [README](https://github.com/openai/openai-python)\-nya, Python SDK juga membaca environment variable `OPENAI_BASE_URL`. Periksa apakah ada nilai lama di environment Anda, karena jika ada, permintaan bisa terkirim ke penyedia lama tanpa error.

Simpan [kunci API](https://broadrouter.com/id/glossary/api-key/) di environment variable atau secret manager, jangan pernah di kode. Pengaturan untuk tiap SDK: [Python](https://broadrouter.com/id/guides/openai-python-sdk/), [Node.js](https://broadrouter.com/id/guides/openai-node-sdk/), [LangChain](https://broadrouter.com/id/guides/langchain-openai-base-url/). Untuk menyusun dan menguji permintaan pertama secara manual, pakai [API request builder](https://broadrouter.com/tools/api-request-builder/). Untuk menerapkan perubahan base URL, kunci, dan model ke kode yang sudah ada, tempelkan kodenya ke [alat bantu migrasi OpenAI ke BroadNet](https://broadrouter.com/tools/openai-to-broadnet-migration/), yang juga mendaftar apa saja yang perlu dicek.

## 2\. Apa ID model yang baru?

Setiap penyedia menamai model dengan caranya sendiri. Di BroadNet Inference:

| Model | ID |
| --- | --- |
| DeepSeek V4.1 Flash | `broadnet/deepseek-v4.1-flash` |
| GLM 5.3 | `broadnet/glm-5.3` |
| Qwen3.8 27B | `broadnet/qwen3.8-27b` |
| Gemma 4 VL 26B | `broadnet/gemma-4-26b-a4b` |

Taruh ID model di konfigurasi, bukan di kode, supaya penggantian berikutnya cukup dengan deploy, bukan menulis ulang. Batas dan harga tiap model ada di halamannya: [DeepSeek V4.1 Flash](https://broadrouter.com/id/models/deepseek-v4.1-flash/), [GLM 5.3](https://broadrouter.com/id/models/glm-5.3/), [Qwen3.8 27B](https://broadrouter.com/id/models/qwen3.8-27b/), dan [Gemma 4 VL 26B](https://broadrouter.com/id/models/gemma-4-vl-26b/).

## 3\. Kenapa jawaban kosong setelah pindah?

Ini kejutan yang paling umum. DeepSeek V4.1 Flash, GLM 5.3, dan Qwen3.8 27B bernalar sebelum menjawab, dan **[token penalaran](https://broadrouter.com/id/glossary/reasoning-tokens/) dihitung ke [`max_tokens`](https://broadrouter.com/id/glossary/max-tokens/)**. Batas 256 yang dulu cukup di model non-penalaran bisa habis seluruhnya untuk berpikir, sehingga jawabannya kosong. Sisakan 1.000 token atau lebih, atau set `reasoning_effort` ke `low` untuk tugas sederhana. [Penjelasan lengkap](https://broadrouter.com/id/guides/reasoning-tokens-empty-response/).

## 4\. Apakah streaming masih melaporkan usage?

[Streaming](https://broadrouter.com/id/glossary/streaming/) memakai Server-Sent Events dan diakhiri `data: [DONE]`. Usage token muncul di chunk terakhir hanya jika Anda memintanya:

```python
stream = client.chat.completions.create(
    model="broadnet/deepseek-v4.1-flash", messages=messages,
    stream=True, stream_options={"include_usage": True},
)
```

Tanpa itu, dashboard biaya Anda menunjukkan nol. Jika stream berakhir sebelum `[DONE]`, anggap tidak lengkap. [Panduan streaming](https://broadrouter.com/id/guides/streaming-chat-completions/).

## 5\. Error mana yang perlu di-retry?

| Status | Arti | Tindakan |
| --- | --- | --- |
| 401 | Kunci salah atau dicabut, atau jatah bayar sesuai pemakaian habis | Perbaiki, jangan retry |
| 402 | Saldo atau anggaran | Top up, jangan retry |
| 403 | Ditolak oleh kebijakan model, rute, atau IP | Perbaiki ketidakcocokannya |
| 413 | Permintaan terlalu besar | Perkecil, jangan retry |
| 429 | Batas laju, konkurensi, atau pengeluaran | Backoff lalu retry |
| 5xx | Sisi server | Retry dengan backoff yang dibatasi |

Python SDK resmi sudah me-retry sebagian error: README-nya menyebut error koneksi, 408, 409, 429, dan respons 5xx di-retry dua kali secara default dengan exponential backoff singkat. Set `max_retries` secara eksplisit supaya perilakunya merupakan keputusan, bukan sekadar default. Catat request ID dari setiap respons agar tim dukungan bisa menelusuri masalah. [Semua kode](https://broadrouter.com/id/guides/errors-and-retries/).

## 6\. Apa rate limit yang baru?

Ketahui batas baru sebelum trafik datang. Kunci bayar sesuai pemakaian di BroadNet mengizinkan 30 permintaan per menit dan 4 permintaan berjalan sekaligus. Paket unlimited menjalankan satu permintaan dalam satu waktu per sesi. Sesuaikan ukuran worker pool Anda, atau Anda akan melihat 429 di hari pertama; [kalkulator rate limit](https://broadrouter.com/tools/llm-rate-limit-calculator/) membantu menghitungnya. [Menyesuaikan kapasitas untuk agen paralel](https://broadrouter.com/id/blog/run-parallel-coding-agents-flat-rate/).

## 7\. Apakah prompt Anda masih muat?

Periksa context window: 1.048.576 token di DeepSeek V4.1 Flash dan GLM 5.3, 262.144 di Qwen3.8 27B, 32.768 di Gemma 4 VL 26B. Prompt yang muat di model lama belum tentu muat di jendela yang lebih kecil; cek dengan [kalkulator context window](https://broadrouter.com/tools/context-window-calculator/). Letakkan konten prompt yang stabil di depan agar mendapat [harga input cache](https://broadrouter.com/id/blog/cached-input-tokens-explained/).

## 8\. Bagaimana dengan kunci dan retensi data?

Batasi kunci produksi hanya untuk IP server Anda dengan [IP allow-list](https://broadrouter.com/id/guides/api-keys-ip-allow-lists/). Tanyakan kepada penyedia baru apa yang mereka simpan; lihat [checklist ZDR](https://broadrouter.com/id/blog/zero-data-retention-llm-api-checklist/).

## 9\. Bagaimana beralih dengan aman?

1.  Kirim salinan permintaan nyata selama sehari ke kedua penyedia.
2.  Bandingkan jawaban pada sampel, ditambah latensi, error, dan biaya per permintaan.
3.  Pindahkan 10% trafik, pantau selama sehari, lalu pindahkan sisanya.
4.  Biarkan penyedia lama tetap terkonfigurasi sebagai fallback selama seminggu.

Jika Anda menjalankan banyak layanan, proxy seperti [LiteLLM](https://broadrouter.com/id/guides/litellm-proxy-custom-provider/) memungkinkan Anda mengganti penyedia di satu tempat, bukan di setiap aplikasi.

## Apa saja kesalahan migrasi yang umum?

-   **`/v1` tidak ada di base URL.** Permintaan mengembalikan 404. Pakai URL lengkap.
-   **Nama model lama di konfigurasi.** Penyedia baru tidak mengenalinya.
-   **Field khusus penyedia tertinggal di permintaan.** Field yang hanya dipahami penyedia lama bisa ditolak atau diabaikan. Hapus dari client generik.
-   **Hanya menguji satu prompt.** Jalankan inventaris dari langkah 0, fitur demi fitur.
-   **Beralih di hari Jumat.** Sisakan waktu untuk memantau trafik nyata selama satu hari penuh.

## Posisi BroadNet Inference

BroadNet Inference adalah target pengganti langsung (drop-in) bagi aplikasi yang memakai chat completions dan transkripsi audio lewat SDK OpenAI: ganti tiga pengaturan lalu kerjakan daftar di atas. Katalognya hanya mencantumkan model chat dan speech-to-text, jadi jika Anda bergantung pada endpoint lain seperti embeddings atau penyimpanan file, biarkan itu di penyedia lain. Akun baru dimulai dengan kredit $5. Dari model chat, hanya Gemma 4 VL 26B yang bisa dipakai dengan kredit ini (kredit ini juga mencakup kedua model Transcribe), jadi uji bayangan (shadow test) pada DeepSeek, GLM, atau Qwen perlu isi ulang saldo.

Alat gratis untuk topik ini (bahasa Inggris)

-   [OpenAI to BroadNet migration helper](https://broadrouter.com/tools/openai-to-broadnet-migration/) Paste OpenAI SDK code; get base URL, key and model edits, a diff and the checks that remain.
-   [max\_tokens calculator for reasoning models](https://broadrouter.com/tools/reasoning-token-budget/) Answer length + reasoning budget + margin = a max\_tokens that does not cut the answer off.
-   [JSON schema generator for LLM structured output](https://broadrouter.com/tools/json-schema-generator/) Sample JSON to strict schema, Pydantic, Zod and a ready request.
-   [LLM JSON output validator](https://broadrouter.com/tools/llm-json-output-validator/) Parse errors by line and column, safe repairs, cut-off detection and JSON Schema checks for model output.

[Alat gratis (bahasa Inggris)](https://broadrouter.com/tools/)

## Istilah dalam artikel ini

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

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

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

[Embeddings (vektor embedding)](https://broadrouter.com/id/glossary/embeddings/)

Embeddings adalah daftar angka floating-point (vektor) yang dihasilkan model untuk merepresentasikan sepotong teks, gambar, atau input lain. Input dengan makna serupa mendapat vektor yang berdekatan, sehingga jarak antarvektor bisa dipakai untuk mengurutkan hasil pencarian, mengelompokkan dokumen, atau menemukan item terkait.

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

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

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

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

## Pertanyaan umum

### Apakah saya perlu SDK yang berbeda?

Tidak. SDK OpenAI resmi untuk Python dan Node.js menerima base URL kustom. Framework yang dibangun di atasnya, seperti ChatOpenAI dari LangChain, juga menerimanya.

### Bagaimana cara mengganti base URL di SDK OpenAI?

Berikan base\_url ke client di Python atau baseURL di Node.js, atau set environment variable OPENAI\_BASE\_URL. Untuk BroadNet Inference nilainya https://inference.broadnet.ai/v1, dan kuncinya diisi di api\_key.

### Kenapa saya mendapat respons kosong setelah pindah?

Model penalaran seperti DeepSeek V4.1 Flash, GLM 5.3, dan Qwen3.8 27B berpikir dulu sebelum menjawab, dan proses berpikir itu dihitung ke max\_tokens. Naikkan max\_tokens ke 1.000 atau lebih, atau set reasoning\_effort ke low.

### Kenapa muncul error 404 atau model not found setelah pindah?

Biasanya ID model masih memakai nama dari penyedia lama, atau base URL tidak menyertakan path /v1. Pakai ID model persis dari penyedia baru dan base URL lengkap.

### Error mana yang perlu saya retry?

Retry 429 dan 5xx dengan exponential backoff yang dibatasi. Perbaiki 401, 402, dan 413 sebelum mencoba lagi. Panduan error di situs ini mencantumkan setiap kode.

### Apakah kompatibel OpenAI berarti identik?

Tidak. Bentuk request dan respons sama, tetapi ID model, parameter yang didukung, batas, field usage, dan detail error bisa berbeda. Uji setiap fitur yang dipakai aplikasi Anda.

## Baca juga

-   [Base URL API kompatibel OpenAI: 14 penyedia, sudah dicek](https://broadrouter.com/id/blog/openai-compatible-api-base-urls/)
-   [OpenRouter vs paket harga tetap untuk AI agent: mana yang lebih murah?](https://broadrouter.com/id/blog/openrouter-alternative-flat-rate/)
-   [Kapan context window 1M token sepadan (dan kapan tidak)](https://broadrouter.com/id/blog/million-token-context-window-guide/)
-   [API LLM zero data retention: checklist 10 pertanyaan](https://broadrouter.com/id/blog/zero-data-retention-llm-api-checklist/)
-   [Hardware GPU dan pendekatan serving BroadNet, menurut BroadNet](https://broadrouter.com/id/blog/broadnet-gpu-fleet-and-serving/)
-   [Cache respons API LLM untuk memangkas biaya: exact cache di Python](https://broadrouter.com/id/blog/cache-llm-responses-cut-cost/)
-   [Panduan: 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: Kode error BroadNet Inference dan kapan harus mencoba ulang](https://broadrouter.com/id/guides/errors-and-retries/)
-   [Panduan: Streaming chat completions dan menangani koneksi terputus](https://broadrouter.com/id/guides/streaming-chat-completions/)
-   [Panduan: Kenapa model reasoning mengembalikan jawaban kosong](https://broadrouter.com/id/guides/reasoning-tokens-empty-response/)
-   [Panduan: Mengarahkan LiteLLM ke BroadNet Inference (SDK dan proxy)](https://broadrouter.com/id/guides/litellm-proxy-custom-provider/)

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

**Sumber**

-   [Referensi API BroadNet Inference (bahasa Inggris)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=id-blog-openai-compatible-api-migration-checklist&utm_content=sources)
-   [README OpenAI Python SDK (base\_url, OPENAI\_BASE\_URL, retry; dicek 2026-11-14)](https://github.com/openai/openai-python)
