L'API de face swap vidéo pour les workflows de production
Ajoutez le remplacement de visage soumis à autorisation à vos pipelines vidéo via l'API GoEnhance. Envoyez une vidéo cible, une image de visage source, les réglages de sortie et un segment minuté, puis conservez l'identifiant de tâche renvoyé et récupérez le résultat asynchrone.
Obtenir un accès API
Un contrat d'API de face swap vidéo bien délimité
Préparer la requête vidéo minutée
Envoyez reference_video comme clip cible et reference_img comme image de visage. La référence actuelle documente des tailles maximales de 200 MB et 5 MB, ainsi que les champs obligatoires start_time, end_time et upscaler.
Récupérer le résultat de façon asynchrone
Un envoi réussi renvoie data.img_uuid. Interrogez GET /api/v1/jobs/detail en polling ou fournissez un callback HTTPS public, traitez les états pending, processing, success et failed, puis inspectez les entrées de résultat typées avant d'enregistrer la vidéo finale.
Construisez votre intégration autour du contrat documenté : requête, tâche et résultat.
Les capacités qui comptent en production
Requêtes authentifiées par Bearer
Conservez la clé API GoEnhance sur votre serveur et transmettez-la dans l'en-tête Authorization. N'exposez jamais d'identifiants de production dans du code exécuté par le navigateur.
Rôles explicites pour chaque média
Utilisez <code>reference_video</code> pour le clip cible et <code>reference_img</code> pour le visage à transférer : vous évitez ainsi l'erreur courante d'inversion des entrées.
Médias sources plafonnés
Vérifiez que les médias sont accessibles avant l'envoi. La référence actuelle de l'endpoint documente un maximum de 200 MB pour la vidéo et de 5 MB pour l'image.
Segments de conversion minutés
Indiquez <code>start_time</code> et <code>end_time</code> entre 0 et 120 secondes, et vérifiez que l'intervalle choisi a du sens pour le clip source.
Réglages de sortie et d'amélioration
Choisissez <code>upscaler</code> 1 pour du 720p ou 2 pour du 1080p réservé aux VIP, et n'activez <code>enhance_face</code> que si votre workflow l'exige.
Résultats asynchrones typés
Conservez <code>img_uuid</code>, traitez tous les états terminaux, examinez les entrées de résultat par <code>type</code> et copiez la sortie réussie avant l'expiration des liens temporaires.
Prenez la page de facturation en direct et le solde du compte comme source de vérité.
Des tarifs d'API de face swap vidéo sans devinettes
Vérifier les tarifs en vigueur de l'API de face swap vidéo
La référence de l'endpoint documente des multiplicateurs de coût, mais pas de tarif de base fixe. Confirmez le montant de base actuel sur la page de facturation GoEnhance avant d'estimer vos dépenses.
Tenir compte des multiplicateurs optionnels
La référence actuelle signale la sortie 1080p et l'amélioration du visage comme des options au tarif 1.5x. Elle n'explique pas le calcul lorsque plusieurs options sont combinées : vérifiez donc le montant réellement facturé plutôt que de le supposer.
Surveiller les crédits et les budgets
Utilisez <code>GET /api/v1/user/tokens</code> pour lire <code>data.count</code>, puis ajoutez des plafonds par locataire, un journal des tâches et des alertes autour de vos tarifs API GoEnhance actuels.
Intégrer l'API GoEnhance en trois étapes
1
1. Valider l'autorisation et les médias
Confirmez le consentement et les droits d'usage, vérifiez que les deux URL sont accessibles, appliquez les limites de taille et de durée documentées, et rejetez les entrées non prises en charge ou ambiguës avant l'envoi.
2
2. Créer et conserver la tâche
Envoyez en POST les médias requis, la plage temporelle et le réglage de sortie vers
/api/v1/videofaceswap/generate ; vérifiez le succès au niveau HTTP et au niveau de la réponse, puis stockez data.img_uuid. 3
3. Suivre, contrôler et archiver le résultat
Faites du polling avec backoff ou vérifiez la réception des callbacks, aiguillez selon le statut terminal et le type de résultat, contrôlez la cohérence du visage et des images entre elles, puis déplacez le rendu validé vers un stockage durable.
Traitez le consentement, la transparence et le contrôle d'accès comme des exigences produit, pas comme un texte facultatif.
Des cas d'usage utiles, fondés sur l'autorisation
Déclinaisons de campagne consenties
Créez des variantes vidéo validées pour les talents, ambassadeurs ou clients qui ont expressément autorisé l'usage de leur image.
Prévisualisation cinématographique
Testez le casting ou la continuité des scènes avant la production finale, tout en conservant la relecture humaine et la validation des droits dans le workflow.
Production créative localisée
Adaptez des rushes validés à des campagnes régionales tout en conservant des autorisations sources traçables, une mention explicite et des traces de relecture.
Outils de divertissement en opt-in
Alimentez des expériences où les utilisateurs fournissent sciemment le clip cible et le portrait source, et comprennent que le résultat est synthétique.
Prototypes internes encadrés
Évaluez le cadrage et la direction créative sans présenter les images générées comme un événement authentique ou une véritable recommandation.
Applications média avec modération
Associez le face swap à des contrôles d'accès, un signalement des abus, des durées de conservation, des enregistrements de provenance et des étapes de validation.
Des réponses concrètes sur l'intégration, les tarifs, la gestion des tâches et l'usage responsable.