Dokumentasi

RoutingAI memakai format OpenAI Chat Completions, jadi sebagian besar SDK bisa dipakai tanpa perubahan besar.

1. Ambil kunci

Masuk dengan Google, lalu buka panel kunci API. Kunci ditampilkan sekali, jadi langsung simpan di penyimpan rahasia atau environment variable aplikasi.

2. Arahkan SDK ke RoutingAI

from openai import OpenAI

client = OpenAI(
    base_url="https://www.routingai.my.id/v1",
    api_key="sk-rly-...",
)

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

Ganti MODEL_SLUG dengan salah satu slug dari katalog model. Paket node, curl, dan axios mengikuti pola yang sama.

3. Endpoint yang tersedia

Endpoint	Keterangan
POST /v1/chat/completions	Chat completion, streaming dan non streaming
GET /v1/models	Daftar model aktif beserta harga
GET /v1/usage	Ringkasan pemakaian untuk kunci yang dipakai

Cara hitung biaya

Biaya memakai token input dan output yang dilaporkan provider, dikali harga model di katalog. Saat ini belum ada margin tambahan di atas harga provider. 1.000 kredit setara 1 USD, dan saldo dipotong otomatis setiap permintaan.

Biaya diperiksa sebelum permintaan dikirim. Saldo yang kurang ditolak dengan kode 402 insufficient_credits, jadi tidak ada permintaan yang berjalan tanpa biaya yang jelas.

Kode error yang sering muncul

401 invalid_api_key

Kunci tidak dikenal. Cek header Authorization dan kunci yang dipakai.

402 insufficient_credits

Saldo tidak cukup. Turunkan max_tokens atau isi saldo.

404 model_not_found

Slug model tidak ada atau sedang dinonaktifkan.

429 rate_limited

Batas permintaan per menit untuk kunci ini terlampaui. Tunggu satu menit.

503 provider_not_configured

Admin belum mengisi kredensial provider untuk model ini.

503 model_price_missing

Harga model belum diatur, model tidak bisa dipakai.

Status saat ini

1 model aktif dan 1 provider aktif. Data diambil langsung dari katalog, bukan angka marketing.