Sviluppatori · API v1

Un'unica API.
Ogni modello.

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 genlaxy
Modelli
730
Endpoint
9
Ricarica minima
3 €
01 · Esempi

Stessa chiamata, qualsiasi output

Cambia 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()));
Render di esempioluma/uni-v1/text-to-image
02 · Guida rapida

Il primo render in tre passi

  1. 01Crea una chiave APIAccedi con la tua email, apri Impostazioni, Chiavi API e crea una chiave. Ricarica da 3 € in Fatturazione.export GENLAXY_API_KEY="gl_live_..."
  2. 02Installa la CLIUn solo comando, Node.js 18.3 o successivo. Oppure salta questo passo e chiama l'API con qualsiasi client HTTP.npm i -g genlaxy
  3. 03Fai il tuo primo renderScegli un ID modello dal catalogo e invia un prompt. Aggiungi --dry-run per vedere il prezzo senza spendere nulla.genlaxy run luma/uni-v1/text-to-image -p "violet neon fox" -o ./out/
03 · CLINovità

Genera dal terminale

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.

Script e CIOgni campo di un modello è un flag; un file locale viene caricato per te.
JSON su stdoutUn documento JSON per esecuzione, avanzamento ed errori su stderr, codice di uscita diverso da zero in caso di errore.
Agenti di programmazioneUn file skill insegna al tuo agente a controllare prima il prezzo e a fissare un tetto.
Guida completa alla CLI →
ComandoCosa fa
genlaxy loginIncolla la tua chiave API una volta sola; viene verificata e salvata
genlaxy whoamiIl nome della chiave e il tuo saldo
genlaxy models --type videoTutti i modelli video con il prezzo di partenza
genlaxy run <model> -hI campi di un modello, letti in tempo reale: tipo, valore predefinito, valori ammessi
genlaxy run <model> -p "<prompt>" -o ./out/Genera e salva il risultato in una cartella
genlaxy run <model> -p "..." --dry-runIl prezzo esatto, senza spendere nulla
genlaxy run <model> -p "..." --max-price 0.50Rifiuta di eseguire se il prezzo è più alto
genlaxy run <model> -p "..." --json -o ./out/Un risultato JSON, pronto per il passo successivo
genlaxy skill installInsegna al tuo agente di programmazione a usare la CLI
04 · API in sintesi

Pensata per la produzione

Autenticazione

Un token Bearer nell'header Authorization. Crea le chiavi in Impostazioni e revocale quando vuoi.

Authorization: Bearer gl_live_...

Render in background

Avviare un render risponde subito con stato queued. Controlla il render finché non è riuscito, fallito o rimborsato.

{ "status": "queued" }

Prima il prezzo

Chiedi il prezzo esatto dei tuoi input senza avviare nulla. Ogni importo è in centesimi di euro.

POST /api/v1/api/catalog/quote

Nuovi tentativi sicuri

Invia un header Idempotency-Key e una richiesta ripetuta non addebita mai due volte.

Idempotency-Key: render-042

Limiti

Ogni chiave ha un limite al minuto e un tetto giornaliero facoltativo. Oltre il limite l'API risponde 429.

429 Too Many Requests

Errori e rimborsi

Errori JSON con un codice e un messaggio. Un render non riuscito viene rimborsato automaticamente sul tuo saldo.

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

Endpoint

URL di base https://genlaxy.ai/api/v1/api/catalog

Riferimento API completo →
GET/meLa tua chiave e il saldo
GET/modelsTutti i modelli
GET/models/detail?id=MODEL_IDUn modello e i suoi campi
POST/quotePrezzo per input esatti
POST/generationsAvvia un render
GET/generationsI tuoi render recenti
GET/generations/IDStato di un render
GET/generations/ID/contentIl file del risultato
DELETE/generations/IDElimina un render

Ricarica 3 € e vai in produzione oggi

L'API, la CLI e lo studio condividono un unico saldo. I render non riusciti vengono rimborsati.