Mulai cepat
Drop-in replacement untuk OpenAI SDK. Ganti base URL, pakai kunci MahiCenter.
Referensi endpoint
Yang penting untuk dipakai sehari-hari; sisanya administratif.
| Metode | Path | Untuk |
|---|---|---|
| GET | /api/public/models | Katalog model aktif tersanitasi — publik, tanpa auth. |
| GET | /v1/models | Daftar model format OpenAI — butuh Authorization: Bearer …. |
| POST | /v1/chat/completions | Inferensi chat OpenAI-compatible — butuh kunci pengguna. |
| POST | /v1/responses | OpenAI Responses API (Codex CLI & agentic SDK) — butuh kunci pengguna aktif. |
| POST | /v1/messages | Anthropic Messages API (Claude Code CLI & Claude SDK) — butuh kunci pengguna. |
| POST | /v1/audio/transcriptions | Speech-to-text — butuh kunci pengguna. |
| POST | /v1/audio/speech | Text-to-speech — butuh kunci pengguna. |
| POST | /v1/images/generations | Generate gambar — butuh kunci pengguna. |
| POST | /api/client/status | Cek status kunci sendiri (respons tersamar demi privasi) — body JSON {"key": "…"}. |
| GET | /api/public/summary | Agregat global (token, request, pengguna, latensi, jumlah model) — publik. |
| GET | /api/public/leaderboard | Papan peringkat 20 besar teranonimisasi — publik. |
Integrasi client
Semua yang berbicara protokol OpenAI diperlakukan sama: arahkan base URL lalu pakai kunci.
Cursor / Continue.dev
Settings → Models → OpenAI-compatible. Base URL:
https://router.mahicenter.cloud/v1, API Key: kunci mahi-rtr-… kamu, lalu model ditulis persis seperti di katalog.Codex CLI
Set provider OpenAI custom dengan
base_url = "https://router.mahicenter.cloud/v1", wire_api = "responses", dan pilih model seri mahi/cd/gpt-5.4 atau mahi/cd/gpt-5.6-sol (khusus akun VIP).Claude Code CLI
Set environment
ANTHROPIC_BASE_URL=https://router.mahicenter.cloud dan ANTHROPIC_AUTH_TOKEN=mahi-rtr-… untuk memanggil endpoint /v1/messages.aider (CLI)
aider --openai-api-base https://router.mahicenter.cloud/v1 --openai-api-key mahi-rtr-… --model mahi/oc/deepseek-v4.1-flashPython (openai SDK)
OpenAI(base_url="https://router.mahicenter.cloud/v1", api_key="mahi-rtr-…") lalu client.chat.completions.create(...) seperti biasa.Node.js (openai SDK)
new OpenAI({ baseURL: "https://router.mahicenter.cloud/v1", apiKey: process.env.MAHI_KEY }) — sama persis SDK resmi, tidak perlu di-patch.Parameter chat.completions
Skema mengikuti OpenAI persis; yang paling sering dipakai:
| Parameter | Wajib | Keterangan |
|---|---|---|
| model | Ya | ID persis dari katalog (mis. mahi/oc/deepseek-v4.1-flash). |
| messages | Ya | Array [{role, content}] — role system/user/assistant. |
| max_tokens | Tidak | Batas token output; kosong = model pakai batas maksimumnya. |
| temperature | Tidak | 0–2; semakin tinggi semakin kreatif (default 1). |
| stream | Tidak | true untuk respons SSE per-token (streaming ala OpenAI). |
Kode Status & Penanganan Error
Gateway mengembalikan kode HTTP standar OpenAI-compatible dengan objek error JSON yang terstruktur dan jelas.
| Kode HTTP | Tipe / Kode Error | Penyebab & Solusi |
|---|---|---|
| 400 Bad Request | invalid_request_error |
Format JSON request rusak, field messages kosong, atau model yang diminta tidak terdaftar di gateway. Periksa kembali struktur request dan pastikan model tersedia di Katalog Model. |
| 401 Unauthorized | invalid_api_key |
Header Authorization: Bearer <kunci> tidak disertakan atau kunci API tidak terdaftar di sistem. Pastikan format diawali mahi-rtr-… dan cek masa aktif di halaman Cek Kunci. |
| 402 Payment Required | daily_quota_exceeded |
Batas kuota harian khusus model premium tertentu telah tercapai. Kuota harian di-reset otomatis setiap pukul 00:00 WIB. Anda dapat beralih ke model cepat lain seperti mahi/oc/deepseek-v4.1-flash atau mahi/dl/zai-org/GLM-5.3-Flash. |
| 403 Forbidden |
key_expiredhardware_limit_exceededkey_suspended
|
Akses ditolak karena ketentuan penggunaan:
|
| 429 Too Many Requests | rate_limit_exceeded |
Frekuensi permintaan melebihi batas rate limit (default 60–120 request/menit sesuai tier). Gateway menyertakan header Retry-After. Beri jeda antar request atau pasang retry dengan exponential backoff. |
| 500 Internal Error | server_error |
Terjadi kegagalan internal pada server gateway saat memproses permintaan. Coba ulangi request beberapa saat lagi. |
| 502 Bad Gateway | api_error / upstream_error |
Penyedia model upstream sedang down, mengalami timeout, atau kendala jaringan. Gateway mencoba 1x retry otomatis; jika tetap gagal, error dilaporkan apa adanya secara jujur tanpa menyamarkan model. Gunakan model cadangan lain di katalog. |
| 503 Service Unavailable | service_upgrading |
Gateway sedang dalam mode peningkatan sistem / pemeliharaan berkala (header respons menyertakan Retry-After: 900). Layanan akan kembali normal dalam hitungan menit tanpa mengurangi saldo atau sisa masa aktif kunci. |
Tanya jawab
Yang paling sering ditanyakan sebelum membeli.
Apakah benar-benar OpenAI-compatible?
Ya. Endpoint
/v1/chat/completions mengikuti skema OpenAI: body, header auth Bearer, respons choices/usage, streaming SSE. SDK openai Python/Node jalan tanpa patch.Bagaimana cara bayarnya?
Semua lewat bot Telegram @mahicenterrouterbot: ketik
/buy, pilih paket Standard atau Frontier (1 Hari / 3 Hari), bayar lewat QRIS dinamis sesuai nominal invoice, dan langganan otomatis aktif begitu pembayaran terdeteksi sistem.Ada batas kuota / rate limit?
Rate limit mengikuti tier akun: 60 RPM untuk Member Biasa / Free & Voucher (hanya model Standard), 100 RPM untuk paket 1 Hari (Standard Rp 4.500 / Frontier Rp 6.000), dan 120 RPM untuk paket 3 Hari (Standard Rp 14.000 / Frontier Rp 17.000). Paket Frontier mencakup model Standard + GPT/Grok/Gemini + Claude Haiku/Sonnet. Claude Opus & model Seri 5 TIDAK termasuk Frontier Rp 6rb/17rb (hanya paket khusus/Sultan). Paket Standard khusus model Standard. Cek paket & limit aktifmu di halaman Cek Kunci.
Kalau jalur model mati?
Gateway mencoba jalur cadangan otomatis (failover). Kalau semua jalur mati, kamu dapat error jujur. Kami tidak menyamaratakan error jadi respons sukses.
Boleh dipakai di banyak perangkat sekaligus?
Satu kunci dapat dipakai di banyak aplikasi (IDE, CLI, skrip), namun dibatasi maksimal 2 perangkat berbeda dalam kurun 24 jam (
hardware_limit_exceeded) demi mencegah kebocoran/sharing massal.Kunci hilang atau bocor?
Lapor segera ke bot (
/buy → menu Bantuan, atau DM owner). Kunci lama dinonaktifkan, kunci baru diterbitkan dengan sisa masa berlaku dipertahankan.Apakah ada SLA/garansi?
Jujur: tidak ada SLA formal. Layanan dijaga oleh manusia dan di-monitor cron. Waktu down dicatat; perpanjangan masa langganan diberikan otomatis kalau ada gangguan besar tervalidasi.
Perubahan terbaru
Dicatat jujur apa adanya.
| Tanggal | Perubahan |
|---|---|
| 15 Nov 2026 | Pembaruan privasi & keamanan serta standardisasi katalog model via /api/public/models dengan prefix seragam mahi/<provider>/<model>. |
| 25 Okt 2026 | Situs multi-halaman baru (Beranda, Model, Peringkat, Cek Kunci, Dokumentasi) dengan endpoint publik /api/public/*. |
| 25 Okt 2026 | Pembayaran QRIS jadi verifikasi manual owner + invoice PNG otomatis ke pembeli. |
| 25 Okt 2026 | Kemitraan resmi dengan SFG (SANN404 Forum Group); label publik katalog disanitasi penuh (white-label, tanpa jenama vendor); paket maksimal 7 hari. |
| 24 Okt 2026 | Penutupan celah /api/keys/create tanpa auth + admin guard di seluruh endpoint admin. |