Beranda Model Peringkat Cek Kunci Dokumentasi

Mulai cepat

Drop-in replacement untuk OpenAI SDK. Ganti base URL, pakai kunci MahiCenter.


  

Referensi endpoint

Yang penting untuk dipakai sehari-hari; sisanya administratif.

MetodePathUntuk
GET/api/public/modelsKatalog model aktif tersanitasi — publik, tanpa auth.
GET/v1/modelsDaftar model format OpenAI — butuh Authorization: Bearer ….
POST/v1/chat/completionsInferensi chat OpenAI-compatible — butuh kunci pengguna.
POST/v1/responsesOpenAI Responses API (Codex CLI & agentic SDK) — butuh kunci pengguna aktif.
POST/v1/messagesAnthropic Messages API (Claude Code CLI & Claude SDK) — butuh kunci pengguna.
POST/v1/audio/transcriptionsSpeech-to-text — butuh kunci pengguna.
POST/v1/audio/speechText-to-speech — butuh kunci pengguna.
POST/v1/images/generationsGenerate gambar — butuh kunci pengguna.
POST/api/client/statusCek status kunci sendiri (respons tersamar demi privasi) — body JSON {"key": "…"}.
GET/api/public/summaryAgregat global (token, request, pengguna, latensi, jumlah model) — publik.
GET/api/public/leaderboardPapan 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-flash
Python (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:

ParameterWajibKeterangan
modelYaID persis dari katalog (mis. mahi/oc/deepseek-v4.1-flash).
messagesYaArray [{role, content}] — role system/user/assistant.
max_tokensTidakBatas token output; kosong = model pakai batas maksimumnya.
temperatureTidak0–2; semakin tinggi semakin kreatif (default 1).
streamTidaktrue 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_expired
hardware_limit_exceeded
key_suspended
Akses ditolak karena ketentuan penggunaan:
  • Masa aktif habis (key_expired): Kunci telah melewati batas masa langganan.
  • Batas perangkat (hardware_limit_exceeded): Kunci terdeteksi digunakan di lebih dari 2 perangkat berbeda dalam kurun 24 jam. Hubungi owner jika perlu penyesuaian.
  • Kunci dinonaktifkan (key_suspended / key_banned): Kunci atau perangkat dinonaktifkan karena anomali atau penutupan sementara.
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.

TanggalPerubahan
15 Nov 2026Pembaruan privasi & keamanan serta standardisasi katalog model via /api/public/models dengan prefix seragam mahi/<provider>/<model>.
25 Okt 2026Situs multi-halaman baru (Beranda, Model, Peringkat, Cek Kunci, Dokumentasi) dengan endpoint publik /api/public/*.
25 Okt 2026Pembayaran QRIS jadi verifikasi manual owner + invoice PNG otomatis ke pembeli.
25 Okt 2026Kemitraan resmi dengan SFG (SANN404 Forum Group); label publik katalog disanitasi penuh (white-label, tanpa jenama vendor); paket maksimal 7 hari.
24 Okt 2026Penutupan celah /api/keys/create tanpa auth + admin guard di seluruh endpoint admin.