Apa itu API yang kompatibel dengan OpenAI? Cara beralih penyedia dengan satu baris

Beralih dengan satu baris

Secara default, SDK OpenAI mengirim permintaan ke OpenAI, tetapi Anda bisa menentukan URL dasar. Arahkan ke penyedia lain, lalu gunakan kunci API dan nama model penyedia tersebut; kode lainnya tetap sama.

from openai import OpenAI
client = OpenAI(
    base_url="https://api.zurelay.com/v1",  # the only line that changes
    api_key="YOUR_ZURELAY_KEY",
)
reply = client.chat.completions.create(
    model="claude-sonnet-5-5",
    messages=[{"role": "user", "content": "Hello"}],
)
print(reply.choices[0].message.content)

Cara yang sama berlaku di TypeScript dengan baseURL, serta di alat yang meminta "OpenAI base URL" atau "custom endpoint": OpenCode, Continue, Cline, Open WebUI, dan banyak lagi. Panduan integrasi memuat pengaturan masing-masing alat. Banyak alat juga membaca variabel lingkungan OPENAI_BASE_URL dan OPENAI_API_KEY, jadi Anda bisa beralih tanpa mengubah kode sama sekali.

URL dasar penyedia utama

URL dasar biasanya diakhiri dengan /v1, lalu SDK menambahkan /chat/completions. Beberapa penyedia menggunakan jalur lain, jadi salin persis seperti yang tercantum:

URL setiap penyedia, beserta ID model dan fungsi setiap endpoint, tersedia di daftar URL dasar yang kompatibel dengan OpenAI, yang diambil dari dokumentasi masing-masing penyedia pada 26 Oktober 2026.

Yang tetap berfungsi

• Pesan, prompt sistem, dan streaming.
• Pemanggilan alat dan output terstruktur dengan skema JSON.
• Gambar dan file lain dalam pesan, untuk model yang dapat membacanya.
• Blok data penggunaan, sehingga perhitungan token tetap berjalan dengan cara yang sama.

Yang perlu diperiksa sebelum beralih

• Nama model. Setiap penyedia memiliki ID sendiri; lihat daftarnya dengan GET /v1/models.
• API yang didukung. Banyak penyedia mendukung Chat Completions, tetapi tidak mendukung API Responses, Realtime, embeddings, atau batch dari OpenAI. Zurelay mendukung Chat Completions, gambar, video, dan suara, serta Messages API dari Anthropic untuk Claude.
• Parameter tambahan. Tingkat penalaran, kontrol cache, dan batas sampling berbeda untuk tiap model. Penyedia yang baik mendokumentasikan parameter yang didukung setiap model.
• Apakah modelnya sesuai klaim? Penyedia murah terkadang menyajikan model lama atau lebih murah dengan nama model yang lebih baru. Lima cara cepat untuk memeriksanya ada di apa yang sebenarnya dijual oleh API AI murah.

Saat peralihan gagal

• 404 Not Found. URL dasar menyertakan endpoint (.../v1/chat/completions) atau tidak menyertakan jalur khusus penyedia. Gunakan URL dasar saja.
• 401 Unauthorized. Kunci berasal dari penyedia lain atau, pada Model Studio dari Alibaba, dari wilayah lain.
• Model not found. ID untuk model yang sama berbeda antarpenyedia: claude-opus-5-5 di Anthropic, anthropic/claude-opus-5 di OpenRouter, dan nama deployment Anda di Azure.
• Error 400 pada parameter. Beberapa penyedia menolak atau mengabaikan parameter yang didukung API OpenAI, seperti response_format pada lapisan kompatibilitas Anthropic. Hapus parameter tersebut, atau beralihlah ke penyedia yang mendukungnya.

API yang kompatibel dengan Anthropic

Claude Code dan SDK Anthropic menggunakan Messages API dari Anthropic, bukan API OpenAI, dan membaca ANTHROPIC_BASE_URL. Beberapa penyedia juga mendukung API tersebut, termasuk DeepSeek, Moonshot, Z.ai, MiniMax, dan Zurelay; URL mereka tidak pernah diakhiri dengan /v1. Penyedia tersebut tercantum dalam daftar ini, dan harga Claude Code membandingkan biaya Claude Code di setiap paket dan melalui API.

Mengapa perlu beralih

Satu kunci yang kompatibel dengan OpenAI dapat mengakses model dari berbagai lab. Jadi, untuk membandingkan Claude, GPT, Gemini, dan DeepSeek dengan prompt Anda sendiri, cukup ganti nama model. Begitu juga saat beralih ke model yang lebih murah. Lihat model dan harga.