L'API Genlaxy

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 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.

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 -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-v1-lite-i2v-480p",
  "inputs": {
    "image": "https://example.com/input.png",
    "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 -X POST https://genlaxy.ai/api/v1/api/catalog/quote \
  -H 'Authorization: Bearer gl_live_...' \
  -H 'Content-Type: application/json' \
  -d '{"modelId":"bytedance/seedance-v1-lite-i2v-480p","inputs":{"image":"https://example.com/input.png","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 https://genlaxy.ai/api/v1/api/catalog/generations/GENERATION_ID \
  -H 'Authorization: Bearer gl_live_...'

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

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.