Dokumentasi API

Satu API key, akses ke semua model. Semua endpoint kompatibel dengan format OpenAI.

1. Dapatkan API Key

Daftar akun, pilih paket di /beli, scan QRIS. API key aktif otomatis setelah pembayaran terverifikasi.

2. Endpoint Dasar

# URL dasar
https://router.malawali.ai.id/v1

# Chat completions
POST /v1/chat/completions

# Daftar model yang tersedia
GET /v1/models

# Embeddings
POST /v1/embeddings

Semua request memakai header Authorization: Bearer <API_KEY>.

3. Contoh Penggunaan (curl)

curl https://router.malawali.ai.id/v1/chat/completions \
  -H "Authorization: Bearer ISI_API_KEY_KAMU" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "auto",
    "messages": [{"role": "user", "content": "Halo!"}]
  }'

4. Contoh Penggunaan (Python)

from openai import OpenAI

client = OpenAI(
    base_url="https://router.malawali.ai.id/v1",
    api_key="ISI_API_KEY_KAMU",
)

resp = client.chat.completions.create(
    model="auto",
    messages=[{"role": "user", "content": "Halo!"}],
)
print(resp.choices[0].message.content)

5. Kode Error

  • 401 — API key tidak valid / kedaluwarsa.
  • 404 — model tidak tersedia.
  • 429 — terlalu banyak request (rate limit).
  • 503 — model sedang tidak tersedia, coba lagi beberapa saat.

6. Rate Limit

Paket standar mencakup limit request per menit yang wajar. Hubungi admin untuk penyesuaian.