Mulai cepat

Ringkasan

NusaRouter menjual akses model AI dengan saldo prabayar Rupiah. Kamu membuat API key di konsol, mengisi saldo lewat QRIS, lalu memanggil chat completions dengan bentuk yang sama seperti SDK OpenAI. SDK yang sudah kamu pakai cukup diarahkan ke base URL di sini.

Yang perlu kamu tahu sebelum mulai, supaya tidak ada kejutan di tengah jalan:

• Dua permukaan chat. Bentuk OpenAI di POST /v1/chat/completions, dan bentuk Anthropic di POST /v1/messages (lihat Format Anthropic). Tidak ada rute embeddings, pembuatan gambar, atau audio. Gambar tetap bisa kamu kirim sebagai bagian dari pesan chat.
• Tool calling tersedia. Model bisa meminta menjalankan fungsimu, dan kodemu yang menjalankannya. Lihat Pemanggilan tool.
• Saldo tidak pernah minus. Estimasi biaya ditahan dulu sebelum request dikirim ke model. Setelah selesai, yang ditagih adalah pemakaian sebenarnya — sampai maksimum 3× estimasi, dan tidak pernah melebihi saldomu.
• Satu key untuk semuanya. Satu key berlaku untuk semua model yang aktif, dan bisa kamu batasi sendiri nilai belanjanya.

Tiga langkah

Tidak perlu kartu kredit, tidak perlu menunggu persetujuan.

1. 1. Buat key

   Masuk ke konsol, buka halaman API key, lalu buat satu key. Key diawali sk-nusa- dan nilai lengkapnya hanya ditampilkan sekali, saat dibuat. Yang tersimpan di server cuma hash-nya, jadi tidak ada cara menampilkannya lagi. Salin dan simpan saat itu juga.

2. 2. Isi saldo

   Buka halaman Top up dan bayar dengan QRIS. Nominal minimum yang berlaku ditampilkan di halaman itu, dibaca dari server, bukan angka yang ditulis di dokumentasi ini, karena NusaRouter bisa mengubahnya.

   Saldo bertambah hanya setelah penyedia pembayaran mengonfirmasi. Kembali dari halaman QRIS tidak mengkreditkan apa pun.

3. 3. Panggil

   Kirim request pertamamu.

   curl https://api.nusarouter.web.id/v1/chat/completions \
     -H "Authorization: Bearer sk-nusa-..." \
     -H "Content-Type: application/json" \
     -d '{
       "model": "deepseek-flash-v4.1",
       "messages": [{"role": "user", "content": "Halo!"}]
     }'

Pakai dari kode

Bentuk request dan response mengikuti SDK-nya. Permukaan OpenAI lewat POST /v1/chat/completions, permukaan Anthropic lewat POST /v1/messages. Yang berubah hanya base_url dan api_key.

curl https://api.nusarouter.web.id/v1/chat/completions \
  -H "Authorization: Bearer sk-nusa-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-flash-v4.1",
    "messages": [{"role": "user", "content": "Halo!"}]
  }'

Permukaan Anthropic, lewat SDK Anthropic atau curl:

curl https://api.nusarouter.web.id/v1/messages \
  -H "x-api-key: sk-nusa-..." \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-flash-v4.1",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Halo!"}]
  }'

Cek koneksi

Kalau ada yang tidak jalan, dua perintah ini memisahkan masalah key dari masalah jaringan. Keduanya publik dan tidak butuh key, jadi hasilnya hanya bergantung pada host-nya.

Troubleshooting

Langkah berikutnya

• Autentikasi : header, key mana untuk permukaan mana, dan pencabutan key.
• Chat completions : parameter yang diterima dan bentuk response-nya.
• Format Anthropic : permukaan kedua untuk SDK Anthropic, [CC], dan klien Messages API.
• Pemanggilan tool : model meminta menjalankan fungsimu, dan cara membalas hasilnya.
• Streaming : token datang bertahap, dan penanda akhirnya.