Développeurs · API v1

Une API.
Tous les modèles.

Images, vidéo, audio et 3D derrière une seule API. Appelez-la depuis Node, Python ou curl, ou pilotez-la depuis le terminal avec la CLI Genlaxy, le tout payé avec le même solde que le studio.

$npm i -g @genlaxy/cli
Modèles
641
Endpoints
9
Recharge minimale
5 €
01 · Exemples

Le même appel, n'importe quel résultat

Changez l'ID du modèle pour passer de l'image à la vidéo ou à la voix. Les champs suivent le modèle.

1import { writeFile } from "node:fs/promises";2 3const API = "https://genlaxy.ai/api/v1/api/catalog";4const auth = { Authorization: `Bearer ${process.env.GENLAXY_API_KEY}` };5 6// 1. Generate an image7const res = await fetch(`${API}/generations`, {8  method: "POST",9  headers: { ...auth, "Content-Type": "application/json", "Idempotency-Key": crypto.randomUUID() },10  body: JSON.stringify({11    modelId: "luma/uni-v1/text-to-image",12    inputs: { prompt: "Neon city street after rain, cinematic night", size: "16:9" },13  }),14});15let { generation } = await res.json();16 17// 2. Wait for the result18while (generation.status === "queued" || generation.status === "generating") {19  await new Promise((r) => setTimeout(r, 3000));20  ({ generation } = await (await fetch(`${API}/generations/${generation.id}`, { headers: auth })).json());21}22 23// 3. Save the file24const file = await fetch(`${API}/generations/${generation.id}/content`, { headers: auth });25await writeFile("result.jpeg", Buffer.from(await file.arrayBuffer()));
Exemple de renduluma/uni-v1/text-to-image
02 · Démarrage rapide

Premier rendu en trois étapes

  1. 01Créez une clé APIConnectez-vous avec votre email, ouvrez Paramètres, Clés API et créez une clé. Rechargez dès 5 € dans Facturation.export GENLAXY_API_KEY="gl_live_..."
  2. 02Installez la CLIUne seule commande, Node.js 18.3 ou plus récent. Ou passez-vous-en et appelez l'API avec n'importe quel client HTTP.npm i -g @genlaxy/cli
  3. 03Lancez votre premier renduChoisissez un ID de modèle dans le catalogue et envoyez un prompt. Ajoutez --dry-run pour voir le prix sans rien dépenser.genlaxy run luma/uni-v1/text-to-image -p "violet neon fox" -o ./out/
03 · CLINouveau

Rendez depuis le terminal

Lancez n'importe quel modèle depuis un shell, un job CI ou un agent de code. Chaque rendu est chiffré avant de démarrer et débité du même solde.

Scripts et CIChaque champ d'un modèle est une option ; un fichier local est envoyé pour vous.
JSON sur stdoutUn document JSON par exécution, progression et erreurs sur stderr, un code de sortie non nul en cas d'échec.
Agents de codeUn fichier de skill apprend à votre agent à vérifier d'abord le prix et à le plafonner.
Guide complet de la CLI →
CommandeCe qu'elle fait
genlaxy loginCollez votre clé API une fois ; elle est vérifiée et enregistrée
genlaxy whoamiLe nom de la clé et votre solde
genlaxy models --type videoTous les modèles vidéo avec leur prix de départ
genlaxy run <model> -hLes champs d'un modèle, en direct : type, valeur par défaut, valeurs autorisées
genlaxy run <model> -p "<prompt>" -o ./out/Rendre et enregistrer le résultat dans un dossier
genlaxy run <model> -p "..." --dry-runLe prix exact, sans rien dépenser
genlaxy run <model> -p "..." --max-price 0.50Refuser de lancer si le prix est plus élevé
genlaxy run <model> -p "..." --json -o ./out/Un résultat JSON, prêt pour l'étape suivante
genlaxy skill installApprendre à votre agent de code à utiliser la CLI
04 · L'essentiel de l'API

Prête pour la production

Authentification

Un jeton Bearer dans l'en-tête Authorization. Créez des clés dans Paramètres et révoquez-en une à tout moment.

Authorization: Bearer gl_live_...

Rendus en arrière-plan

Lancer un rendu répond aussitôt avec le statut queued. Interrogez le rendu jusqu'à ce qu'il réussisse, échoue ou soit remboursé.

{ "status": "queued" }

Le prix d'abord

Demandez le prix exact de vos paramètres sans rien lancer. Tous les montants sont en centimes d'euro.

POST /api/v1/api/catalog/quote

Relances sans risque

Envoyez un en-tête Idempotency-Key et une requête relancée n'est jamais facturée deux fois.

Idempotency-Key: render-042

Limites

Chaque clé a une limite par minute et un plafond quotidien facultatif. Au-delà, l'API répond 429.

429 Too Many Requests

Erreurs et remboursements

Des erreurs JSON avec un code et un message. Un rendu qui échoue est remboursé automatiquement sur votre solde.

{ "status": "refunded" }
05 · Référence

Endpoints

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

Référence complète de l'API →
GET/meVotre clé et votre solde
GET/modelsTous les modèles
GET/models/detail?id=MODEL_IDUn modèle et ses champs
POST/quotePrix pour des entrées exactes
POST/generationsLancer un rendu
GET/generationsVos rendus récents
GET/generations/IDStatut d'un rendu
GET/generations/ID/contentLe fichier résultat
DELETE/generations/IDSupprimer un rendu

Rechargez 5 € et lancez-vous aujourd'hui

L'API, la CLI et le studio partagent un seul solde. Les rendus échoués sont remboursés.