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 terpilihmeshy/v7.1/image-to-3d

Halaman model →

Kolom
Nama	Tipe	Wajib	Bawaan
image	url (image)	ya	-
model_type	standard \| lowpoly \| smart-topology	tidak	standard
topology	quad \| triangle	tidak	triangle
target_polycount	number	tidak	30000
symmetry_mode	off \| auto \| on	tidak	auto
should_remesh	toggle	tidak	true
should_texture	toggle	tidak	true
enable_pbr	toggle	tidak	false
geometry_resolution	standard \| 2k \| 4k	tidak	standard
pose_mode	a-pose \| t-pose	tidak	-
texture_prompt	text	tidak	-
texture_image	text	tidak	-
enable_rigging	toggle	tidak	false
rigging_height_meters	number	tidak	1.7
enable_animation	toggle	tidak	false
animation_action_id	number	tidak	92

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": "meshy/v7.1/image-to-3d",
  "inputs": {
    "image": "https://example.com/input.png",
    "texture_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

curl -X POST https://genlaxy.ai/api/v1/api/catalog/quote \
  -H 'Authorization: Bearer gl_live_...' \
  -H 'Content-Type: application/json' \
  -d '{"modelId":"meshy/v7.1/image-to-3d","inputs":{"image":"https://example.com/input.png","texture_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

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.