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 Modellbytedance/seedance-2.0/text-to-video

Modellseite →

Felder
Name	Typ	Pflicht	Standard
prompt	text	ja	-
reference_images	url (image)	nein	-
reference_videos	url (video)	nein	-
reference_audios	url (audio)	nein	-
aspect_ratio	16:9 \| 9:16 \| 4:3 \| 3:4 \| 1:1 \| 21:9	nein	16:9
resolution	480p \| 720p \| 1080p \| 4k	nein	720p
duration	number	nein	5
enable_web_search	toggle	nein	false
generate_audio	toggle	nein	true

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": "bytedance/seedance-2.0/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":"bytedance/seedance-2.0/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.