Mengenal REST API
Base URL, autentikasi, format request dan respons, serta cara menguji kunci pertamamu.
REST API XPlor3 adalah API yang sama yang dipakai studio. Endpoint, validasi, harga, dan aturan pengembalian kreditnya tidak berbeda: kunci API cukup menggantikan sesi login.
Base URL
https://api.xplor3.space/v1Semua endpoint di dokumentasi ini relatif terhadap alamat itu.
Autentikasi
Kirim kunci API di header Authorization setiap request:
Authorization: Bearer xpk_kunci_kamuRequest tanpa kunci, atau dengan kunci yang salah, dicabut, atau kedaluwarsa, dijawab 401 UNAUTHORIZED. Memulai generate butuh akun dengan email terverifikasi; kalau belum, jawabannya 403 EMAIL_UNVERIFIED.
Hanya dari server
Panggil API dari backend, skrip, atau server milikmu. Kunci yang dikirim dari kode di peramban pengguna bisa dibaca siapa pun yang membuka halamanmu.
Uji kunci pertamamu
curl https://api.xplor3.space/v1/wallet \
-H "Authorization: Bearer $XPLOR3_API_KEY"Jawaban yang berhasil berisi saldomu dan 20 catatan kredit terakhir:
{
"balance": 120.4,
"ledger": [
{
"id": "cm...",
"delta": -9.6,
"reason": "JOB_DEBIT",
"jobId": "cm...",
"orderId": null,
"createdAt": "2026-10-23T08:12:44.120Z"
}
]
}Format
- Request dan respons JSON, dengan header
Content-Type: application/jsonuntuk body. Pengecualiannya unggahan berkas multipart. - Kredit ditulis sebagai angka desimal, misalnya
9.6. - Waktu dalam ISO 8601 UTC, misalnya
2026-10-23T08:12:44.120Z. - Bahasa pesan error mengikuti header
Accept-Language:enuntuk bahasa Inggris, selain itu bahasa Indonesia. - Daftar yang panjang dipaginasi dengan
limit(maksimal 50) dancursor. Jawabannya memuatitemsdannextCursor; kirimnextCursorsebagaicursoruntuk halaman berikutnya sampai nilainyanull.
Langkah berikutnya
Alur generate
Dari memilih model sampai mengunduh berkas hasil, dengan contoh lengkap.
Webhook
Diberi tahu saat job selesai, tanpa membaca status berulang kali.
Referensi endpoint
Semua endpoint yang tersedia untuk kunci API, beserta field-nya.
Referensi model
Field input, nilai yang diterima, dan aturan setiap model.
Batas dan error
Kode error, batas request per menit, dan cara menanganinya.

