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 Modellminimax/speech-2.5-turbo-preview

Modellseite →

Felder
Name	Typ	Pflicht	Standard
text	text	ja	-
voice_id	text	ja	-
speed	number	nein	1
volume	number	nein	1
pitch	number	nein	0
emotion	happy \| sad \| angry \| fearful \| disgusted \| surprised \| ...	nein	happy
english_normalization	toggle	nein	false
sample_rate	8000 \| 16000 \| 22050 \| 24000 \| 32000 \| 44100	nein	-
bitrate	32000 \| 64000 \| 128000 \| 256000	nein	-
channel	1 \| 2	nein	-
format	mp3 \| wav \| pcm \| flac	nein	-
language_boost	Chinese \| Chinese,Yue \| English \| Arabic \| Russian \| Spanish \| ...	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": "minimax/speech-2.5-turbo-preview",
  "inputs": {
    "text": "a lighthouse on a cliff at dusk, soft light",
    "voice_id": "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":"minimax/speech-2.5-turbo-preview","inputs":{"text":"a lighthouse on a cliff at dusk, soft light","voice_id":"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.mp3

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.