Communitygithub.com

ai-dance-video

Use quando alguém quiser criar um vídeo de dança com IA a partir de um retrato, animar uma foto com uma dança, escolher um modelo de dança de referência ou verificar uma renderização do Danceo. Requer o servidor MCP Danceo Video e uma chave de API.

O que é ai-dance-video?

O skill 'ai-dance-video' permite que agentes de IA criem vídeos de dança a partir de retratos usando o serviço Danceo. Com ele, é possível animar fotos de pessoas, gatos ou cachorros com movimentos de dança predefinidos, bastando fornecer uma imagem de retrato acessível por HTTPS e selecionar um template de dança da lista disponível. O skill gerencia todo o fluxo de renderização: consulta o saldo de créditos, seleciona o template adequado, verifica se a duração solicitada está dentro dos limites (5 a 30 segundos), calcula o custo (80 créditos por segundo de saída), confirma com o usuário se houver custo, dispara a renderização via API e monitora o progresso até o vídeo ficar pronto. No final, retorna a URL do vídeo renderizado ou informa o erro, se houver. É útil para aplicações de entretenimento, marketing e criação de conteúdo social automatizado, sempre respeitando permissões de uso da imagem e as regras da plataforma.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Vídeo de Dança com IA usando Danceo

Use o Danceo quando o usuário pedir para animar um retrato usando um movimento de dança de um dos modelos de referência disponíveis no Danceo. Este fluxo de trabalho cria uma renderização e gasta créditos da conta associada à chave de API configurada.

Fluxo de trabalho

  1. Pergunte qual imagem de retrato usar se o usuário não tiver fornecido uma URL de imagem HTTPS publicamente acessível. Confirme se ele tem permissão para transformar a imagem e a semelhança.
  2. Chame get_credits antes de iniciar uma renderização. Informe o saldo retornado; não presuma que a conta possui créditos de teste.
  3. Chame list_dance_templates e escolha um modelo que corresponda ao movimento solicitado. Use seu id exatamente como retornado.
  4. Confirme se a duração de saída solicitada está entre 5 e 30 segundos e não é maior que a duração do modelo selecionado. Para um modelo de gato, forneça a quantidade de retratos especificada por imageCount; para pessoa ou cachorro, forneça um retrato.
  5. Estime o custo da renderização em 80 créditos por segundo de saída solicitado, com base no preço atual da API. Verifique se o saldo da conta pode cobri-lo e peça confirmação, a menos que o usuário já tenha autorizado claramente uma renderização paga. Chame create_dance_video somente após essa confirmação.
  6. Guarde o job_id retornado. Chame get_video_status em um intervalo razoável até que o status seja success ou failed. Retorne a URL do vídeo em caso de sucesso, ou o erro do serviço e o próximo passo em caso de falha.

Limites de entrada

  • Os retratos devem ser publicamente acessíveis via HTTPS.
  • A API aceita referências de showcase do Danceo retornadas por list_dance_templates; ela não aceita URLs de vídeos de referência arbitrários.
  • A duração de saída deve ser um número inteiro de 5 a 30 segundos e não deve exceder a duração do modelo selecionado. O serviço pode impor um máximo menor enquanto o processamento de vídeos longos não estiver disponível.
  • O custo atual de renderização da API é de 80 créditos por segundo de saída solicitado. O Danceo informa o custo final na resposta de criação e debita o saldo do proprietário da chave de API. Renderizações com falha seguem o comportamento de restauração de créditos do Danceo.

Boas práticas

  • Use um retrato nítido e bem iluminado, com o rosto e o sujeito claramente visíveis.
  • Escolha uma referência com enquadramento e movimento que se adequem ao retrato.
  • Mantenha a identidade, pose e direção visual solicitadas pelo usuário, quando compatíveis com a coreografia de referência.
  • Não crie falsificações enganosas nem transforme a imagem de uma pessoa sem permissão. Respeite privacidade, direitos autorais e as regras da plataforma.

Erros

  • Para uma chave inválida, direcione o usuário para as configurações de chave de API do Danceo.
  • Para créditos insuficientes, verifique o saldo com get_credits e aponte para os preços do Danceo.
  • Para um modelo desconhecido, chame list_dance_templates novamente e use um ID retornado.
  • Se um trabalho permanecer pendente ou em processamento, continue verificando em um intervalo razoável; não crie trabalhos duplicados a menos que o usuário peça.

Links

Habilidades Relacionadas