Panduan
API kompatibel OpenAI: pindah dengan satu base URL
API kompatibel OpenAI menerima bentuk request dan response yang sama dengan API OpenAI untuk endpoint yang diimplementasikannya, sehingga SDK dan tool yang sudah Anda pakai tetap bekerja setelah base URL dan API key diganti.
Arahkan klien OpenAI yang sudah ada ke zcloud dan mulailah berhemat.
Diperbarui
Quickstart: tiga langkah
1. Buat API key
Masuk dengan Google lalu buka halaman API key di workspace Anda. Key diawali zr_ dan hanya ditampilkan sekali, jadi simpan di secret manager atau environment variable.
Buka API key →2. Arahkan klien ke zcloud
SDK resmi OpenAI membaca base URL dan key dari environment variable, sehingga sebagian besar proyek bisa pindah tanpa mengubah kode. SDK Anthropic memakai URL root tanpa /v1.
# Official OpenAI SDKs (Python and Node) read these variables
OPENAI_BASE_URL=https://api.zrouter.dev/v1
OPENAI_API_KEY=zr_your_key_here
# Official Anthropic SDKs use the root URL (no /v1)
ANTHROPIC_BASE_URL=https://api.zrouter.dev
ANTHROPIC_API_KEY=zr_your_key_here3. Kirim request
Gunakan nama publik model apa pun dari katalog live. Contoh ini memakai kimi-k3.1-pro; ganti dengan model yang Anda butuhkan.
curl https://api.zrouter.dev/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"kimi-k3.1-pro","messages":[{"role":"user","content":"Hello"}]}'Endpoint yang didukung
| Endpoint | Protokol | Kegunaan |
|---|---|---|
| POST /v1/chat/completions | OpenAI | Chat completions, streaming, tool calls |
| POST /v1/responses | OpenAI | Responses API dengan event stream response.* native |
| POST /v1/messages | Anthropic | Messages Anthropic, system prompt, tool use |
| GET /v1/models | OpenAI | Daftar nama model yang bisa dipanggil key Anda (butuh key) |
https://api.zrouter.dev
Apa yang berubah saat migrasi
- Base URL dan API key — satu-satunya perubahan wajib untuk kode SDK OpenAI.
- Nama model — pakai nama publik zcloud dari daftar model; nama yang tidak dikenal mengembalikan model_not_found.
- Billing — request memakai Token Plan model tersebut lebih dulu, lalu saldo PAYG; saldo kosong mengembalikan 402 insufficient_balance.
- Error — endpoint kompatibel OpenAI mengembalikan envelope error OpenAI, endpoint messages mengembalikan envelope Anthropic.
Selanjutnya: quickstart lengkap · konfigurasi SDK · kode error · harga per model
Apa artinya kompatibel OpenAI?
Artinya server mengimplementasikan protokol OpenAI untuk sejumlah endpoint — di zcloud: chat/completions dan responses, lengkap dengan streaming, tool calling, dan envelope error gaya OpenAI. Klien yang dibuat untuk endpoint itu berbicara dengannya seolah-olah OpenAI; endpoint yang tidak diimplementasikan (misalnya audio) tidak tersedia.
Mengapa kompatibilitas OpenAI penting
Protokol OpenAI adalah standar de facto. Seluruh ekosistem — LangChain, Vercel AI SDK, agen, plugin — dibangun di atasnya. API kompatibel OpenAI memungkinkan Anda mempertahankan ekosistem itu sambil beralih ke model yang lebih murah atau berbeda di baliknya.
Cara zcloud menghadirkannya
zcloud menjalankan gateway kompatibel OpenAI di depan seluruh katalognya (GPT, Claude, Gemini, dan lainnya) dan juga menambah endpoint messages yang kompatibel Anthropic. Satu API key, dua protokol, semuanya hingga ~95% di bawah harga resmi.
Pertanyaan yang sering diajukan
Bisakah saya memakai SDK OpenAI yang sudah ada?
Ya. Arahkan base URL ke gateway zcloud dan kode SDK OpenAI yang ada tetap bekerja.
Endpoint mana yang didukung?
POST /v1/chat/completions dan POST /v1/responses untuk kompatibilitas OpenAI, POST /v1/messages untuk kompatibilitas Anthropic, serta GET /v1/models untuk melihat nama model yang bisa dipanggil key Anda.
Apakah saya perlu key terpisah untuk tiap model?
Tidak. Satu API key zcloud bekerja untuk semua model dan kedua protokol.
Apakah ada tier gratis?
Tidak. Akses bersifat prabayar: Token Plan mulai $1 untuk satu model, dan saldo PAYG hanya dipotong sesuai token yang Anda pakai.