API d'échange de visage
Ajoutez l'échange de visage sur photo et vidéo à votre propre produit avec une API REST simple. Envoyez une tâche, interrogez le résultat, récupérez une URL de sortie hébergée.
L'accès à l'API est inclus dans chaque offre d'abonnement. Les requêtes utilisent les mêmes crédits que l'application web : aucune facture API séparée.
Comment ça marche
1
Créez une clé API
Abonnez-vous à une offre, puis créez une clé dans votre tableau de bord, à la section Clés API. La clé n'est affichée qu'une seule fois, conservez-la en lieu sûr.
2
Envoyez vos fichiers
Demandez une URL d'import présignée, puis envoyez par PUT votre visage source et votre image ou vidéo cible.
3
Lancez et interrogez
Envoyez la tâche d'échange de visage, puis interrogez-la jusqu'à ce que le statut passe à succeeded, et téléchargez l'URL de sortie.
Authentification
Envoyez votre clé API dans l'en-tête x-api-key à chaque requête. Les clés appartiennent à votre compte et dépensent ses crédits. Gardez-les secrètes et renouvelez-les depuis le tableau de bord en cas de fuite.
x-api-key: adf_YOUR_API_KEYPoints de terminaison
POST /api/v1/uploads
Créez une URL d'import présignée pour un fichier source ou cible. Envoyez le fichier par PUT vers uploadUrl avec le même Content-Type, puis utilisez url dans la requête d'échange de visage. Types acceptés : JPEG, PNG, WebP, MP4, QuickTime, WebM.
curl -X POST https://aideepfake.io/api/v1/uploads \
-H "x-api-key: adf_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"fileName": "target.jpg", "contentType": "image/jpeg"}'
# → { "success": true, "data": { "uploadUrl": "...", "url": "https://...", "expiresIn": 600 } }
curl -X PUT "UPLOAD_URL_FROM_RESPONSE" \
-H "Content-Type: image/jpeg" \
--data-binary @target.jpgPOST /api/v1/face-swap
Démarrez une tâche d'échange de visage. Un échange sur image coûte 15 crédits et un échange sur vidéo coûte 20 crédits, les mêmes prix que l'application web. Réglez targetType sur image ou video. Champs facultatifs : faceEnhance, frameEnhance, watermark et targetDurationSeconds pour les vidéos.
curl -X POST https://aideepfake.io/api/v1/face-swap \
-H "x-api-key: adf_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"sourceUrl": "https://.../source.jpg",
"targetUrl": "https://.../target.jpg",
"targetType": "image"
}'
# → { "success": true, "data": { "taskId": "...", "creditsCost": 15 } }Limites vidéo : jusqu'à 300 secondes pour un échange simple, jusqu'à 90 secondes quand faceEnhance ou frameEnhance est activé. Un face_swapper_pixel_boost plus élevé divise les deux limites par son coût, jusqu'à 120 secondes pour un échange simple en 1024x1024.
GET /api/v1/face-swap/{taskId}
Interrogez le statut de la tâche. Le champ status passe de processing à succeeded ou failed. En cas de succès, outputUrl contient le résultat hébergé. Les tâches en échec sont remboursées automatiquement.
curl https://aideepfake.io/api/v1/face-swap/TASK_ID \
-H "x-api-key: adf_YOUR_API_KEY"
# → { "success": true, "data": { "taskId": "...", "status": "succeeded",
# "outputUrl": "https://...", "targetType": "image" } }GET /api/v1/credits
Consultez votre solde de crédits et votre offre avant d'envoyer des tâches.
curl https://aideepfake.io/api/v1/credits \
-H "x-api-key: adf_YOUR_API_KEY"
# → { "success": true, "data": { "credits": 1000, "subscriptionCredits": 985,
# "oneTimeCredits": 15, "planId": "...", "currentPeriodEnd": "..." } }Tarifs et quota
L'API n'a pas de grille tarifaire séparée. Chaque requête dépense les crédits de votre offre d'abonnement : 15 crédits par échange sur image et 20 crédits par échange sur vidéo, exactement comme dans l'application web. Votre quota mensuel de crédits est défini par votre offre.
Comparer les offresCodes d'erreur
| HTTP | Code | Signification |
|---|---|---|
| 401 | INVALID_API_KEY | La clé API est absente, invalide, désactivée ou expirée. |
| 403 | API_REQUIRES_SUBSCRIPTION | Le compte n'a pas d'abonnement actif. Abonnez-vous à une offre pour utiliser l'API. |
| 402 | INSUFFICIENT_CREDITS | Le compte n'a pas assez de crédits pour cette tâche. Passez à une offre supérieure ou achetez un pack de crédits. |
| 400 | VIDEO_TOO_LONG | La vidéo dépasse la limite de durée pour les options choisies. |
| 429 | RATE_LIMITED | Trop de requêtes. Ralentissez et réessayez après une courte attente. |
Questions fréquentes
Qui peut utiliser l'API d'échange de visage ?
Tout compte avec un abonnement actif. Les comptes gratuits peuvent utiliser l'application web, mais pas l'API.
Combien coûtent les requêtes API ?
La même chose que l'application web : 15 crédits par échange sur image et 20 crédits par échange sur vidéo. Les requêtes puisent dans le même solde de crédits que votre usage web.
L'API gère-t-elle l'échange de visage sur vidéo ?
Oui. Réglez targetType sur video. Les échanges vidéo simples acceptent jusqu'à 300 secondes ; les échanges avec amélioration du visage ou de l'image acceptent jusqu'à 90 secondes.
Comment récupérer le résultat ?
Interrogez GET /api/v1/face-swap/{taskId} jusqu'à ce que status vaille succeeded. La réponse contient un outputUrl avec le fichier de résultat hébergé.
Que se passe-t-il quand une tâche échoue ?
Les tâches en échec sont remboursées automatiquement. La réponse de statut contient un champ error avec la raison.
Que se passe-t-il à la fin de mon abonnement ?
Vos clés API cessent de fonctionner immédiatement. Elles refonctionnent dès que vous vous réabonnez : inutile de créer de nouvelles clés.
Commencez à développer
Créez votre clé API et lancez votre premier échange de visage en quelques minutes.
Créer une clé API