API d'échange de visages sur image pour les flux de production
Ajoutez le remplacement de visage basé sur le consentement aux pipelines d'image via l'API GoEnhance. Soumettez une image cible et un visage source, stockez l'ID de tâche renvoyé, puis interrogez ou recevez des rappels jusqu'à ce que le résultat atteigne un état final.
Obtenir l'accès à l'API
Un contrat d'API d'échange de visages sur image ciblé
Soumettez les deux images requises
Envoyez reference_img comme image cible et source_img comme image du visage. Les deux sont des URL d'image HTTPS requises, et la référence actuelle de l'API documente un maximum de 5 Mo pour chaque entrée.
Suivre l'achèvement sans blocage
Une soumission réussie renvoie un img_uuid. Interrogez GET /api/v1/jobs/detail ou fournissez une URL de rappel HTTPS publique et gérez explicitement les résultats en attente, en cours de traitement, réussis et échoués.
Construisez autour du contrat documenté de requête, de tâche et de résultat.
Des capacités qui comptent en production
Requêtes authentifiées par jeton Bearer
Gardez la clé API GoEnhance sur votre serveur et envoyez-la dans l'en-tête Authorization. N'exposez jamais les identifiants de production dans le code du navigateur.
Rôles explicites de cible et de source
Utilisez <code>reference_img</code> pour la composition cible et <code>source_img</code> pour le visage à transférer, afin d'éviter les erreurs courantes d'ordre d'entrée.
Validation des ressources HTTPS
Validez que les deux URL d'image sont accessibles par l'API et restent dans la limite documentée de 5 Mo avant de créer une tâche.
ID de tâche asynchrone
Conservez le <code>img_uuid</code> renvoyé afin que les travailleurs, les tentatives, les rappels et les vérifications de statut côté client fassent tous référence au même travail.
Interrogation ou rappels
Interrogez le point de terminaison des détails du travail avec un délai exponentiel, ou acceptez les rappels de changement de statut sur un point de terminaison HTTPS accessible publiquement.
Gestion des résultats typés
Inspectez chaque entrée de résultat par <code>type</code> au lieu de supposer que le premier élément est toujours une URL d'image, et copiez les sorties expirantes dans votre propre stockage approuvé.
Utilisez la tarification actuelle du compte et les données de solde comme source de vérité.
Tarification de l'API d'échange de visages sans approximation
Vérifier la tarification en direct de l'API d'échange de visages sur image
La référence actuelle du point de terminaison public ne publie pas de taux de jeton fixe par image. Confirmez le coût en direct sur la page de facturation de GoEnhance avant de prévoir les dépenses plutôt que de vous fier à un chiffre inventé ou obsolète.
Surveiller le solde de jetons
Utilisez <code>GET /api/v1/user/tokens</code> pour lire le solde disponible à partir de <code>data.count</code> et déclencher des alertes internes avant la soumission des tâches.
Définir des budgets au niveau de l'application
Enregistrez la création des tâches et les résultats finaux, plafonnez l'utilisation par locataire et réconciliez l'activité facturée avec la tarification de votre compte GoEnhance.
Intégrez l'API GoEnhance en trois étapes
1
1. Valider le consentement et les entrées
Confirmez que vous avez l'autorisation d'utiliser les deux visages, vérifiez l'accès HTTPS, appliquez la limite de taille de fichier documentée et rejetez les ressources non prises en charge ou ambiguës avant la soumission.
2
2. Créer et conserver la tâche
Envoyez les deux URL d'image via POST à
/api/v1/imagefaceswap/generate, vérifiez le succès au niveau HTTP et de la réponse, puis stockez le img_uuid renvoyé. 3
3. Résoudre et stocker le résultat
Interrogez avec un délai d'attente (backoff) ou vérifiez les livraisons de rappel, branchez sur le statut final et le type de résultat, puis déplacez la sortie réussie vers un stockage durable avant l'expiration des liens temporaires.
Traitez le consentement, la divulgation et le contrôle d'accès comme des exigences produit, et non comme des mentions facultatives.
Cas d'utilisation utiles basés sur les permissions
Personnalisation de campagne avec consentement
Générez des variantes créatives approuvées pour les talents, les ambassadeurs ou les clients ayant explicitement autorisé l'utilisation de leur image.
Film et prévisualisation
Créez des cadres conceptuels internes ou des aperçus de casting tout en conservant l'examen final et l'autorisation des droits dans le processus de production.
Flux de travail créatifs localisés
Adaptez les ressources visuelles approuvées pour les campagnes régionales tout en conservant les autorisations sources traçables et l'examen humain.
Expériences d'avatar et de profil
Propulsez des expériences d'avatar avec consentement où les utilisateurs fournissent sciemment à la fois l'image cible et le visage source.
Prototypage créatif
Testez les mises en page et les directions visuelles avant de commander la photographie finale, sans présenter de sortie synthétique comme un événement authentique.
Outils de médias modérés
Ajoutez l'échange de visages à des applications contrôlées avec des vérifications de consentement, des signalements d'abus, des règles de rétention et des portes de contrôle autour de la génération.
Réponses pratiques pour l'intégration, la tarification, la gestion des tâches et l'utilisation responsable.