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 | 6 crédits / sortie | Un visage source et une image cible |
| Lot de photos | POST /api/ai-tasks/batch-face-swap | 6 crédits / sortie | Jusqu’à 20 images d’entrée au total ; 95 MB au total |
| Mapping de groupe | POST /api/ai-tasks/multi-face-swap | 6 crédits / visage sélectionné | Jusqu’à 10 visages mappés ; 95 MB au total |
| Vidéo | POST /api/ai-tasks/video | 3 crédit par seconde arrondie ; minimum 12 | MP4, MOV ou WebM ; 600 secondes ; niveau maximal 1080p fixe |
| GIF | POST /api/ai-tasks/gif | 3 crédit par seconde arrondie ; minimum 12 | 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.
Aucun champ de clé d'idempotence n'est documenté dans le contrat public. Le service appelant doit désactiver la soumission en double, conserver le premier ID de tâche et concilier une réponse réseau incertaine avant d'émettre un autre POST.
Cycle de vie des tâches
Conservez le taskId et arrêtez-vous à un état terminal
| Événement | Enregistrement de tâche | Action de crédit | Action client |
|---|---|---|---|
| Tâche acceptée | Conservez l'ID de tâche et le coût prévu | Traitez le règlement comme appartenant au serveur | Commencez l'interrogation mesurée |
| Tâche terminée | Résultat final | Le travail terminé reste réglé | Autorisez la récupération du résultat |
| Échec du traitement | Échec terminal | Le contrat actuel rembourse automatiquement les échecs de traitement | Lisez l'échec avant de décider de soumettre à nouveau |
| Résultat de la réponse incertain | Conciliez avant un autre POST | Ne devinez jamais à partir d'un délai d'attente | Utilisez l'ID de tâche stocké ou l'historique du compte |
Résultat de la réponse incertain Aucun champ de clé d'idempotence n'est documenté dans le contrat public. Le service appelant doit désactiver la soumission en double, conserver le premier ID de tâche et concilier une réponse réseau incertaine avant d'émettre un autre POST.
Coût, confidentialité et export
Intégrez des limites vérifiables
L’accès API exige un e-mail vérifié et au moins une commande de crédits PAID ou COMPLETED. Les crédits de récompense et d’essai sont réservés au parcours web connecté et ne peuvent pas être automatisés par API. Maximum 3 clés par compte et 6 requêtes de génération par minute et par clé. Les tâches échouées sont remboursées et les médias supprimés sous 24 heures.
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 6 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.