Entwickler · API v1

Eine API.
Jedes Modell.

Bilder, Video, Audio und 3D hinter einer API. Ruf sie aus Node, Python oder curl auf oder automatisiere sie im Terminal mit der Genlaxy CLI, alles bezahlt aus demselben Guthaben wie das Studio.

$npm i -g @genlaxy/cli
Modelle
641
Endpunkte
9
Mindestaufladung
5 €
01 · Beispiele

Derselbe Aufruf, jede Ausgabe

Tausche die Modell-ID, um zwischen Bild, Video und Sprache zu wechseln. Die Felder richten sich nach dem Modell.

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()));
Beispiel-Renderingluma/uni-v1/text-to-image
02 · Schnellstart

Der erste Render in drei Schritten

  1. 01API-Schlüssel erstellenMelde dich mit deiner E-Mail an, öffne Einstellungen, API-Schlüssel und erstelle einen Schlüssel. Lade ab 5 € unter Abrechnung auf.export GENLAXY_API_KEY="gl_live_..."
  2. 02CLI installierenEin Befehl, Node.js 18.3 oder neuer. Oder lass sie weg und ruf die API mit einem beliebigen HTTP-Client auf.npm i -g @genlaxy/cli
  3. 03Ersten Render startenWähle eine Modell-ID aus dem Katalog und sende einen Prompt. Mit --dry-run siehst du den Preis, ohne etwas auszugeben.genlaxy run luma/uni-v1/text-to-image -p "violet neon fox" -o ./out/
03 · CLINeu

Rendern im Terminal

Starte jedes Modell aus einer Shell, einem CI-Job oder einem Coding-Agenten. Jeder Render wird vor dem Start bepreist und aus demselben Guthaben bezahlt.

Skripte und CIJedes Feld eines Modells ist ein Flag; eine lokale Datei wird für dich hochgeladen.
JSON auf stdoutEin JSON-Dokument pro Lauf, Fortschritt und Fehler auf stderr, ein Exit-Code ungleich null bei Fehlern.
Coding-AgentenEine Skill-Datei bringt deinem Agenten bei, erst den Preis zu prüfen und ihn zu begrenzen.
Vollständige CLI-Anleitung →
BefehlWas er tut
genlaxy loginFüge deinen API-Schlüssel einmal ein; er wird geprüft und gespeichert
genlaxy whoamiDer Name des Schlüssels und dein Guthaben
genlaxy models --type videoAlle Videomodelle mit ihrem Startpreis
genlaxy run <model> -hDie Felder eines Modells, live abgerufen: Typ, Standardwert, erlaubte Werte
genlaxy run <model> -p "<prompt>" -o ./out/Rendern und das Ergebnis in einem Ordner speichern
genlaxy run <model> -p "..." --dry-runDer genaue Preis, ohne etwas auszugeben
genlaxy run <model> -p "..." --max-price 0.50Nicht starten, wenn der Preis höher ist
genlaxy run <model> -p "..." --json -o ./out/Ein JSON-Ergebnis, bereit für den nächsten Schritt
genlaxy skill installBring deinem Coding-Agenten die CLI bei
04 · API-Grundlagen

Gebaut für die Produktion

Authentifizierung

Ein Bearer-Token im Authorization-Header. Erstelle Schlüssel in den Einstellungen und widerrufe jeden davon jederzeit.

Authorization: Bearer gl_live_...

Renders im Hintergrund

Der Start eines Renders antwortet sofort mit dem Status queued. Frag den Render ab, bis er erfolgreich ist, fehlschlägt oder erstattet wurde.

{ "status": "queued" }

Erst der Preis

Frag den genauen Preis deiner Eingaben ab, ohne etwas zu starten. Alle Beträge sind in Euro-Cent.

POST /api/v1/api/catalog/quote

Sichere Wiederholungen

Sende einen Idempotency-Key-Header, und eine wiederholte Anfrage wird nie doppelt berechnet.

Idempotency-Key: render-042

Limits

Jeder Schlüssel hat ein Limit pro Minute und ein optionales Tageslimit. Darüber antwortet die API mit 429.

429 Too Many Requests

Fehler und Erstattungen

JSON-Fehler mit Code und Meldung. Ein fehlgeschlagener Render wird automatisch deinem Guthaben erstattet.

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

Endpunkte

Basis-URL https://genlaxy.ai/api/v1/api/catalog

Vollständige API-Referenz →
GET/meDein Schlüssel und Guthaben
GET/modelsAlle Modelle
GET/models/detail?id=MODEL_IDEin Modell und seine Felder
POST/quotePreis für genaue Eingaben
POST/generationsRendering starten
GET/generationsDeine letzten Renderings
GET/generations/IDStatus eines Renderings
GET/generations/ID/contentDie Ergebnisdatei
DELETE/generations/IDRendering löschen

Lade 5 € auf und leg heute los

API, CLI und Studio teilen sich ein Guthaben. Fehlgeschlagene Renders werden erstattet.