Vidéo de danse IA avec Danceo
Utilisez Danceo lorsque l'utilisateur demande d'animer un portrait avec un mouvement de danse issu de l'un des modèles de référence disponibles de Danceo. Ce flux de travail crée un rendu et consomme des crédits du compte attaché à la clé API configurée.
Flux de travail
- Demandez quelle image portrait utiliser si l'utilisateur n'a pas fourni une URL HTTPS publique accessible. Confirmez qu'il a l'autorisation de transformer l'image et les traits du visage.
- Appelez
get_creditsavant de lancer un rendu. Signalez le solde retourné ; ne supposez pas que le compte dispose de crédits d'essai. - Appelez
list_dance_templateset choisissez un modèle qui correspond au mouvement demandé. Utilisez sonidexactement tel que retourné. - Confirmez que la durée de sortie demandée est comprise entre 5 et 30 secondes et ne dépasse pas celle de la référence sélectionnée. Pour un modèle de chat, fournissez le nombre de portraits spécifié par
imageCount; pour une personne ou un chien, fournissez un seul portrait. - Estimez le rendu à 80 crédits par seconde de sortie demandée selon la tarification actuelle de l'API. Vérifiez que le solde du compte peut le couvrir, puis demandez une confirmation sauf si l'utilisateur a déjà clairement autorisé un rendu payant. N'appelez
create_dance_videoqu'après cette confirmation. - Conservez le
job_idretourné. Appelezget_video_statusà un intervalle raisonnable jusqu'à ce que le statut soitsuccessoufailed. Retournez l'URL de la vidéo en cas de succès, ou l'erreur du service et la prochaine étape en cas d'échec.
Limites d'entrée
- Les portraits doivent être accessibles publiquement via HTTPS.
- L'API accepte les références Danceo de showcase retournées par
list_dance_templates; elle n'accepte pas les URL de vidéo de référence arbitraires. - La durée de sortie doit être un entier entre 5 et 30 secondes et ne doit pas dépasser la durée de la référence sélectionnée. Le service peut imposer une durée maximale plus courte pendant que le traitement des vidéos longues est indisponible.
- Le coût actuel du rendu API est de 80 crédits par seconde de sortie demandée. Danceo indique le coût final dans la réponse de création et débite le solde du propriétaire de la clé API. Les rendus échoués suivent la politique de restauration de crédits de Danceo.
Bonnes pratiques
- Utilisez un portrait net et bien éclairé, avec le visage et le sujet clairement visibles.
- Choisissez une référence dont le cadre et le mouvement conviennent au portrait.
- Respectez l'identité, la pose et la direction visuelle demandées par l'utilisateur dans la mesure où elles sont compatibles avec la chorégraphie de la référence.
- Ne créez pas d'usurpation d'identité trompeuse et ne transformez pas l'image d'une personne sans autorisation. Respectez la vie privée, les droits d'auteur et les règles de la plateforme.
Erreurs
- Pour une clé invalide, dirigez l'utilisateur vers les paramètres de clé API Danceo.
- Pour des crédits insuffisants, vérifiez le solde avec
get_creditset renvoyez vers la tarification Danceo. - Pour un modèle inconnu, appelez à nouveau
list_dance_templateset utilisez un ID retourné. - Si un job reste en attente ou en cours de traitement, continuez à interroger à un intervalle raisonnable ; ne créez pas de jobs en double sauf si l'utilisateur le demande.
Liens
- Guide produit et MCP : https://danceo.ai/mcp
- Tarification : https://danceo.ai/pricing