Genlaxy API: jedes Modell aus deinem eigenen Code

1 · Authentifizieren

Erstelle einen Schlüssel unter Einstellungen, API-Schlüssel. Sende ihn bei jeder Anfrage als Bearer-Token. Schlüssel beginnen mit gl_live_ und funktionieren nur auf Genlaxy; bewahre sie auf deinem Server auf, niemals in einem Browser oder einer App.

curl

curl https://genlaxy.ai/api/v1/api/catalog/me \
  -H 'Authorization: Bearer gl_live_...'

2 · Modell wählen

Wähle ein Modell, um eine fertige Anfrage aus seinen eigenen Feldern zu sehen. Pflichtfelder sind ausgefüllt, jede optionale Einstellung nutzt den Standardwert des Modells.

Gewähltes Modellalibaba/wan-2.6/text-to-video

Modellseite →

Felder
Name	Typ	Pflicht	Standard
prompt	text	ja	-
negative_prompt	text	nein	-
audio	url (audio)	nein	-
size	1280720 \| 7201280 \| 19201080 \| 10801920	nein	1280*720
duration	5 \| 10 \| 15	nein	5
shot_type	single \| multi	nein	single
enable_prompt_expansion	toggle	nein	false
seed	number	nein	-

3 · Rendering starten

Ein Aufruf berechnet den Preis für genau deine Eingaben und belastet dein Guthaben. Die Antwort kommt sofort mit dem Status queued zurück, das Rendering läuft im Hintergrund. Sende einen Idempotency-Key-Header, damit eine wiederholte Anfrage nie doppelt abgerechnet wird.

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": "alibaba/wan-2.6/text-to-video",
  "inputs": {
    "prompt": "a lighthouse on a cliff at dusk, soft light"
  }
}'

Zuerst den Preis prüfen (optional)

Dieselben Eingaben, bepreist ohne etwas zu starten. Die Antwort ist in Cent.

curl

curl -X POST https://genlaxy.ai/api/v1/api/catalog/quote \
  -H 'Authorization: Bearer gl_live_...' \
  -H 'Content-Type: application/json' \
  -d '{"modelId":"alibaba/wan-2.6/text-to-video","inputs":{"prompt":"a lighthouse on a cliff at dusk, soft light"}}'

4 · Abfragen und herunterladen

Frage das Rendering alle paar Sekunden ab, bis der Status succeeded, failed oder refunded ist. Bei Erfolg lädst du die Datei mit demselben Schlüssel von contentUrl herunter. Ein Textmodell liefert seine Antwort stattdessen in 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.mp4

Endpunkte

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

GET	/me	Dein Schlüssel und Guthaben
GET	/models	Alle Modelle
GET	/models/detail?id=MODEL_ID	Ein Modell und seine Felder
POST	/quote	Preis für genaue Eingaben
POST	/generations	Rendering starten
GET	/generations	Deine letzten Renderings
GET	/generations/ID	Status eines Renderings
GET	/generations/ID/content	Die Ergebnisdatei
DELETE	/generations/ID	Rendering löschen

Preise und Guthaben

API-Renderings nutzen dasselbe Guthaben wie das Studio und kosten dasselbe. Alle Beträge in der API sind Eurocent: costCents ist, was ein Rendering gekostet hat, balanceCents, was übrig ist.

Fehler und Limits

Fehler kommen als JSON mit Code und Nachricht zurück. 401: Schlüssel fehlt, ist falsch oder widerrufen. 400: ein Feld ist ungültig (die Details nennen es). 402: nicht genug Guthaben. 409 API_KEY_DAILY_CAP: das Tageslimit des Schlüssels ist erreicht. 429: zu viele Anfragen, bitte langsamer. Ein fehlgeschlagenes Rendering wird automatisch erstattet.