GoEnhance APIGoEnhance API

API AI Dance Replace para vídeo orientado por movimento

Acesse ai_dance_replace pela API GoEnhance para substituir a pessoa em um vídeo de dança de referência pela pessoa de uma imagem de origem, mantendo o movimento de referência. Envie uma tarefa assíncrona, salve o img_uuid dela e faça polling ou use callbacks para saber quando concluir.
Obter chave de API
Dançarino em estúdio de produção cinematográfica para fluxos de trabalho da API AI Dance Replace

Crie fluxos de trabalho de vídeo de dança com substituição de pessoa

Definir a pessoa substituta

Forneça um image_url público. A pessoa nessa imagem torna-se o sujeito usado no vídeo de dança gerado; portanto, valide a URL antes do envio.

Revisar entrada de imagem
Configuração de captura de retrato para uma imagem de pessoa usada por uma API de substituição de dança

Direcionar o movimento a partir de um vídeo de dança

Forneça um video_url público contendo a dança de referência. O limite documentado é de 30 segundos; vídeos mais longos são rejeitados.

Revisar entrada de vídeo
Dançarino e câmera de cinema capturando movimento para um fluxo de trabalho de substituição de dança por IA
Valide o identificador exato do modelo, as URLs de mídia e a resolução de saída antes do envio.

Recursos e entradas da API AI Dance Replace

Identificador exato do modelo

Defina <code>model</code> como <code>ai_dance_replace</code>; é um campo obrigatório da solicitação.

Imagem de pessoa obrigatória

Passe <code>image_url</code> como um URI público válido para a pessoa que aparecerá na saída.

Vídeo de dança obrigatório

Passe <code>video_url</code> como um vídeo de referência público com no máximo 30 segundos, conforme documentado.

Duas opções de resolução

Escolha <code>480p</code> ou <code>720p</code>. O padrão documentado é <code>480p</code>.

Entrega opcional de callback

Adicione um <code>custom_callback_url</code> HTTPS público para receber atualizações de processamento, sucesso e falha.

Resposta de tarefa assíncrona

Um envio bem-sucedido retorna <code>img_uuid</code>; persista-o para verificações de status e tratamento do resultado.
A cobrança usa a duração arredondada para cima do vídeo de entrada. Calcule o custo com base na resolução selecionada e nos segundos cobrados.

Preços da API AI Dance Replace

Preços para 480p

2 tokens por segundo de vídeo de entrada, ou seja, $0.04 por segundo ou $0.20 por 5 segundos a $0.02 por token.

Preços para 720p

4 tokens por segundo de vídeo de entrada, equivalentes a $0.08 por segundo ou $0.40 por 5 segundos a $0.02 por token.

Cobrança baseada na duração

A duração do vídeo de entrada é arredondada para cima na cobrança; estime o custo como os segundos cobrados multiplicados pela tarifa selecionada.

Integre a API GoEnhance em seis etapas

1. Crie uma chave de API
1

1. Crie uma chave de API

Crie uma chave de API GoEnhance e envie-a como um token Bearer no cabeçalho Authorization.
2. Valide ambas as URLs de mídia
2

2. Valide ambas as URLs de mídia

Confirme que a imagem da pessoa e o vídeo de dança estão acessíveis publicamente e que o vídeo não tem mais de 30 segundos.
3. Monte a requisição
3

3. Monte a requisição

Defina model: ai_dance_replace, adicione image_url e video_url e escolha 480p ou 720p.
4. Envie a tarefa
4

4. Envie a tarefa

Envie o corpo JSON via POST para https://api.goenhance.ai/api/v1/videos/generations.
5. Persista e acompanhe
5

5. Persista e acompanhe

Salve o img_uuid retornado e consulte periodicamente GET /api/v1/jobs/detail ou receba eventos de callback.
6. Trate estados terminais
6

6. Trate estados terminais

Processe sucesso e falha de forma idempotente, verifique o ativo retornado e evite duplicar trabalho downstream.
Obter chave de API
Use um pipeline de mídia ciente de consentimento para ferramentas de criadores, produção de campanhas e automação repetível de vídeo.

Casos de uso para desenvolvedores do vídeo de substituição de dança

Modelos de dança para criadores

Permita que os usuários apliquem uma imagem de pessoa aprovada a uma dança de referência licenciada em um fluxo de criação guiado.

Variantes de vídeo para campanhas

Gere variantes de assunto a partir de mídia-fonte aprovada para revisão interna e edição downstream.

Testes de performance de personagem

Explore como uma imagem de personagem fornecida segue uma referência de movimento existente antes da produção.

Ativos localizados para criadores

Reutilize uma referência de dança aprovada com diferentes sujeitos autorizados para pipelines de conteúdo regionais.

Filas automatizadas de conteúdo

Conecte IDs de tarefa e callbacks à orquestração em lote sem bloquear o thread de requisição do seu aplicativo.

Prototipe experiências de movimento

Valide um conceito de produto de imagem-mais-movimento antes de investir em um pipeline de captura personalizado.
Respostas a perguntas comuns sobre entrada, preços, status, callback e integração.

FAQ da API AI Dance Replace

Desenvolva com a API AI Dance Replace

Criar chave de API
Preços e integração da API AI Dance Replace | GoEnhance