API Genlaxy: semua model dari kode Anda sendiri

1 · Autentikasi

Buat kunci di Pengaturan, Kunci API. Kirimkan di setiap permintaan sebagai token Bearer. Kunci diawali dengan gl_live_ dan hanya berfungsi di Genlaxy; simpan di server Anda, jangan pernah di browser atau aplikasi.

curl

curl https://genlaxy.ai/api/v1/api/catalog/me \
  -H 'Authorization: Bearer gl_live_...'

2 · Pilih model

Pilih model untuk melihat permintaan siap pakai yang disusun dari kolomnya sendiri. Kolom wajib sudah terisi, dan setiap pengaturan opsional memakai nilai bawaan model.

Model terpilihclarity-ai/flux-upscaler

Halaman model →

Kolom
Nama	Tipe	Wajib	Bawaan
image	url (image)	ya	-
target_megapixels	number	tidak	4
creativity	number	tidak	0

3 · Mulai render

Satu panggilan menghitung harga input persis Anda dan memotongnya dari saldo. Respons langsung kembali dengan status queued, sementara render berjalan di latar belakang. Kirim header Idempotency-Key agar permintaan yang diulang tidak pernah ditagih dua kali.

curl

curl -X POST https://genlaxy.ai/api/v1/api/catalog/generations \
  -H 'Authorization: Bearer gl_live_...' \
  -H 'Content-Type: application/json' \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "modelId": "clarity-ai/flux-upscaler",
  "inputs": {
    "image": "https://example.com/input.png"
  }
}'

Cek harga terlebih dahulu (opsional)

Input yang sama, dihitung harganya tanpa memulai apa pun. Jawabannya dalam sen.

curl

curl -X POST https://genlaxy.ai/api/v1/api/catalog/quote \
  -H 'Authorization: Bearer gl_live_...' \
  -H 'Content-Type: application/json' \
  -d '{"modelId":"clarity-ai/flux-upscaler","inputs":{"image":"https://example.com/input.png"}}'

4 · Cek status dan unduh

Minta status render setiap beberapa detik sampai statusnya succeeded, failed, atau refunded. Jika berhasil, unduh file dari contentUrl dengan kunci yang sama. Model teks mengembalikan jawabannya di textOutput.

curl

curl https://genlaxy.ai/api/v1/api/catalog/generations/GENERATION_ID \
  -H 'Authorization: Bearer gl_live_...'

curl

curl https://genlaxy.ai/api/v1/api/catalog/generations/GENERATION_ID/content \
  -H 'Authorization: Bearer gl_live_...' \
  -o result.png

Endpoint

URL dasar: https://genlaxy.ai/api/v1/api/catalog

GET	/me	Kunci dan saldo Anda
GET	/models	Semua model
GET	/models/detail?id=MODEL_ID	Satu model dan kolomnya
POST	/quote	Harga untuk input tertentu
POST	/generations	Mulai render
GET	/generations	Render terbaru Anda
GET	/generations/ID	Status satu render
GET	/generations/ID/content	File hasil
DELETE	/generations/ID	Hapus render

Harga dan saldo

Render lewat API memakai saldo yang sama dengan studio dan harganya sama. Setiap jumlah di API dalam sen euro: costCents adalah biaya sebuah render, balanceCents adalah sisa saldo.

Error dan batas

Error dikembalikan sebagai JSON dengan kode dan pesan. 401: kunci tidak ada, salah, atau dicabut. 400: ada kolom yang tidak valid (detailnya menyebutkan kolom itu). 402: saldo tidak cukup. 409 API_KEY_DAILY_CAP: batas harian kunci sudah tercapai. 429: terlalu banyak permintaan, perlambat. Render yang gagal dikembalikan dananya secara otomatis.