Dokumentasi

Panduan API PakaiKuota

Quickstart guide dan contoh code untuk mengintegrasikan API PakaiKuota ke aplikasi kamu. Endpoint chat completions yang kompatibel dengan format OpenAI.

OpenAI-compatibleStreamingBayar per token

Mulai Cepat

4 langkah untuk mulai menggunakan API.

1. Daftar Akun

Daftar di PakaiKuota.id dan verifikasi email

2. Top-up Saldo

Top-up saldo menggunakan QRIS

3. Buat API Key

Generate API key di dashboard

4. Mulai Coding

Gunakan API key untuk mengakses model LLM

Setup API

Konfigurasi yang perlu disiapkan sebelum request pertama.

  1. 01Daftar atau masuk ke akun PakaiKuota.
  2. 02Buka Dashboard → API Keys, buat key baru, lalu simpan plaintext key. Key hanya ditampilkan saat dibuat.
  3. 03Pastikan saldo tersedia. Request pay-per-use akan memotong saldo Rupiah setelah provider berhasil merespons.
  4. 04Gunakan slug model yang tersedia. Model gratis saat ini: nvidia-nemotron-3-ultra-550b-a55bfree.

Endpoint

POST /api/v1/chat/completions

Production:

https://pakai-kuota.vercel.app/api/v1/chat/completions

Daftar model

GET /api/v1/models

Dengan header API key. Hanya model yang diaktifkan admin yang ditampilkan.

Format Request

Parameter yang didukung endpoint chat completion.

  • model wajib: slug dari daftar model.
  • messages wajib: array berisi role dan content.
  • max_tokens opsional: integer 1–4096. Gunakan nilai kecil untuk membatasi biaya.
  • stream, temperature, dan top_p opsional.
  • Simpan API key di environment variable server, jangan di frontend publik atau repository.

Billing memakai harga model, markup, kurs USD/IDR, dan token aktual dari provider jika tersedia. Request gagal tidak seharusnya memotong saldo.

Error Umum

Kode error yang mungkin kamu temui dan solusinya.

401 INVALID_API_KEY

API key salah atau sudah dicabut.

403 MODEL_DISABLED

Model belum diaktifkan admin.

404 MODEL_NOT_FOUND

Gunakan slug yang dikembalikan endpoint daftar model.

429 RATE_LIMITED

Batas request tercapai.

402/502 UPSTREAM_ERROR

Provider tidak memiliki channel, kredit, atau mengembalikan error.

Contoh Code

Copy-paste ready untuk berbagai bahasa pemrograman.

curl https://pakai-kuota.vercel.app/api/v1/chat/completions \
  -H "Authorization: Bearer $PK_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {"role": "system", "content": "Kamu adalah asisten yang helpful."},
      {"role": "user", "content": "Halo, siapa kamu?"}
    ]
  }'

Model yang Tersedia

Daftar model yang dapat diakses via API.

nvidia-nemotron-3-ultra-550b-a55bfreeGratis

Model gratis yang sudah terhubung ke gateway

Rp 0

per 1M tokens

Lihat semua model di halaman harga