Référence API de production
API de face swap IA DeepSwapAI
Connectez le face swap de photos, lots, groupes, vidéos et GIF avec une interface de production commune. Consultez le contrat, les unités de coût, les états et les limites ; les champs et réponses complets sont dans la référence API en anglais.
Un contrat, cinq parcours
HTTPS, uploads multipart et états JSON
Toutes les routes de génération publiées utilisent une clé API Bearer, renvoient un taskId et consultent l’état par GET sur la même route.
Réponse directe
Un compte API pour cinq types d’entrée
Les photos, lots, mappings de plusieurs visages dans une photo de groupe, vidéos et GIF utilisent le même domaine de production et cycle de tâche. Avant la requête, vérifiez format, taille, durée, nombre de cibles et crédits ; après l’envoi, conservez le taskId et interrogez la route GET correspondante.
Contrat public actuel
Routes, unités de coût et limites principales
| Parcours | Route POST | Unité | Limite principale |
|---|---|---|---|
| Photo | POST /api/ai-tasks | 3 crédits / sortie | Un visage source et une image cible |
| Lot de photos | POST /api/ai-tasks/batch-face-swap | 3 crédits / sortie | Jusqu’à 20 images ; 95 MB au total |
| Mapping de groupe | POST /api/ai-tasks/multi-face-swap | 3 crédits / visage sélectionné | Jusqu’à 10 visages mappés ; 95 MB au total |
| Vidéo | POST /api/ai-tasks/video | 2 crédits par seconde arrondie ; minimum 6 | MP4, MOV ou WebM ; 300 secondes ; 720p ou 1080p |
| GIF | POST /api/ai-tasks/gif | 3 crédits par seconde arrondie ; minimum 6 | GIF, MP4 ou WebM ; 30 secondes |
Intégration minimale
Validez la requête avant de générer
- 1. Conservez la clé API côté serveur, jamais dans le navigateur, le paquet mobile, les logs ou un dépôt public.
- 2. Validez les champs multipart, formats, tailles, quantités, durée et crédits du parcours choisi.
- 3. Envoyez POST et conservez le taskId et le débit prévu.
- 4. Interrogez GET sur la même route jusqu’à COMPLETED, FAILED ou CANCELLED.
- 5. Livrez le résultat uniquement au compte propriétaire et supprimez les médias selon la règle publiée.
Coût, confidentialité et export
Intégrez des limites vérifiables
L’API utilise le même solde de crédits à l’achat unique que le produit web. Les tâches échouées sont remboursées automatiquement selon la règle actuelle. Avant le premier achat terminé, les images d’essai affichent DeepSwapAI.com et l’e-mail complet du compte ; l’achat ne concerne que les nouvelles images. Les médias importés et générés sont supprimés du serveur sous 24 heures et ne servent pas à entraîner les modèles IA.
Questions développeur
À vérifier avant la mise en ligne
L’API prend-elle en charge les webhooks ?
Pas encore. Conservez le taskId après POST et interrogez GET sur la même route jusqu’à l’état final.
Existe-t-il un SDK officiel ?
Aucun SDK officiel par langage n’est publié actuellement. HTTPS, Bearer, multipart et JSON fonctionnent avec tout client HTTP côté serveur.
Combien de crédits coûte une photo ?
Une photo, une sortie de lot ou un visage sélectionné dans une photo de groupe coûtent actuellement 3 crédits. La vidéo et le GIF utilisent les secondes arrondies et un minimum.
Puis-je mettre la clé API dans le frontend ?
Non. Conservez-la sur le serveur et ne l’écrivez pas dans les bundles du navigateur, binaires mobiles, logs, événements analytics ou tickets.
Validez l’intégration avec une tâche représentative
Testez champs, états, coût et livraison avec un média autorisé minimal avant de passer aux lots ou aux longues vidéos.