img_uuid retornado e trate o resultado assíncrono por polling ou callback HTTPS.AI Dance Move API
Use a API AI Dance Move por meio do GoEnhance para animar a pessoa em uma imagem de origem com o movimento de um vídeo de dança de referência. Envie ambas as URLs públicas, escolha 480p ou 720p, salve o
Criar uma API Key
Anime um retrato com movimento de dança de referência
Uma imagem de origem define o bailarino
Envie um image_url público obrigatório. A pessoa nessa imagem se torna o sujeito do vídeo de dança gerado; portanto, use uma imagem de corpo inteiro clara e sem obstruções quando a legibilidade do movimento for importante.
Um vídeo de referência fornece o movimento
Envie um video_url público obrigatório contendo o movimento de dança a ser seguido. O comprimento máximo documentado do vídeo de entrada é de 30 segundos; referências mais longas são rejeitadas.
Valide as URLs de origem, duração, resolução e o tratamento de conclusão antes do envio.
Recursos e limites da API AI Dance Move
Identificador exato do modelo
Defina <code>model</code> como <code>ai_dance_move</code> para esta rota.
Duas URLs de mídia obrigatórias
Forneça tanto o <code>image_url</code> da pessoa quanto o <code>video_url</code> da dança de referência.
Limite de entrada de 30 segundos
Os vídeos de dança de referência não podem exceder 30 segundos; entradas mais longas são rejeitadas.
Saída em 480p ou 720p
Escolha <code>480p</code> ou <code>720p</code>. O padrão documentado é <code>480p</code>.
ID da tarefa assíncrona
Um envio bem-sucedido retorna <code>data.img_uuid</code>, não o vídeo finalizado.
Polling ou callbacks
Consulte o endpoint de detalhes da tarefa ou forneça uma URL de callback HTTPS pública para mudanças de status.
O GoEnhance cobra cada segundo arredondado para cima do vídeo de referência de entrada, na resolução de saída selecionada.
Preços da API AI Dance Move
480p: 2 tokens por segundo
Uma entrada de cinco segundos equivale a 10 tokens, com preço listado como $0.20 na documentação atual do GoEnhance.
720p: 4 tokens por segundo
Uma entrada de cinco segundos equivale a 20 tokens, com preço listado como $0.40 na documentação atual do GoEnhance.
Estime pela duração da entrada
Arredonde a duração do vídeo de entrada para o próximo segundo inteiro e multiplique por 2 tokens para 480p ou 4 tokens para 720p. Consulte a referência de preços em tempo real antes de lotes de produção.
Integre a API AI Dance Move em seis etapas
1
1. Crie e proteja uma API key
Crie uma chave GoEnhance e envie a autorização a partir de um código de servidor confiável.
2
2. Hospede a mídia de origem
Forneça URLs publicamente acessíveis para uma imagem de pessoa e um vídeo de dança de referência com no máximo 30 segundos.
3
3. Construa a solicitação
Envie um POST para
https://api.goenhance.ai/api/v1/videos/generations com model: ai_dance_move, ambas as URLs e resolução 480p ou 720p. 4
4. Salve o identificador da tarefa
Confirme o sucesso no nível da resposta e persista o
data.img_uuid retornado antes de sair do manipulador da solicitação. 5
5. Acompanhe cada status
Consulte
GET /api/v1/jobs/detail periodicamente ou receba eventos de processamento, sucesso e falha em uma URL de callback HTTPS pública. 6
6. Trate o resultado final
Processe sucesso e falha de forma idempotente, verifique a mídia retornada e evite trabalho duplicado nas etapas seguintes quando polling e callbacks se sobrepuserem.
Crie fluxos de trabalho controlados de transferência de movimento com base em mídia de origem que você está autorizado a usar.
Casos de uso da API AI Dance Move
Clipes de dança para criadores
Transforme um retrato de corpo inteiro aprovado em um conceito curto de dança orientado por uma rotina de referência escolhida.
Estudos de movimento de personagens
Teste como um personagem original ou performer é percebido em movimento antes de uma produção maior.
Variantes de conceito de campanha
Parametrize imagens de origem e referências de coreografia aprovadas para filas de revisão criativa.
Pré-visualização de videoclipe
Explore a direção de dança e o enquadramento antes de dedicar tempo a uma gravação ou edição final.
Criativos sociais localizados
Execute ativos de origem regionais por um pipeline validado de envio e conclusão.
Fluxos de trabalho automatizados de mídia
Conecte geração, persistência de estado da tarefa, manipulação de callbacks, armazenamento e aprovação humana no seu aplicativo.
Respostas sobre entradas, preços, duração, resolução e entrega assíncrona.