Autenticazione
Un token Bearer nell'header Authorization. Crea le chiavi in Impostazioni e revocale quando vuoi.
Authorization: Bearer gl_live_...Immagini, video, audio e 3D dietro un'unica API. Chiamala da Node, Python o curl, oppure usala dal terminale con la CLI di Genlaxy, tutto pagato dallo stesso saldo dello studio.
npm i -g genlaxyCambia l'ID del modello per passare tra immagine, video e voce. I campi seguono il modello.
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()));
export GENLAXY_API_KEY="gl_live_..."npm i -g genlaxygenlaxy run luma/uni-v1/text-to-image -p "violet neon fox" -o ./out/Esegui qualsiasi modello da una shell, un job di CI o un agente di programmazione. Ogni render ha il prezzo calcolato prima di partire e attinge allo stesso saldo.
genlaxy loginIncolla la tua chiave API una volta sola; viene verificata e salvatagenlaxy whoamiIl nome della chiave e il tuo saldogenlaxy models --type videoTutti i modelli video con il prezzo di partenzagenlaxy run <model> -hI campi di un modello, letti in tempo reale: tipo, valore predefinito, valori ammessigenlaxy run <model> -p "<prompt>" -o ./out/Genera e salva il risultato in una cartellagenlaxy run <model> -p "..." --dry-runIl prezzo esatto, senza spendere nullagenlaxy run <model> -p "..." --max-price 0.50Rifiuta di eseguire se il prezzo è più altogenlaxy run <model> -p "..." --json -o ./out/Un risultato JSON, pronto per il passo successivogenlaxy skill installInsegna al tuo agente di programmazione a usare la CLIUn token Bearer nell'header Authorization. Crea le chiavi in Impostazioni e revocale quando vuoi.
Authorization: Bearer gl_live_...Avviare un render risponde subito con stato queued. Controlla il render finché non è riuscito, fallito o rimborsato.
{ "status": "queued" }Chiedi il prezzo esatto dei tuoi input senza avviare nulla. Ogni importo è in centesimi di euro.
POST /api/v1/api/catalog/quoteInvia un header Idempotency-Key e una richiesta ripetuta non addebita mai due volte.
Idempotency-Key: render-042Ogni chiave ha un limite al minuto e un tetto giornaliero facoltativo. Oltre il limite l'API risponde 429.
429 Too Many RequestsErrori JSON con un codice e un messaggio. Un render non riuscito viene rimborsato automaticamente sul tuo saldo.
{ "status": "refunded" }/meLa tua chiave e il saldo/modelsTutti i modelli/models/detail?id=MODEL_IDUn modello e i suoi campi/quotePrezzo per input esatti/generationsAvvia un render/generationsI tuoi render recenti/generations/IDStato di un render/generations/ID/contentIl file del risultato/generations/IDElimina un renderRicarica 3 € e vai in produzione oggi
L'API, la CLI e lo studio condividono un unico saldo. I render non riusciti vengono rimborsati.