Communitygithub.com

ai-dance-video

Permet d'animer un portrait avec une chorégraphie prédéfinie Danceo, de créer une vidéo de danse, de choisir un modèle de référence et de vérifier l'état d'un rendu. Nécessite le serveur MCP Danceo et une clé API.

Qu'est-ce que ai-dance-video ?

La compétence **ai-dance-video** transforme une photo en vidéo de danse en utilisant le service Danceo. Elle est idéale pour les développeurs qui intègrent l'API Danceo via un serveur MCP. La compétence gère la sélection du portrait (URL HTTPS publique), la vérification des crédits disponibles, la sélection d'un modèle de danse parmi les templates prédéfinis, la demande de confirmation pour les rendus payants (80 crédits par seconde), le suivi asynchrone du job via `get_video_status` et la restitution de l'URL de la vidéo finale. Elle fonctionne sur des plateformes supportant les outils MCP (Claude Code, Cursor, Codex, etc.) et respecte les règles de consentement pour l'utilisation de l'image d'une personne.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jasonliu119/danceo-ai-dance-mcp-skills/tree/main/skills/ai-dance-video

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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

  1. 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.
  2. Appelez get_credits avant de lancer un rendu. Signalez le solde retourné ; ne supposez pas que le compte dispose de crédits d'essai.
  3. Appelez list_dance_templates et choisissez un modèle qui correspond au mouvement demandé. Utilisez son id exactement tel que retourné.
  4. 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.
  5. 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_video qu'après cette confirmation.
  6. Conservez le job_id retourné. Appelez get_video_status à un intervalle raisonnable jusqu'à ce que le statut soit success ou failed. 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_credits et renvoyez vers la tarification Danceo.
  • Pour un modèle inconnu, appelez à nouveau list_dance_templates et 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

Skills associés