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.
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.
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 model sur ai_dance_replace ; il s'agit d'un champ de requête obligatoire.

Image de personne requise

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

Vidéo de danse requise

Passez video_url 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 480p ou 720p. La valeur par défaut documentée est 480p.

Livraison optionnelle de callback

Ajoutez une custom_callback_url 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 img_uuid ; 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

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

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

3. Construisez la requête

Définissez model: ai_dance_replace, ajoutez image_url et video_url, puis choisissez 480p ou 720p.
4

4. Soumettez la tâche

Envoyez le corps JSON à https://api.goenhance.ai/api/v1/videos/generations.
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

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

Quel endpoint l'API AI Dance Replace utilise-t-elle ?

Envoyez POST https://api.goenhance.ai/api/v1/videos/generations avec model: ai_dance_replace, une image_url publique et une video_url publique.

Comment fonctionne la tarification de l'API AI Dance Replace ?

La tarification est basée sur la durée de la vidéo d'entrée arrondie au supérieur : 2 tokens par seconde en 480p et 4 tokens par seconde en 720p, soit respectivement $0.20 et $0.40 par 5 secondes.

Quels champs sont requis ?

Les champs obligatoires documentés sont model, image_url et video_url. La résolution et l'URL de callback sont facultatives.

Combien de temps peut durer la vidéo de danse de référence ?

La durée maximale documentée est de 30 secondes. Validez la durée avant l’envoi, car les vidéos plus longues sont rejetées.

Quelles résolutions de sortie sont disponibles ?

L'endpoint accepte 480p et 720p. Si omis, la valeur par défaut documentée est 480p.

Comment puis-je vérifier l'état de la tâche ?

Conservez le img_uuid retourné et interrogez GET /api/v1/jobs/detail, ou fournissez une URL de rappel HTTPS publique.

Comment les échecs de callback sont-ils gérés ?

GoEnhance documente jusqu'à trois tentatives lorsque votre endpoint de callback ne renvoie pas HTTP 200, avec un délai d'attente de trois secondes pour chaque tentative.

Quelles permissions mon application doit-elle requérir ?

Utilisez uniquement des images et des vidéos de danse que vous êtes autorisé à traiter, et obtenez le consentement approprié des personnes identifiables dans les médias sources.

Développez avec l'API AI Dance Replace

Tarifs et intégration de l'API AI Dance Replace | GoEnhance