Dokumentasi

Quickstart API

API mengikuti format yang kompatibel dengan [OI], jadi SDK dan tool yang sudah Anda pakai umumnya bisa langsung dipakai dengan mengganti base URL.

Dasar

Base URL

https://api.joyboyagent.com/v1

Header autentikasi

Authorization: Bearer <api-key>

Kirim key hanya dari sisi server atau editor Anda. Jangan menaruhnya di kode frontend yang bisa dilihat publik.

Permintaan pertama

Contoh di bawah memakai model auto, yang memilih model tersedia dengan konsumsi kuota paling rendah.

curl

curl https://api.joyboyagent.com/v1/chat/completions \  -H "Authorization: Bearer $JA_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "model": "auto",    "messages": [      { "role": "user", "content": "Jelaskan fungsi ini secara singkat" }    ]  }'

JavaScript

const res = await fetch("https://api.joyboyagent.com/v1/chat/completions", {  method: "POST",  headers: {    Authorization: `Bearer ${process.env.JA_API_KEY}`,    "Content-Type": "application/json",  },  body: JSON.stringify({    model: "auto",    messages: [{ role: "user", content: "Jelaskan fungsi ini" }],  }),});const data = await res.json();console.log(data.choices[0].message.content);

Python

import os, requestsres = requests.post(    "https://api.joyboyagent.com/v1/chat/completions",    headers={"Authorization": f"Bearer {os.environ['JA_API_KEY']}"},    json={        "model": "auto",        "messages": [{"role": "user", "content": "Jelaskan fungsi ini"}],    },    timeout=60,)print(res.json()["choices"][0]["message"]["content"])

Memilih model

Ganti nilai model dengan id di bawah. Angka multiplier menunjukkan seberapa cepat kuota berkurang dibanding model 1×.

Contoh id model dan multiplier kuotanya
id model	Nama	Multiplier
auto	Auto	1×
deepseek-v4-pro	DeepSeek V4 Pro	1,15×
glm-5-3	GLM 5.3	2×
kimi-k3	Kimi K3	2×
gpt-5-6	GPT 5.6	5×
anthropic-5	the model 5	12×

Lihat seluruh 27 model

Cara kuota dihitung

Kuota terpotong berdasarkan total token permintaan dan balasan, dikalikan multiplier model yang dipakai.

kuota_terpotong = (token_masuk + token_keluar) × multiplier

Contoh: permintaan 2.000 token pada model dengan multiplier 5× memotong 10.000 token dari kuota Anda. Karena itu paket 20 juta token setara sekitar 4 juta token efektif kalau seluruhnya dipakai pada model 5×.

Kalkulator token efektif

Buka dashboard kuota

Cek kuota lewat terminal

Tidak perlu membuka portal untuk tahu sisa kuota — panggil endpoint yang sama dari skrip, CI, atau alias shell. Berguna untuk peringatan otomatis sebelum kuota habis di tengah pekerjaan.

Perintah

curl https://api.joyboyagent.com/v1/quota \  -H "Authorization: Bearer ja_live_••••••••••••••••••••" \  -H "Accept: application/json"

Contoh respons

{ "remainingTokens": 680000000, "totalTokens": 1000000000, "usedTokens": 320000000}

Gunakan API key penuh dari email Anda — yang tersimpan di browser tidak bisa dipakai untuk ini. Endpoint ini di-cache maksimal 60 detik, jadi angka di dashboard bisa sedikit lebih baru.

Error yang umum

Kode di bawah datang dari API kami. Kalau Anda menerima error lain, kirimkan isinya ke layanan pelanggan bersama nomor pesanan.

401
Key tidak dikenali
Key salah tempel atau belum aktif. Periksa tidak ada spasi di ujung, lalu coba lagi. Kalau tetap gagal, hubungi kami dengan nomor pesanan.
402
Kuota habis
Kuota pada key ini sudah terpakai seluruhnya. Tambah kuota dari halaman paket; pekerjaan yang sudah tersimpan tidak terpengaruh.
403
Key dibatasi
Akses dibatasi sementara karena terdeteksi penyalahgunaan. Token Anda tidak kedaluwarsa — cek status di dashboard kuota Anda.
429
Terlalu banyak permintaan
Batas laju tercapai. Beri jeda beberapa saat, atau kurangi jumlah permintaan paralel.
503
Model sedang tidak tersedia
Penyedia model sedang terganggu. Coba model lain — kuota tidak terpotong untuk permintaan yang gagal.

Batasan

Ada batas laju permintaan untuk menjaga layanan stabil bagi semua pembeli. Pemakaian normal satu orang tidak akan terpengaruh.
Ketersediaan model mengikuti penyedia di sisi hulu dan dapat berubah tanpa mengurangi kuota yang sudah tercatat.
Kuota tidak terpotong untuk permintaan yang gagal karena gangguan di sisi kami atau penyedia.
Token yang dibeli tidak kedaluwarsa — masa aktif tidak berlaku (ADR-040).
Untuk pengujian beban atau permintaan paralel dalam jumlah besar, hubungi kami lebih dulu agar bisa disiapkan.

Ketentuan lengkap ada di syarat & ketentuan.

Riwayat perubahan

Model, paket, dan perbaikan — entri jujur yang bisa Anda verifikasi sendiri.

12 Sep 2026 Model
Kimi K3 Mod ditambahkan
Varian mod untuk pekerjaan seimbang dengan multiplier 2×. Total menjadi 27 model.
10 Sep 2026 Perbaikan
Perbaikan hitungan kuota pada permintaan yang dibatalkan
Permintaan yang dibatalkan sebelum balasan selesai tidak lagi memotong kuota penuh.
24 Sep 2026 Paket
Masa aktif dihapus total — token tidak kedaluwarsa lagi
Berlaku untuk semua paket, termasuk yang sudah dibeli. Kami beralih dari kebijakan 14–60 hari ke tanpa batas waktu total (ADR-040).
5 Sep 2026 Model
DeepSeek V4.1 · Respons cepat tersedia
Multiplier 2,56×. Varian lama tetap tersedia untuk yang sudah menakar pemakaiannya.
1 Sep 2026 Operasional
Email peringatan kuota di ambang 20% dan 5%
Dikirim otomatis ke email pembelian supaya Anda punya waktu menambah kuota sebelum habis.
28 Agu 2026 Perbaikan
Kirim ulang email akses langsung dari halaman invoice
Tidak perlu menunggu CS — tombol kirim ulang tersedia di invoice yang sudah dibayar.