API de transferência de movimento: coloque uma nova pessoa em qualquer vídeo

Você tem um vídeo que funciona. Agora quer o mesmo vídeo com outra pessoa: o seu próprio criador, um cliente ou alguém que ainda não existe. A API do Hermoso faz isso em um só pedido. Envie o vídeo e a pessoa, e a nova pessoa faz cada movimento, expressão e forma da boca do original, nas mesmas batidas e cortes, no mesmo ambiente e com a mesma luz. O som original continua.

Leia a documentação da API →

Como é uma chamada?

Envie o vídeo e quem deve aparecer nele. Com "dry_run": true nada roda, e a resposta é o preço exato.

curl -sX POST https://app.hermoso.ai/v1/recasts \
  -H "Authorization: Bearer hmk_..." \
  -H 'content-type: application/json' \
  -d '{
    "video": "https://www.tiktok.com/@someone/video/7400000000000000000",
    "person": { "describe": "a woman in her 30s, curly dark hair, denim jacket" },
    "dry_run": true
  }'

Envie o mesmo pedido sem "dry_run": true e ele começa. Você recebe uma tarefa na hora, e o vídeo pronto quando terminar: minutos para um clipe curto, mais tempo para um longo.

Quem você pode colocar no vídeo?

• O seu criador salvo, ou um dos criadores de IA prontos, pelo id.
• Uma foto da pessoa, por link.
• Uma pessoa de IA a partir das suas palavras. Descreva a pessoa (idade, cabelo, estilo, jeito) e o Hermoso cria a pessoa primeiro e depois coloca no vídeo. Ela fica na sua Biblioteca, então você pode usar de novo.

Quer que a voz também seja diferente? Adicione uma nova voz com as mesmas palavras e o mesmo tempo, ou faça a pessoa falar outro idioma com a boca ajustada às novas palavras. É o mesmo pedido e a mesma tarefa.

Quais vídeos funcionam?

Um link do TikTok, Reel, Facebook, X ou YouTube, um link para um arquivo de vídeo ou um arquivo que você enviou ao Hermoso. Uma chamada cobre até 60 segundos, e você pode escolher um trecho com início e fim.

Quanto custa?

Depende da duração do vídeo e de você adicionar ou não uma nova voz, então nunca chutamos. Um teste sem execução dá o preço exato, etapa por etapa, antes de qualquer coisa rodar. A chamada real reserva esse valor e fecha no que a renderização realmente custou, nunca mais. Veja os preços para saber quanto vale um crédito.

Dá para trocar um objeto em vez de uma pessoa?

Sim. Um segundo endpoint muda uma coisa em um clipe a partir de uma instrução simples: "mude só a caneca para vermelho", "troque a garrafa pelo nosso produto", "deixe de noite". O movimento, o tempo e o enquadramento continuam. Adicione uma imagem do produto ou material real e a mudança fica igual a ele.

curl -sX POST https://app.hermoso.ai/v1/edits \
  -H "Authorization: Bearer hmk_..." \
  -H 'content-type: application/json' \
  -d '{ "video": "https://example.com/clip.mp4", "instruction": "change only the mug to red", "dry_run": true }'

Não sabe como vai ficar? Peça antes uma prévia de um único quadro. Você vê a mudança em uma imagem parada, com o preço do clipe inteiro ao lado, e o clipe só roda quando você mandar.

Feito para o seu backend

• Assíncrono. Uma chamada real responde na hora com uma tarefa. Consulte a tarefa, ou passe um link e enviamos o vídeo pronto.
• Seguro para repetir. Envie a mesma chave de idempotência de novo e você recebe a mesma tarefa, nunca uma segunda renderização.
• Recusas claras. Quando algo não pode rodar, você sabe o motivo antes de qualquer cobrança, com um código que o seu código pode usar para decidir.
• Uma só chave de API do app, a mesma que o servidor MCP e a linha de comando usam.

E pessoas reais?

Uma foto de uma pessoa real precisa de um plano pago, e ao enviá-la você confirma que tem a permissão dela. Uma pessoa de IA a partir das suas palavras, ou um criador de IA pronto, funciona em todos os planos. Pedidos que colocariam alguém em uma cena em que essa pessoa nunca deveria estar são recusados antes de qualquer coisa rodar.

Prefere clicar em vez de programar?

A mesma troca está no app, em trocar uma pessoa em um vídeo, e o seu agente de IA pode fazer isso por MCP. Os três usam o mesmo motor e custam o mesmo.

Perguntas frequentes

O que é uma API de transferência de movimento?

Ela recebe um vídeo e outra pessoa e devolve o vídeo com essa pessoa, fazendo exatamente o que a pessoa original fazia: os mesmos movimentos, expressões, tempo e cortes. A versão do Hermoso também mantém o som original e pode dar à nova pessoa uma nova voz ou um novo idioma.

Quanto custa trocar a pessoa de um vídeo?

Depende da duração do vídeo e de você adicionar uma nova voz. Envie o pedido com dry_run e você recebe o preço exato antes de qualquer coisa rodar. A chamada real nunca cobra mais do que isso.

Posso usar a foto de uma pessoa real?

Sim, em um plano pago e só com a permissão dessa pessoa. Ao enviar a foto você confirma que tem essa permissão. Uma pessoa de IA criada a partir de uma descrição, ou um criador de IA pronto, funciona em todos os planos.

Quanto tempo leva?

Depende da duração: minutos para um clipe curto, mais tempo para um longo ou com nova voz. A chamada responde na hora com uma tarefa, e você consulta a tarefa ou recebe o vídeo pronto em um link que escolher.

Posso mudar um objeto em vez de uma pessoa?

Sim. O endpoint de edições muda uma coisa em um clipe a partir de uma instrução simples, como mudar a cor de uma caneca ou trocar uma garrafa pelo seu produto, e deixa todo o resto como estava.