Développeurs · API v1Bientôt

Une API.
Tous les modèles.

Images, vidéo, audio et 3D derrière une seule API, avec le même solde que le studio. Créez une clé dans Réglages ; la CLI arrive bientôt.

Obtenir une clé APIDémarrage rapide

La CLI Airogenia arrive. Cette page montre son fonctionnement ; d'ici là, utilisez l'API.

$npm i -g @airogenia/cli
Modèles
672
Endpoints
9
Recharge minimale
3 €
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://airogenia.com/api/v1/api/catalog";4const auth = { Authorization: `Bearer ${process.env.AIROGENIA_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 3 € dans Facturation.export AIROGENIA_API_KEY="ai_live_..."
  2. 02La CLI arrive bientôtL'outil en ligne de commande n'est pas encore publié. D'ici là, tout se passe dans le studio.npm i -g @airogenia/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.airogenia run luma/uni-v1/text-to-image -p "violet neon fox" -o ./out/
03 · CLIBientôt

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
airogenia loginCollez votre clé API une fois ; elle est vérifiée et enregistrée
airogenia whoamiLe nom de la clé et votre solde
airogenia models --type videoTous les modèles vidéo avec leur prix de départ
airogenia run <model> -hLes champs d'un modèle, en direct : type, valeur par défaut, valeurs autorisées
airogenia run <model> -p "<prompt>" -o ./out/Rendre et enregistrer le résultat dans un dossier
airogenia run <model> -p "..." --dry-runLe prix exact, sans rien dépenser
airogenia run <model> -p "..." --max-price 0.50Refuser de lancer si le prix est plus élevé
airogenia run <model> -p "..." --json -o ./out/Un résultat JSON, prêt pour l'étape suivante
airogenia 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 ai_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 basehttps://airogenia.com/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 3 € et lancez-vous aujourd'hui

Créez une clé API dans Réglages et appelez n'importe quel modèle. La CLI arrive bientôt. Les rendus échoués sont remboursés.

Obtenir une clé APIVoir les prix