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-compatibleBayar per pemakaianGPT · Claude · GLM

Mulai Cepat

4 langkah untuk mulai menggunakan API.

1. Daftar Akun

Daftar di pakaikuota.cloud dan verifikasi email

2. Top Up Saldo

Top up saldo via QRIS, biaya dipotong per pemakaian

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 di halaman Harga & Model.

Endpoint

POST /chat/completions

Production:

https://www.pakaikuota.cloud/api/v1/chat/completions

Daftar model

GET /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.
  • temperature dan top_p opsional.
  • stream belum tersedia. Gunakan false atau omit field ini.
  • 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.

Rate Limit

Batas request per menit untuk mencegah abuse.

Per API Key

10 req/menit

Per User

20 req/menit

Per IP

30 req/menit

Kalau melewati batas, endpoint mengembalikan 429 RATE_LIMITED. Tunggu beberapa saat lalu coba lagi.

Error Umum

Kode error yang mungkin kamu temui dan solusinya.

401 INVALID_API_KEY

API key salah atau sudah dicabut.

402 INSUFFICIENT_BALANCE

Saldo tidak mencukupi untuk request ini. Top up dulu.

403 MODEL_DISABLED

Model belum diaktifkan admin.

404 MODEL_NOT_FOUND

Gunakan slug yang dikembalikan endpoint daftar model.

429 RATE_LIMITED

Batas request tercapai. Tunggu lalu coba lagi.

502 UPSTREAM_ERROR

Provider upstream sedang bermasalah. Coba lagi nanti.

Contoh Code

Copy-paste ready untuk berbagai bahasa pemrograman.

curl https://www.pakaikuota.cloud/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

Contoh model yang dapat diakses via API. Cek dashboard atau halaman harga untuk daftar lengkap dan harga per model.

gpt-4o-miniGPT

OpenAI GPT family — cepat dan hemat untuk chat umum.

Sesuai pemakaian

claude-3-5-sonnetClaude

Anthropic Claude family — bagus untuk analisis dan reasoning.

Sesuai pemakaian

glm-4-flashGLM

Zhipu GLM family — ringan, cocok untuk task pendek.

Sesuai pemakaian

Lihat semua model dan harga per 1K token di halaman harga