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
- 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.
- Chame
get_creditsantes de iniciar uma renderização. Informe o saldo retornado; não presuma que a conta possui créditos de teste. - Chame
list_dance_templatese escolha um modelo que corresponda ao movimento solicitado. Use seuidexatamente como retornado. - 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. - 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_videosomente após essa confirmação. - Guarde o
job_idretornado. Chameget_video_statusem um intervalo razoável até que o status sejasuccessoufailed. 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_creditse aponte para os preços do Danceo. - Para um modelo desconhecido, chame
list_dance_templatesnovamente 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
- Guia do produto e MCP: https://danceo.ai/mcp
- Preços: https://danceo.ai/pricing