GoEnhance APIGoEnhance API

API de remplacement de danse IA pour vidéo pilotée par le mouvement

Accédez à ai_dance_replace via l'API GoEnhance pour remplacer la personne d'une vidéo de danse de référence par celle d'une image source, tout en conservant le mouvement de référence. Soumettez une tâche asynchrone, enregistrez son img_uuid, puis interrogez l'état ou utilisez des rappels pour connaître l'achèvement.
Obtenir la clé API
Danseur exécutant une performance dans un studio de production cinématographique pour les workflows de l'API AI Dance Replace

Créez des workflows de vidéo de danse avec remplacement de personne.

Définissez la personne de remplacement

Fournissez une image_url publique. La personne dans cette image devient le sujet utilisé dans la vidéo de danse générée. Validez donc l'URL avant de la soumettre.

Examiner l'image d'entrée
Configuration de capture de portrait pour une image de personne utilisée par une API de remplacement de danse

Piloter le mouvement à partir d'une vidéo de danse

Fournissez un video_url public contenant la danse de référence. La limite documentée est de 30 secondes ; les vidéos plus longues sont rejetées.

Examiner l'entrée vidéo
Danseur et caméra de cinéma capturant le mouvement pour un flux de travail de remplacement de danse par IA.
Vérifiez l'identifiant exact du modèle, les URL des médias et la résolution de sortie avant la soumission.

Capacités et entrées de l'API AI Dance Replace

Identifiant exact du modèle

Définissez <code>model</code> sur <code>ai_dance_replace</code> ; il s'agit d'un champ de requête obligatoire.

Image de personne requise

Transmettez <code>image_url</code> en tant qu'URI publique valide pour la personne qui apparaîtra dans le résultat.

Vidéo de danse requise

Passez <code>video_url</code> comme vidéo de référence publique ne dépassant pas la durée maximale documentée de 30 secondes.

Deux options de résolution

Choisissez <code>480p</code> ou <code>720p</code>. La valeur par défaut documentée est <code>480p</code>.

Livraison optionnelle de callback

Ajoutez une <code>custom_callback_url</code> HTTPS publique pour recevoir les mises à jour de traitement, de succès et d'échec.

Réponse de tâche asynchrone

Une soumission réussie renvoie <code>img_uuid</code> ; conservez-le pour les vérifications de statut et le traitement des résultats.
La facturation utilise la durée arrondie à l'unité supérieure de la vidéo d'entrée. Calculez le coût à partir de la résolution sélectionnée et des secondes facturées.

Tarification de l'API AI Dance Replace

Tarification 480p

2 jetons par seconde de vidéo d’entrée, soit $0.04 par seconde ou $0.20 pour 5 secondes, à raison de $0.02 par jeton.

Tarification 720p

4 jetons par seconde vidéo d'entrée, soit $0.08 par seconde, ou $0.40 pour 5 secondes à $0.02 par jeton.

Facturation basée sur la durée

La durée de la vidéo d'entrée est arrondie au supérieur pour la facturation ; estimez le coût en multipliant les secondes facturées par le tarif sélectionné.

Intégrez l'API GoEnhance en six étapes

1. Créez une clé API
1

1. Créez une clé API

Créez une clé API GoEnhance et envoyez-la en tant que bearer token dans l'en-tête Authorization.
2. Validez les deux URL des médias
2

2. Validez les deux URL des médias

Confirmez que l'image de la personne et la vidéo de danse sont accessibles publiquement et que la vidéo ne dépasse pas 30 secondes.
3. Construisez la requête
3

3. Construisez la requête

Définissez model: ai_dance_replace, ajoutez image_url et video_url, puis choisissez 480p ou 720p.
4. Soumettez la tâche
4

4. Soumettez la tâche

Envoyez le corps JSON à https://api.goenhance.ai/api/v1/videos/generations.
5. Persistez et suivez
5

5. Persistez et suivez

Enregistrez l'img_uuid renvoyé, puis interrogez GET /api/v1/jobs/detail ou recevez les événements de callback.
6. Gérer les états terminaux
6

6. Gérer les états terminaux

Traitez les cas de succès et d'échec de manière idempotente, vérifiez la ressource renvoyée et évitez de dupliquer le travail en aval.
Obtenir la clé API
Utilisez un pipeline média tenant compte du consentement pour les outils pour créateurs, la production de campagnes et l'automatisation vidéo répétable.

Cas d'utilisation pour les développeurs de la vidéo de remplacement de danse

Modèles de danse pour créateurs

Permettez aux utilisateurs d'appliquer une image de personne approuvée à une danse de référence sous licence dans un parcours de création guidé.

Variantes de vidéo de campagne

Générer des variantes du sujet à partir des médias sources approuvés pour examen interne et édition en aval.

Tests de performance des personnages

Découvrez comment une image de personnage fournie suit une référence de mouvement existante avant la production.

Ressources de créateurs localisées

Réutiliser une référence de danse approuvée avec différents sujets autorisés pour les pipelines de contenu régionaux.

Files d'attente automatisées de contenu

Connectez les identifiants de tâches et les callbacks à l'orchestration par lots sans bloquer le fil d'exécution de votre requête applicative.

Prototyper des expériences de mouvement

Validez un concept de produit combinant image et mouvement avant d'investir dans un pipeline de capture personnalisé.
Réponses aux questions courantes sur les entrées, la tarification, le statut, les callbacks et l'intégration.

FAQ de l'API AI Dance Replace

Développez avec l'API AI Dance Replace

Créer une clé API
Tarifs et intégration de l'API AI Dance Replace | GoEnhance