Ringkasan untuk developer
Dua cara memakai XPlor3 dari luar studio, MCP untuk agen AI dan REST API untuk aplikasimu, dengan satu kunci API.
Semua yang bisa dilakukan konsol studio, dari memilih model sampai mengunduh hasil, bisa dilakukan dari luar studio. Kamu memilih jalurnya sesuai siapa yang memanggil.
| MCP | REST API | |
|---|---|---|
| Untuk | Agen AI: Claude Desktop, Cursor, agen lokal | Aplikasi, backend, skrip otomasi |
| Alamat | https://mcp.xplor3.space/mcp | https://api.xplor3.space/v1 |
| Cara memanggil | Agen memilih alat sendiri dari percakapan | Kamu mengirim request HTTP |
| Kunci | Header Authorization: Bearer xpk_... | Header Authorization: Bearer xpk_... |
| Tahu job selesai | Tool wait_for_generation, satu panggilan | Webhook ke servermu, atau Server-Sent Events |
Keduanya memakai kunci yang sama, dibuat di halaman Kredensial studio.
Yang sama di kedua jalur
- Saldo dan tarif yang sama. Generate lewat MCP atau REST memotong saldo akunmu dengan tarif yang sama persis seperti di studio. Hasil yang gagal mengembalikan kreditnya sendiri.
- Riwayat yang sama. Job yang dimulai lewat API muncul di Riwayat studio, dan sebaliknya.
- Model baru langsung tersedia. Katalog dibaca saat dipanggil, jadi model yang baru ditambahkan bisa dipakai tanpa memperbarui apa pun di sisimu.
- Email harus terverifikasi untuk memulai generate.
Mulai
1. Buat kunci
Kunci API dibuat di studio dan hanya tampil sekali.
2a. Pasang di agen
Tempel konfigurasi ke klien MCP, lalu minta agen membuat gambar.
2b. Panggil dari kode
Alur generate lewat REST, dari request pertama sampai unduh berkas.
3. Susun input model
modelSlug, field, nilai yang diterima, dan aturan setiap model.