API Genlaxy

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 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.

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 -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": "pika/v2.0-turbo-t2v",
  "inputs": {
    "prompt": "a lighthouse on a cliff at dusk, soft light"
  }
}'

Cek harga terlebih dahulu (opsional)

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

curl -X POST https://genlaxy.ai/api/v1/api/catalog/quote \
  -H 'Authorization: Bearer gl_live_...' \
  -H 'Content-Type: application/json' \
  -d '{"modelId":"pika/v2.0-turbo-t2v","inputs":{"prompt":"a lighthouse on a cliff at dusk, soft light"}}'

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 https://genlaxy.ai/api/v1/api/catalog/generations/GENERATION_ID \
  -H 'Authorization: Bearer gl_live_...'

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

Endpoint

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

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.