API Genlaxy : chaque modèle depuis votre propre code

1 · Authentification

Créez une clé dans Réglages, Clés API. Envoyez-la avec chaque requête comme jeton Bearer. Les clés commencent par gl_live_ et ne fonctionnent que sur Genlaxy ; gardez-les sur votre serveur, jamais dans un navigateur ou une application.

curl

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

2 · Choisissez un modèle

Choisissez un modèle pour voir une requête prête construite à partir de ses propres champs. Les champs obligatoires sont remplis et chaque réglage facultatif utilise la valeur par défaut du modèle.

Modèle sélectionnéminimax/hailuo-02/standard

Page du modèle →

Champs
Nom	Type	Obligatoire	Par défaut
prompt	text	oui	-
image	url (image)	non	-
end_image	url (image)	non	-
duration	6 \| 10	non	6
enable_prompt_expansion	toggle	non	false

3 · Lancez un rendu

Un seul appel calcule le prix de vos entrées exactes et débite votre solde. La réponse revient aussitôt avec le statut queued ; le rendu s'exécute en arrière-plan. Envoyez un en-tête Idempotency-Key pour qu'une requête relancée ne soit jamais facturée deux fois.

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/hailuo-02/standard",
  "inputs": {
    "prompt": "a lighthouse on a cliff at dusk, soft light"
  }
}'

Vérifiez d'abord le prix (facultatif)

Les mêmes entrées, chiffrées sans rien lancer. La réponse est en centimes.

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/hailuo-02/standard","inputs":{"prompt":"a lighthouse on a cliff at dusk, soft light"}}'

4 · Interrogez et téléchargez

Demandez le rendu toutes les quelques secondes jusqu'à ce que le statut soit succeeded, failed ou refunded. En cas de succès, téléchargez le fichier depuis contentUrl avec la même clé. Un modèle de texte renvoie plutôt sa réponse dans 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

Endpoints

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

GET	/me	Votre clé et votre solde
GET	/models	Tous les modèles
GET	/models/detail?id=MODEL_ID	Un modèle et ses champs
POST	/quote	Prix pour des entrées exactes
POST	/generations	Lancer un rendu
GET	/generations	Vos rendus récents
GET	/generations/ID	Statut d'un rendu
GET	/generations/ID/content	Le fichier résultat
DELETE	/generations/ID	Supprimer un rendu

Prix et solde

Les rendus via l'API utilisent le même solde que le studio et coûtent le même prix. Tous les montants de l'API sont en centimes d'euro : costCents est ce qu'un rendu a coûté, balanceCents ce qui reste.

Erreurs et limites

Les erreurs sont renvoyées en JSON avec un code et un message. 401 : clé absente, incorrecte ou révoquée. 400 : un champ est invalide (les détails le nomment). 402 : solde insuffisant. 409 API_KEY_DAILY_CAP : la limite quotidienne de la clé est atteinte. 429 : trop de requêtes, ralentissez. Un rendu échoué est remboursé automatiquement.