AdellRoute Docs
Satu API key untuk puluhan model AI. Semua yang kamu butuhkan untuk mulai memakai AdellRoute, dalam satu halaman.
Pengenalan AdellRoute
AdellRoute adalah AI gateway. Satu API key untuk puluhan model AI dengan format kompatibel OpenAI dan Anthropic. Mulai di sini.
AdellRoute adalah gateway AI. Satu API key untuk puluhan model AI (GPT, Claude, Gemini, DeepSeek, GLM, Qwen, Kimi, dan lainnya), dengan format yang kompatibel dengan OpenAI dan Anthropic.
Panduan ini untuk siapa?
| Kamu adalah... | Mulai dari |
|---|---|
| Developer pengguna API | Quickstart dan Integrasi |
| Pengguna Claude Code | Integrasi Claude Code |
Yang didapat
- Bayar per token. Saldo dalam USD, dipotong sesuai token input, output, dan cache yang benar-benar dipakai.
- Top-up dalam Rupiah lewat QRIS, virtual account, atau e-wallet, saldo langsung masuk.
- Satu endpoint, banyak format: OpenAI Chat Completions, OpenAI Responses, Anthropic Messages, Embeddings.
- Kontrol per API key: batas kredit, reset harian/mingguan/bulanan, model yang diizinkan, allow-list IP, rate limit.
- Privasi: prompt dan jawaban tidak pernah disimpan, hanya metadata request (model, token, biaya, waktu).
Base URL
Semua contoh di panduan ini menggunakan:
Code
Variabel kunci: ADELLROUTE_API_KEY. Placeholder kunci: sk-....
Endpoint yang didukung
| Endpoint | Format |
|---|---|
POST /v1/chat/completions | OpenAI Chat Completions |
POST /v1/responses | OpenAI Responses |
POST /v1/messages | Anthropic Messages (Claude Code, Anthropic SDK) |
POST /v1/messages/count_tokens | Anthropic, estimasi token (gratis) |
POST /v1/embeddings | OpenAI Embeddings |
POST /v1/decisions, POST /v1/systemone | Keputusan model (mis. jev) |
GET /v1/models | Daftar model aktif beserta harga |
Mulai dari mana?
- Baru pertama kali? Ikuti Quickstart.
- Pakai Claude Code? Lihat Integrasi Claude Code.
Quickstart
Lima langkah mulai memakai AdellRoute: daftar akun, isi saldo, buat API key, kirim request pertama, dan cek pemakaian.
-
Daftar akun
Buka dashboard AdellRoute, daftar dengan email atau Google, lalu verifikasi email (kode 6 digit atau klik link di email).
-
Isi saldo
Buka menu Billing, masukkan nominal Rupiah, lalu bayar di halaman pembayaran yang terbuka (QRIS, e-wallet, atau m-banking). Saldo masuk otomatis setelah pembayaran terkonfirmasi. Punya kode kupon? Redeem di halaman yang sama.
-
Buat API key
Menu API Keys → Buat key. Key berbentuk
sk-...dan hanya ditampilkan sekali. Simpan baik-baik. Kamu bisa langsung memberi batas kredit atau membatasi model. -
Kirim request pertama
CodeAtau dengan Python:
CodeNama model persis seperti di halaman Models atau dari
GET /v1/models. Lanjut ke OpenAI SDK atau Anthropic SDK. -
Cek pemakaian
Menu Usage menampilkan setiap request: model, token, biaya, TTFT, dan kecepatan. Prompt dan jawaban tidak disimpan.
API Keys
Kelola API key AdellRoute: batas kredit, model yang diizinkan, allow-list IP, rate limit, dan cara buat atau cabut key.
Buat key di menu API Keys di dashboard. Setiap key bisa diberi aturan sendiri:
| Pengaturan | Fungsi |
|---|---|
| Batas kredit | Maksimum pengeluaran key ini (USD). Request ditolak 402 jika terlewati. |
| Periode reset | daily, weekly, atau monthly: batas kredit di-reset tiap periode. Kosong = batas seumur key. |
| Model yang diizinkan | Key hanya bisa memakai model di daftar ini. Kosong = semua model. |
| Kedaluwarsa | Key otomatis mati setelah tanggal tertentu. |
| Allow-list IP | Hanya IP/CIDR tertentu (mis. 203.0.113.10, 10.0.0.0/8). |
| Request per menit | Rate limit khusus key ini. |
| Request paralel | Jumlah request yang boleh berjalan bersamaan. |
| Sensor secret | Menyamarkan secret (API key, token, password) yang tidak sengaja ada di prompt sebelum dikirim ke model. |
Regenerate & revoke
- Regenerate: membuat secret baru untuk key yang sama (aturan dan riwayat tetap). Secret lama langsung tidak berlaku.
- Revoke: mematikan key secara permanen.
Contoh: key untuk satu aplikasi dengan budget harian $5
Di dashboard, buka API Keys → Buat key, lalu isi:
- Nama:
chatbot-production - Batas kredit:
5USD dengan periode resetdaily - Model yang diizinkan:
gpt-5-mini,claude-haiku-4-5 - Request per menit:
60
Key sk-... hanya ditampilkan sekali saat dibuat — simpan baik-baik.
Authentication
Kirim API key AdellRoute lewat header Authorization, x-api-key, atau api-key. Format OpenAI dan Anthropic.
Semua endpoint /v1/* memakai API key sk-.... Kirim lewat salah satu header berikut, sesuai kebiasaan SDK yang kamu pakai:
| Header | Dipakai oleh |
|---|---|
Authorization: Bearer sk-... | OpenAI SDK, kebanyakan tool |
x-api-key: sk-... | Anthropic SDK, Claude Code |
api-key: sk-... | Klien gaya Azure OpenAI |
Code
Tips keamanan
- Jangan taruh API key di kode frontend, browser, atau aplikasi mobile. Panggil AdellRoute dari server kamu.
- Buat key terpisah per aplikasi atau lingkungan, supaya bisa dicabut sendiri-sendiri.
- Pakai kontrol per key: batas kredit, allow-list IP, dan kedaluwarsa.
- Key yang bocor: buka API Keys → Regenerate (key lama langsung mati) atau Revoke.
AdellRoute hanya menyimpan hash key, jadi key yang hilang tidak bisa ditampilkan lagi. Buat yang baru.
API key sk-... hanya untuk endpoint AI (/v1/*), terpisah dari login dashboard.
Billing
Saldo USD, top-up dalam Rupiah via QRIS, virtual account, atau e-wallet, kupon, dan saldo habis.
Top-up
- Dashboard → Billing → isi nominal Rupiah (ada batas minimum dan maksimum).
- Bayar di halaman pembayaran yang terbuka. Metodenya tergantung gateway: QRIS, virtual account, atau e-wallet.
- Saldo masuk otomatis setelah pembayaran dikonfirmasi. Kurs Rupiah ke USD ditampilkan sebelum bayar.
Riwayat top-up (pending, completed, expired, failed) ada di halaman yang sama. Top-up yang belum dibayar bisa dibatalkan, dan otomatis kedaluwarsa setelah 24 jam. Kalau ternyata sudah terlanjur bayar, saldo tetap masuk.
Kupon
Punya kode voucher? Masukkan di Billing → Redeem. Setiap kupon hanya bisa dipakai sekali per akun.
Program referral
Jika diaktifkan, kamu dapat link referral di menu Affiliate:
- Kamu dapat komisi (persentase dari top-up berbayar orang yang kamu ajak) sebagai kredit, selama periode tertentu.
- Teman yang daftar lewat link kamu dapat bonus di top-up pertamanya.
Kupon dan kredit dari admin tidak dihitung untuk komisi.
Saldo habis
Saat saldo (atau batas kredit key) tidak cukup, API mengembalikan 402 dengan "type": "insufficient_credits". Saldo dikunci (reservasi) sebelum request jalan, jadi request paralel tidak bisa membuat saldo minus.
Kamu juga bisa mengatur notifikasi saldo rendah lewat email di Settings (default di bawah $1).
Error
Format error AdellRoute: kode HTTP + tipe error OpenAI dan Anthropic, lalu cara retry yang benar.
Error memakai format OpenAI supaya SDK bisa membacanya:
Code
Di /v1/messages (Anthropic), error memakai format Anthropic ({"type": "error", "error": {"type": "...", "message": "..."}}) supaya Claude Code dan Anthropic SDK menampilkan pesan yang benar.
| Status | type | Arti & solusi |
|---|---|---|
| 400 | invalid_request_error | Body tidak valid, model tidak dikenal/nonaktif, atau model dipakai di endpoint yang salah (mis. model embedding di chat). |
| 401 | authentication_error | API key salah, dicabut, kedaluwarsa, atau akun ditangguhkan. |
| 402 | insufficient_credits | Saldo habis atau batas kredit key tercapai. Top-up atau naikkan batas. |
| 403 | permission_error | IP tidak ada di allow-list key, atau model tidak diizinkan untuk key ini. |
| 404 | not_found_error | Resource tidak ada. |
| 429 | rate_limit_error | Terlalu banyak request (per menit atau paralel). Respons menyertakan header Retry-After (detik); tunggu selama itu lalu coba lagi. |
| 502 | provider_error | Provider model sedang bermasalah. Coba lagi atau pakai model lain. |
| 500 | internal_error | Kesalahan di sisi AdellRoute. |
Rekomendasi: retry otomatis dengan exponential backoff untuk 429 dan 5xx; jangan retry 400, 401, 402, 403.
Model dan Harga
Daftar model AdellRoute, cara biaya per 1 juta token, prompt caching, dan harga off-peak. Nilai harga TBD — harga final menyusul.
Daftar model
Code
Respons mengikuti format OpenAI ({"object": "list", "data": [...]}) ditambah info tambahan per model seperti mode (chat, embedding, decision), supports_vision, supports_reasoning, dan harga. Jika request membawa header anthropic-version, daftar dikembalikan dalam format Anthropic.
Halaman Models di dashboard menampilkan hal yang sama, plus contoh kode per model.
Cara biaya dihitung
Setiap model punya harga per 1 juta token untuk:
| Komponen | Keterangan |
|---|---|
| Input | Token prompt yang tidak kena cache |
| Output | Token yang dihasilkan model (termasuk reasoning) |
| Cache read | Token prompt yang diambil dari prompt cache, biasanya jauh lebih murah |
| Cache write | Untuk model yang menagih penulisan cache (mis. Claude) |
Code
Biaya persis setiap request terlihat di halaman Usage pada dashboard.
Harga (TBD)
| Komponen | Biaya per 1 juta token |
|---|---|
| Input | TBD |
| Output | TBD |
| Cache read | TBD |
| Cache write | TBD |
Nilai di atas belum final. Harga final menyusul saat API live; lihat daftar aktual lewat GET /v1/models atau halaman Models di dashboard.
Harga off-peak
Sebagian model lebih murah di jam off-peak. Jamnya bisa berbeda per model; defaultnya mengikuti DeepSeek: Senin–Jumat 00:00–01:00, 04:00–06:00 dan 10:00–24:00 UTC, serta seharian di akhir pekan. Halaman Models menampilkan kedua harga, dan GET /v1/models menyertakan pricing_offpeak (harga dan windows) untuk model tersebut. Harga yang dipakai ditentukan saat request dimulai; detail request di Usage menandai request yang ditagih dengan tarif off-peak.
Label diskon
AdellRoute bisa memberi label diskon (mis. -50%) pada harga input, output, atau cache read. Label ini hanya penanda di halaman Models; yang ditagih tetap harga yang tertera.
Satuan uang di API
Biaya per request dilaporkan di usage.cost sebagai angka desimal USD (mis. 0.0021). Harga model di GET /v1/models juga dalam USD per token. Saldo dan riwayat top-up di dashboard ditampilkan dalam USD; top-up sendiri dibayar dalam Rupiah.
Prompt caching
Provider seperti OpenAI, Anthropic, Gemini, dan DeepSeek otomatis meng-cache awalan prompt yang sama. Supaya hemat:
- Taruh bagian yang tidak berubah (system prompt, berkas, definisi tool) di awal.
- Taruh bagian yang berubah (pertanyaan user) di akhir.
Cache dipisah per akun, jadi prompt kamu tidak pernah "bocor" lewat cache ke pengguna lain.
Reasoning / thinking
Model yang mendukung reasoning menerima reasoning_effort (low, medium, high) di Chat Completions, reasoning di Responses, atau thinking di Anthropic Messages. Token reasoning ditagih sebagai output.
Streaming
Kirim request SSE (Server-Sent Events) ke AdellRoute, contoh curl, Python, dan Node.
Set "stream": true. Respons dikirim sebagai Server-Sent Events (SSE), persis seperti OpenAI / Anthropic, jadi semua SDK langsung bisa dipakai.
Code
Code
Catatan:
- AdellRoute otomatis meminta
usagedi akhir stream supaya biaya bisa dihitung; chunk terakhir berisi jumlah token. - Jika koneksi terputus di tengah jalan, token yang sudah dihasilkan tetap ditagih.
- Di belakang reverse proxy sendiri, matikan buffering (AdellRoute sudah mengirim
X-Accel-Buffering: no).
FAQ
Pertanyaan umum tentang AdellRoute: platform, format API, top-up, privasi prompt, API key, model, error, dan kontak.
Apa itu AdellRoute?
AdellRoute adalah gateway AI. Satu API key untuk puluhan model AI (GPT, Claude, Gemini, DeepSeek, GLM, Qwen, Kimi, dan lainnya), dengan format yang kompatibel dengan OpenAI dan Anthropic. Kamu bayar per token yang benar-benar dipakai, dengan saldo prabayar dalam USD.
Format API apa saja yang didukung?
OpenAI Chat Completions (/v1/chat/completions), OpenAI Responses (/v1/responses), OpenAI Embeddings (/v1/embeddings), Anthropic Messages (/v1/messages), serta model keputusan (mis. jev). Daftar lengkap endpoint ada di Pengenalan.
Bagaimana cara top-up saldo?
Buka menu Billing di dashboard, isi nominal Rupiah, lalu bayar melalui QRIS, virtual account, atau e-wallet. Saldo masuk otomatis setelah pembayaran dikonfirmasi. Lihat Billing.
Apakah prompt saya disimpan?
Tidak. Prompt dan jawaban tidak pernah disimpan. AdellRoute hanya menyimpan metadata request: model, token, biaya, dan waktu.
Bagaimana cara mendapatkan API key?
Setelah daftar dan isi saldo, buka menu API Keys di dashboard dan klik Buat key. Key berbentuk sk-… dan hanya ditampilkan sekali, simpan baik-baik. Lihat API Keys.
Model apa saja yang tersedia?
Lihat halaman Models di dashboard atau panggil GET /v1/models. Harga dan daftar model ada di Model & Harga.
Saya dapat error 401/402/429, apa yang harus dilakukan?
401— API key salah, dicabut, atau kedaluwarsa.402— saldo habis atau batas kredit key tercapai.429— terlalu banyak request; tunggu headerRetry-Afterlalu coba lagi.
Tabel lengkap ada di Error.
Apakah saya bisa memakai Claude Code?
Bisa. Atur ANTHROPIC_BASE_URL ke https://api.adellroute.work dan ANTHROPIC_AUTH_TOKEN ke key sk-…. Lihat Integrasi Claude Code.
Di mana saya bisa menghubungi dukungan?
Buka AdellRoute atau dashboard untuk informasi kontak dan dukungan.
Changelog
Catatan rilis dokumentasi dan API AdellRoute.
2026-11-21 — Rilis perdana dokumentasi AdellRoute
Rilis perdana portal dokumentasi AdellRoute di https://docs.adellroute.work. Cakupan:
- Mulai: Pengenalan, Quickstart (5 langkah).
- Panduan: API Keys, Authentication, Billing, Error, Model & Harga, Streaming.
- Integrasi: OpenAI SDK, Anthropic SDK, Claude Code, Tool Lain.
- Lainnya: FAQ, Changelog.
Semua contoh memakai base URL https://api.adellroute.work/v1 dengan API key sk-… dan env ADELLROUTE_API_KEY.
API
Rilis API gateway menyusul. Entri changelog API akan ditambahkan saat gateway rilis.