Pengembang · API v1

Satu API.
Semua model.

Gambar, video, audio, dan 3D di balik satu API. Panggil dari Node, Python, atau curl, atau jalankan lewat skrip di terminal dengan Genlaxy CLI, semuanya dibayar dari saldo yang sama dengan studio.

Dapatkan kunci API →Mulai cepat
$npm i -g @genlaxy/cli
Model
641
Endpoint
9
Isi saldo minimum
€5
01 · Contoh

Panggilan yang sama, output apa pun

Ganti ID model untuk beralih antara gambar, video, dan suara. Kolomnya mengikuti model.

1import { writeFile } from "node:fs/promises";2 3const API = "https://genlaxy.ai/api/v1/api/catalog";4const auth = { Authorization: `Bearer ${process.env.GENLAXY_API_KEY}` };5 6// 1. Generate an image7const res = await fetch(`${API}/generations`, {8  method: "POST",9  headers: { ...auth, "Content-Type": "application/json", "Idempotency-Key": crypto.randomUUID() },10  body: JSON.stringify({11    modelId: "luma/uni-v1/text-to-image",12    inputs: { prompt: "Neon city street after rain, cinematic night", size: "16:9" },13  }),14});15let { generation } = await res.json();16 17// 2. Wait for the result18while (generation.status === "queued" || generation.status === "generating") {19  await new Promise((r) => setTimeout(r, 3000));20  ({ generation } = await (await fetch(`${API}/generations/${generation.id}`, { headers: auth })).json());21}22 23// 3. Save the file24const file = await fetch(`${API}/generations/${generation.id}/content`, { headers: auth });25await writeFile("result.jpeg", Buffer.from(await file.arrayBuffer()));
Contoh renderluma/uni-v1/text-to-image
02 · Mulai cepat

Render pertama dalam tiga langkah

  1. 01Buat kunci APIMasuk dengan email Anda, buka Pengaturan, Kunci API, lalu buat kunci. Isi saldo mulai €5 di Tagihan.export GENLAXY_API_KEY="gl_live_..."
  2. 02Instal CLISatu perintah, Node.js 18.3 atau lebih baru. Atau lewati dan panggil API dengan klien HTTP apa pun.npm i -g @genlaxy/cli
  3. 03Buat render pertamaPilih ID model dari katalog dan kirim prompt. Tambahkan --dry-run untuk melihat harga tanpa mengeluarkan apa pun.genlaxy run luma/uni-v1/text-to-image -p "violet neon fox" -o ./out/
03 · CLIBaru

Render dari terminal

Jalankan model apa pun dari shell, job CI, atau agen coding. Setiap render diberi harga sebelum dimulai dan dibayar dari saldo yang sama.

Skrip dan CISetiap kolom model adalah flag; file lokal diunggah untuk Anda.
JSON di stdoutSatu dokumen JSON per eksekusi, progres dan error di stderr, kode keluar bukan nol jika gagal.
Agen codingFile skill mengajari agen Anda untuk memeriksa harga terlebih dahulu dan membatasinya.
Panduan lengkap CLI →
PerintahFungsinya
genlaxy loginTempel kunci API Anda sekali; kunci diperiksa lalu disimpan
genlaxy whoamiNama kunci dan saldo Anda
genlaxy models --type videoSemua model video beserta harga awalnya
genlaxy run <model> -hKolom sebuah model, diambil langsung: tipe, default, nilai yang diizinkan
genlaxy run <model> -p "<prompt>" -o ./out/Render dan simpan hasilnya di folder
genlaxy run <model> -p "..." --dry-runHarga pastinya, tanpa mengeluarkan apa pun
genlaxy run <model> -p "..." --max-price 0.50Menolak berjalan jika harganya lebih tinggi
genlaxy run <model> -p "..." --json -o ./out/Satu hasil JSON, siap untuk langkah berikutnya
genlaxy skill installAjari agen coding Anda memakai CLI
04 · Dasar API

Siap untuk produksi

Autentikasi

Token Bearer di header Authorization. Buat kunci di Pengaturan dan cabut kunci mana pun kapan saja.

Authorization: Bearer gl_live_...

Render di latar belakang

Memulai render langsung menjawab dengan status queued. Polling render sampai berhasil, gagal, atau dikembalikan dananya.

{ "status": "queued" }

Harga dulu

Minta harga pasti untuk input Anda tanpa memulai apa pun. Semua jumlah dalam sen euro.

POST /api/v1/api/catalog/quote

Coba ulang dengan aman

Kirim header Idempotency-Key dan permintaan yang diulang tidak akan pernah ditagih dua kali.

Idempotency-Key: render-042

Batas

Setiap kunci punya batas per menit dan batas harian opsional. Melewati batas, API menjawab 429.

429 Too Many Requests

Error dan pengembalian dana

Error JSON dengan kode dan pesan. Render yang gagal otomatis dikembalikan ke saldo Anda.

{ "status": "refunded" }
05 · Referensi

Endpoint

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

Referensi API lengkap →
GET/meKunci dan saldo Anda
GET/modelsSemua model
GET/models/detail?id=MODEL_IDSatu model dan kolomnya
POST/quoteHarga untuk input tertentu
POST/generationsMulai render
GET/generationsRender terbaru Anda
GET/generations/IDStatus satu render
GET/generations/ID/contentFile hasil
DELETE/generations/IDHapus render

Isi saldo €5 dan rilis hari ini

API, CLI, dan studio berbagi satu saldo. Render yang gagal dikembalikan dananya.

Dapatkan kunci API →Lihat harga