Développeurs · API v1

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 et installez la CLI avec npm.

Obtenir une clé APIDémarrage rapide
Installer la CLI
npm i -g ineveo
Modèles
699
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.

1# 1. Generate an image2curl -X POST https://ineveo.com/api/v1/api/catalog/generations \3  -H "Authorization: Bearer $INEVEO_API_KEY" \4  -H 'Content-Type: application/json' \5  -H "Idempotency-Key: $(uuidgen)" \6  -d '{7  "modelId": "luma/uni-v1/text-to-image",8  "inputs": {9    "prompt": "Neon city street after rain, cinematic night",10    "size": "16:9"11  }12}'13 14# 2. Poll with the generation id from step 1 until its status is succeeded15curl https://ineveo.com/api/v1/api/catalog/generations/$ID \16  -H "Authorization: Bearer $INEVEO_API_KEY"17 18# 3. Download the file19curl https://ineveo.com/api/v1/api/catalog/generations/$ID/content \20  -H "Authorization: Bearer $INEVEO_API_KEY" \21  -o result.jpeg
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 INEVEO_API_KEY="YOUR_API_KEY"
  2. 02Installez la CLIUne seule commande : npm i -g ineveo. Elle lit votre clé dans INEVEO_API_KEY.npm i -g ineveo
  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.ineveo run luma/uni-v1/text-to-image -p "violet neon fox" -o ./out/
[03] CLI

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
ineveo models --type videoTous les modèles vidéo avec leur prix de départ
ineveo run <model> -hLes champs d'un modèle, en direct : type, valeur par défaut, valeurs autorisées
ineveo run <model> -p "<prompt>" -o ./out/Rendre et enregistrer le résultat dans un dossier
ineveo run <model> -p "..." --dry-runLe prix exact, sans rien dépenser
ineveo run <model> -p "..." --max-price 0.50Refuser de lancer si le prix est plus élevé
ineveo run <model> -p "..." --json -o ./out/Un résultat JSON, prêt pour l'étape suivante
ineveo 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 YOUR_API_KEY

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://ineveo.com/api/v1

Référence complète de l'API →
GET/api/catalog/meVotre clé et votre solde
GET/api/catalog/modelsTous les modèles
GET/api/catalog/models/detail?id=MODEL_IDUn modèle et ses champs
POST/api/catalog/quotePrix pour des entrées exactes
POST/api/catalog/generationsLancer un rendu
GET/api/catalog/generationsVos rendus récents
GET/api/catalog/generations/IDStatut d'un rendu
GET/api/catalog/generations/ID/contentLe fichier résultat
DELETE/api/catalog/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 est disponible sur npm. Les rendus échoués sont remboursés.

Obtenir une clé APIVoir les prix