Développeurs · API v1

Une API.
Tous les modèles.

Images, vidéo, audio et 3D derrière une seule API, payés 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

BientôtLa CLI et les SDK arrivent bientôt. L'API REST ci-dessous fonctionne dès aujourd'hui.

Modèles
672
Endpoints
9
Recharge minimum
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://femimg.com/api/v1/api/catalog/generations \3  -H "Authorization: Bearer $FEMIMG_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://femimg.com/api/v1/api/catalog/generations/$ID \16  -H "Authorization: Bearer $FEMIMG_API_KEY"17 18# 3. Download the file19curl https://femimg.com/api/v1/api/catalog/generations/$ID/content \20  -H "Authorization: Bearer $FEMIMG_API_KEY" \21  -o result.jpeg
landing.dev.outputTitleluma/uni-v1/text-to-image
02 · Démarrage rapide

Votre premier rendu en trois étapes

  1. 01Créez une clé APIDans Réglages > Clés API, nommez une clé et copiez-la une fois. Rechargez dès 3 € dans Facturation.export FEMIMG_API_KEY="YOUR_API_KEY"
  2. 02Lancez un renduEnvoyez l'ID du modèle et ses entrées. Vous recevez aussitôt une génération au statut queued.POST /api/v1/api/catalog/generations
  3. 03Interrogez et téléchargezInterrogez la génération jusqu'au statut succeeded, puis téléchargez le fichier.GET /api/v1/api/catalog/generations/ID/content
03 · CLIBientôt

Générez depuis le terminal

Un outil en ligne de commande pour scripts, CI et agents de code est en route, avec les mêmes clés et le même solde que l'API. D'ici là, tous les appels de cette page fonctionnent avec curl.

Scripts et CIGénérez depuis n'importe quel shell, job ou cron.
Sortie JSONUn document JSON par exécution, prêt pour l'étape suivante.
Agents de codeVotre agent vérifie le prix d'abord et plafonne sa dépense.
04 · L'essentiel de l'API

Conçue pour la production

Authentification

Un jeton Bearer dans l'en-tête Authorization. Créez des clés dans Réglages.

Authorization: Bearer YOUR_API_KEY

Rendus en arrière-plan

Lancer un rendu répond aussitôt avec le statut queued. Interrogez-le jusqu'à succeeded, failed ou refunded.

{ "status": "queued" }

Le prix d'abord

Demandez le prix exact de vos entrées sans rien lancer. Tout montant est en centimes d'euro.

POST /api/v1/api/catalog/quote

Relances sûres

Envoyez un en-tête Idempotency-Key et une requête relancée ne facture jamais deux fois.

Idempotency-Key: render-042

Limites

Chaque clé a une limite de requêtes par minute. Au-delà, vous recevez une erreur 429.

429 Too Many Requests

Erreurs et remboursements

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

GET/api/catalog/meNom et limite de la clé, et votre solde
GET/api/catalog/modelsLe catalogue des modèles avec leurs prix
GET/api/catalog/models/detail?id=MODEL_IDUn modèle avec tous ses champs
POST/api/catalog/quoteLe prix exact d'un jeu d'entrées
POST/api/catalog/generationsLancez un rendu avec n'importe quel modèle
GET/api/catalog/generationsVos générations récentes
GET/api/catalog/generations/IDStatut, coût et résultat d'une génération
GET/api/catalog/generations/ID/contentTéléchargez le fichier terminé
DELETE/api/catalog/generations/IDSupprimez une génération

Rechargez 3 € et lancez-vous aujourd'hui

L'API et le studio partagent un seul solde. Un rendu qui échoue est remboursé.

Obtenir une clé APIVoir les tarifs