Pengenalan
Pelajari bagaimana zrouter menyatukan berbagai model AI frontier di balik satu API key dengan antarmuka yang kompatibel OpenAI dan Anthropic.
Apa itu zrouter?#
zrouter (beroperasi di bawah platform zcloud) adalah gateway API reseller performa tinggi untuk model kecerdasan buatan frontier. Gateway ini merutekan request inferensi ke puluhan model unggulan melalui upstream provider sambil menyediakan penagihan terpadu, pencatatan token yang presisi, dan paritas protokol native.
Permukaan API dan base URL#
Semua request gateway dilayani dari satu base URL kanonikal. Cukup konfigurasikan base URL ini pada klien SDK resmi (seperti OpenAI Python/Node atau Anthropic Python/Node) tanpa mengubah logika inferensi utama Anda.
https://api.zrouter.devGateway menyediakan tiga endpoint inferensi utama:
- POST /v1/chat/completions — Protokol chat completions drop-in OpenAI lengkap dengan streaming (SSE) dan function calling.
- POST /v1/responses — Protokol modern OpenAI Responses API dengan skema event native.
- POST /v1/messages — Protokol drop-in Anthropic messages dengan dukungan penuh untuk system prompt, input gambar, dan pemanggilan tool.
Penagihan Token Plan & PAYG#
Setiap request diukur dan didebit melalui model pendanaan dua tingkat untuk kepastian biaya yang optimal. Jika ada Token Plan aktif yang mencakup model yang diminta, token dipotong dari alokasi prabayar tersebut terlebih dahulu. Setelah kuota Token Plan habis atau jika tidak ada paket untuk model tersebut, gateway secara otomatis beralih ke saldo kas PAYG (pay-as-you-go).
| Sumber Pendanaan | Prioritas | Model Harga | Satuan Penagihan |
|---|---|---|---|
| Token Plan | Utama (Ke-1) | Tier prabayar per model (lihat halaman harga) | Token diberikan per model |
| Saldo PAYG | Fallback (Ke-2) | Hingga 95% di bawah harga resmi (berbeda per model) | Micro-USD per token selesai |
Ringkasan autentikasi#
Otorisasikan request dengan mengirimkan key baik melalui header standar Authorization: Bearer zr_<public-id>_<secret> atau header x-api-key: zr_<public-id>_<secret>. Kedua header dapat dipertukarkan dan menerima token yang sama persis.
curl -X POST "https://api.zrouter.dev/v1/chat/completions" \
-H "Authorization: Bearer zr_<public-id>_<secret>" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.4",
"messages": [{"role": "user", "content": "Halo dunia!"}]
}'Glosarium#
| Istilah | Definisi |
|---|---|
| API key | Kredensial zr_<public-id>_<secret> yang dipakai untuk mengautentikasi request inferensi. |
| Token Plan | Paket prabayar yang terikat pada satu model dan memberikan alokasi token tetap; dipakai sebelum PAYG. |
| PAYG | Saldo kas pay-as-you-go yang ditagih dengan tarif reseller, dipakai saat tidak ada Token Plan yang mencakup model. |
Model public_name | Identifier model yang mudah dibaca dan Anda isi pada field model saat request. |
| Workspace | Area dashboard untuk mengelola key, saldo, pemakaian, dan ekspor. |
| Inference endpoint | Salah satu dari /v1/chat/completions, /v1/responses, atau /v1/messages. |
Cara kerja penagihan#
Setiap request diukur berdasarkan token yang dikonsumsi dan didebit secara real time. Anda mendanai akun dengan Token Plan untuk model tertentu atau dengan mengisi saldo PAYG — atau keduanya.
Saat request masuk, gateway mengecek dulu apakah ada Token Plan aktif yang mencakup model yang diminta lalu mendebitnya di sana. Ketika plan habis, atau tidak ada plan untuk model itu, biaya otomatis dialihkan ke saldo PAYG. Jika keduanya tidak dapat menutup request, request ditolak dengan 402 insufficient_balance sebelum pekerjaan upstream apa pun dijalankan.
Kedua sumber pendanaan menerima QRIS dan crypto (USDC/USDT di Solana). Definisi tier, aturan prioritas, dan detail pembayaran ada di Billing & Paket.
Apa yang bisa Anda bangun#
Karena gateway ini adalah pengganti drop-in untuk protokol OpenAI dan Anthropic, SDK, framework, dan agen yang sudah ada dapat berjalan di zrouter hanya dengan mengganti satu baris base URL. Tim memakai zrouter untuk:
- Produk chat yang melayani pelanggan dan butuh kualitas model frontier dengan harga reseller.
- Coding agent dan asisten pemakai tool di protokol Responses dan Messages.
- Routing multi-model dan perbandingan A/B di balik satu API key.
Langkah berikutnya#
Untuk mulai mengirim traffic produksi, buat API key di workspace Anda, tinjau daftar model yang didukung di katalog live kami, atau buka panduan mulai cepat untuk bahasa pemrograman pilihan Anda.