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 APIQuickstart dan Integrasi
Pengguna Claude CodeIntegrasi 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
https://api.adellroute.work/v1

Variabel kunci: ADELLROUTE_API_KEY. Placeholder kunci: sk-....

Endpoint yang didukung

EndpointFormat
POST /v1/chat/completionsOpenAI Chat Completions
POST /v1/responsesOpenAI Responses
POST /v1/messagesAnthropic Messages (Claude Code, Anthropic SDK)
POST /v1/messages/count_tokensAnthropic, estimasi token (gratis)
POST /v1/embeddingsOpenAI Embeddings
POST /v1/decisions, POST /v1/systemoneKeputusan model (mis. jev)
GET /v1/modelsDaftar model aktif beserta harga

Mulai dari mana?

Quickstart

Lima langkah mulai memakai AdellRoute: daftar akun, isi saldo, buat API key, kirim request pertama, dan cek pemakaian.

  1. Daftar akun

    Buka dashboard AdellRoute, daftar dengan email atau Google, lalu verifikasi email (kode 6 digit atau klik link di email).

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

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

  4. Kirim request pertama

    TerminalCode
    curl https://api.adellroute.work/v1/chat/completions \ -H "Authorization: Bearer $ADELLROUTE_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-5-mini", "messages": [{"role": "user", "content": "Halo! Perkenalkan dirimu singkat."}] }'

    Atau dengan Python:

    Code
    from openai import OpenAI client = OpenAI(base_url="https://api.adellroute.work/v1", api_key="sk-...") resp = client.chat.completions.create( model="claude-sonnet-5", messages=[{"role": "user", "content": "Tulis haiku tentang Jakarta"}], ) print(resp.choices[0].message.content)

    Nama model persis seperti di halaman Models atau dari GET /v1/models. Lanjut ke OpenAI SDK atau Anthropic SDK.

  5. 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:

PengaturanFungsi
Batas kreditMaksimum pengeluaran key ini (USD). Request ditolak 402 jika terlewati.
Periode resetdaily, weekly, atau monthly: batas kredit di-reset tiap periode. Kosong = batas seumur key.
Model yang diizinkanKey hanya bisa memakai model di daftar ini. Kosong = semua model.
KedaluwarsaKey otomatis mati setelah tanggal tertentu.
Allow-list IPHanya IP/CIDR tertentu (mis. 203.0.113.10, 10.0.0.0/8).
Request per menitRate limit khusus key ini.
Request paralelJumlah request yang boleh berjalan bersamaan.
Sensor secretMenyamarkan 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: 5 USD dengan periode reset daily
  • 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:

HeaderDipakai oleh
Authorization: Bearer sk-...OpenAI SDK, kebanyakan tool
x-api-key: sk-...Anthropic SDK, Claude Code
api-key: sk-...Klien gaya Azure OpenAI
TerminalCode
curl https://api.adellroute.work/v1/models -H "Authorization: Bearer sk-..."

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

  1. Dashboard → Billing → isi nominal Rupiah (ada batas minimum dan maksimum).
  2. Bayar di halaman pembayaran yang terbuka. Metodenya tergantung gateway: QRIS, virtual account, atau e-wallet.
  3. 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:

JSONCode
{ "error": { "message": "insufficient credits, please top up", "type": "insufficient_credits", "code": 402 } }

Di /v1/messages (Anthropic), error memakai format Anthropic ({"type": "error", "error": {"type": "...", "message": "..."}}) supaya Claude Code dan Anthropic SDK menampilkan pesan yang benar.

StatustypeArti & solusi
400invalid_request_errorBody tidak valid, model tidak dikenal/nonaktif, atau model dipakai di endpoint yang salah (mis. model embedding di chat).
401authentication_errorAPI key salah, dicabut, kedaluwarsa, atau akun ditangguhkan.
402insufficient_creditsSaldo habis atau batas kredit key tercapai. Top-up atau naikkan batas.
403permission_errorIP tidak ada di allow-list key, atau model tidak diizinkan untuk key ini.
404not_found_errorResource tidak ada.
429rate_limit_errorTerlalu banyak request (per menit atau paralel). Respons menyertakan header Retry-After (detik); tunggu selama itu lalu coba lagi.
502provider_errorProvider model sedang bermasalah. Coba lagi atau pakai model lain.
500internal_errorKesalahan 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

TerminalCode
curl https://api.adellroute.work/v1/models -H "Authorization: Bearer sk-..."

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:

KomponenKeterangan
InputToken prompt yang tidak kena cache
OutputToken yang dihasilkan model (termasuk reasoning)
Cache readToken prompt yang diambil dari prompt cache, biasanya jauh lebih murah
Cache writeUntuk model yang menagih penulisan cache (mis. Claude)
Code
biaya = input × harga_input + output × harga_output + cache_read × harga_cache_read + cache_write × harga_cache_write

Biaya persis setiap request terlihat di halaman Usage pada dashboard.

Harga (TBD)

KomponenBiaya per 1 juta token
InputTBD
OutputTBD
Cache readTBD
Cache writeTBD

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.

TerminalCode
curl -N https://api.adellroute.work/v1/chat/completions \ -H "Authorization: Bearer $ADELLROUTE_API_KEY" \ -H "Content-Type: application/json" \ -d '{"model": "gpt-5-mini", "stream": true, "messages": [{"role": "user", "content": "Hitung 1 sampai 10"}]}'
Code
stream = client.chat.completions.create( model="gpt-5-mini", messages=[{"role": "user", "content": "Hitung 1 sampai 10"}], stream=True, ) for chunk in stream: if chunk.choices and chunk.choices[0].delta.content: print(chunk.choices[0].delta.content, end="", flush=True)

Catatan:

  • AdellRoute otomatis meminta usage di 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 header Retry-After lalu 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.

Last modified on