HeyGen

HeyGen Avatar IV

heygen-avatar-iv

Basta enviar uma única foto e um roteiro para gerar um vídeo de avatar falante com sincronização labial, expressões faciais e gestos, com suporte a saída em 1280p ou superior, ideal para apresentadores digitais e conteúdo de narração em vídeo

heygen-avatar-iv

Experimentar heygen-avatar-iv

Entrada

Criações

Ver todas as criações

Saída

video

Preencha os parâmetros e gere — os resultados aparecerão aqui.

Preços

heygen-avatar-iv per second

Preço unitário	$0.150

Visão geral do posicionamento

heygen-avatar-iv é um modelo de vídeo de avatar falante oferecido pela HeyGen, acessível por meio da interface unificada do HiAPI.ai. O desenvolvedor envia uma foto frontal de rosto e fornece um roteiro de texto ou um áudio para gerar um vídeo falante com sincronização labial, expressões faciais e gestos. Suporta saída em 720p e 1080p e várias proporções de tela, sendo adequado para desenvolvedores e equipes de conteúdo que precisam produzir rapidamente porta-vozes digitais ou material de locução de personagens.

Destaques principais

Uma única foto gera todo o vídeo falante — basta uma foto frontal junto com um roteiro ou áudio, sem necessidade de gravação ou criação de ativos 3D para obter o vídeo final.
Expressões e gestos acompanham a fala — a saída vai além da sincronização labial: expressões faciais e movimentos de cabeça variam naturalmente com a fala, aproximando-se da aparência de uma locução real.
Entrada dupla: roteiro de texto e áudio — é possível preencher diretamente o roteiro e escolher a voz, ou enviar um áudio HTTPS para sincronização labial, adaptando-se a fluxos de dublagem existentes.
Proporção e fundo configuráveis — oferece proporções como 16:9, 9:16 e 1:1, além de permitir preencher o quadro com fundo de cor sólida ou imagem.

Descrição das capacidades

Gerar vídeo falante a partir de foto: envie uma foto frontal de rosto para gerar um vídeo falante; a saída é um arquivo de vídeo, utilizável diretamente como peça final ou em edição posterior.

Converter roteiro em fala e conduzir a boca: preencha o texto do roteiro e especifique uma voz integrada; o modelo sintetiza a fala e conduz o avatar, com roteiro de até 5000 caracteres por segmento.

Sincronização labial com áudio: envie um link de áudio HTTPS para que a foto fale conforme a boca do áudio, com até 600 segundos por segmento de áudio; nesse caso, os parâmetros de roteiro e voz não têm efeito.

Controle de especificação de saída: escolha resolução de 720p ou 1080p e defina proporção 16:9, 9:16, 4:5, 5:4, 1:1 ou seguir a imagem original, adaptando-se a posições de publicação horizontais, verticais e quadradas.

Preenchimento de fundo do quadro: quando a proporção de saída difere da proporção da foto, é possível preencher as áreas vazias com cor sólida ou imagem de fundo, evitando bordas vazias na imagem.

Cenários de aplicação

Equipes de marketing produzindo vídeos de porta-voz digital — usar roteiros de produto com fotos de personagens da marca para gerar vídeos de locução, destinados ao site, espaços publicitários e mídias sociais, sem necessidade de agendar presença real.
Departamentos de treinamento gerando materiais de cursos explicativos — transformar apostilas de curso em roteiros e gerar em lote vídeos explicativos com imagem uniforme, incorporando-os a plataformas de aprendizagem ou materiais didáticos.
Criadores de vídeos curtos produzindo locuções verticais — escolher proporção 9:16 e voz selecionada para gerar material de locução vertical, usado diretamente na atualização de conteúdo de plataformas de vídeos curtos.
Adaptação multilíngue de conteúdo com dublagem existente — enviar áudios de dublagem já existentes para sincronização labial e gerar, com fotos, imagens de locução no idioma correspondente, para localização de conteúdo.

Limitações e recomendações de escolha

A foto de entrada deve ser um rosto claro e frontal; perfis, obstruções ou fotos de grupo afetam significativamente o resultado, e a qualidade da geração depende bastante da imagem de origem. A saída é um vídeo, não um texto finalizado, sendo necessário preparar previamente o roteiro ou o áudio. O limite é de 600 segundos por segmento de áudio e 5000 caracteres por roteiro; conteúdos mais longos precisam ser gerados em partes. Se for necessário apenas um avatar predefinido ou um gêmeo digital de pessoa real, deve-se escolher a linha de outro modelo correspondente.

Novidades

Ver o changelog →

Novo modelo Novo modelo: heygen-avatar-iv, envie uma foto de retrato e gere um vídeo de fala com sincronização labial usando um roteiro e uma voz predefinida ou áudio de condução; oferece… Oct 6, 2026

Perguntas frequentes

Ver todas as perguntas →

Quais entradas o HeyGen Avatar IV requer?

Uma foto de retrato e a escolha de um modo de condução: inserir o texto do roteiro e selecionar uma voz, ou enviar um arquivo de áudio. Ao usar o roteiro sem selecionar uma voz, será usada a voz padrão Warm Pro Narrator.
Que tipo de foto tem o melhor resultado?

Fotos individuais de rosto frontal, com traços faciais nítidos e sem obstruções, iluminação uniforme e boca naturalmente fechada têm o resultado mais confiável. Fotos de perfil, com máscara, em grupo ou com o rosto muito pequeno não são adequadas.
Qual é a duração do vídeo gerado?

Não é necessário informar a duração. Ao dublar falas, a duração é determinada pelo texto e pela velocidade da fala; no modo de áudio, a duração corresponde à do áudio enviado, com limite máximo de 600 segundos.
Quais proporções e resoluções são suportadas?

As proporções suportadas são 16:9, 9:16, 4:5, 5:4, 1:1 e auto (mantém a proporção da foto); as resoluções suportadas são 720p e 1080p.

Criar uma tarefa de geração

POST https://api.hiapi.ai/v1/tasks

Cabeçalhos

AuthorizationstringObrigatório

Chave de API da conta. Obrigatória em toda requisição. Exemplo: Bearer YOUR_HIAPI_API_KEY. Obter chave de API

Content-TypestringOpcional

O corpo da requisição é sempre interpretado como JSON; se enviado, apenas application/json (charset opcional) é aceito — qualquer outro valor retorna 415. Exemplo: application/json.

Idempotency-KeystringOpcional

Chave de idempotência, até 255 bytes. Retries com a mesma chave da mesma conta criam a tarefa apenas uma vez; replays retornam o taskId original.

Chave de idempotência

Em timeouts de rede ou retries automáticos do cliente, a mesma chave cria a tarefa apenas uma vez, sem cobrança duplicada (escopo = a conta da chave de API). Use um identificador de negócio exclusivo (ex.: "order-42"); replays retornam o taskId original e as chaves expiram 24 h após a primeira requisição. A matriz completa de cenários está na introdução da API assíncrona unificada.

Corpo

modelstringObrigatório

Valor fixo atual: heygen-avatar-iv

routestringOpcional

Valor fixo atual: default

inputobjectObrigatório

Objeto de parâmetros de negócio para heygen-avatar-iv e a rota default — veja a tabela de parâmetros abaixo.

voicestringOpcionalPadrão: "Warm Pro Narrator"minLength 1

Especifica o timbre de voz usado para a locução do script do avatar digital; o padrão é Warm Pro Narrator. Quando audio_url é fornecido, este parâmetro é ignorado.

Opções:Warm Pro NarratorChill BrianIvyJohn DoeMonika SogamHope Archer Brittney

Mostrar tudo (94)

PatrickDavid CastlemoreMichael CAdam Stone JuniperCassidy Jessica Anne BogartArabellaAndrewSpuds Oxley Grace ElderHelenCanyon RiversDerya - Lifelike - ExcitedMellow MarcusJack Sterling - BroadcasterBrenda - UGC - 1.mp4ReidReaganTerryJennyRadio RickDeniseTim in car - ExcitedIskanderThompsonDelicate Daisy - ExcitedKingstonGeorge UGC 1Bold BlakeJaneExpressive EvanMarianne - IAAaronModern Recipe Host - Voice 1WillowCute Chloe - FriendlyRafaelJune - LifelikeCrisp ChloeSlick SimonNassim - InformativeBaritone BenMaxwellEllie Faye - ExcitedMilaniFeisty Fiona - ExcitedProfessor DeanRose - UGC - 1.mp4ShonaHudson WilderAnn - IAAlastair KensingtonOxleyChristinaAndrew Rizz PeytonGerardo - OutdoorChloe - LifelikeStephanieAnthony - IASignal - Voice 1LucaLisa - Voice 1T.W.TuckerJack Sullivan - SeriousWinterMireia - LifelikeGeorgiaStellaMasha - LifelikeCharming Charles - FriendlySerenityAnnie - ExcitedRalphBethanyDominicMason FinnLeenaVeteran VictorTamaraNik PublicCalm ChloeSevikReillyRaulImposing IanRelaxed RayDexter - ProfessionalRelaxed RickEdwinRupert BlackwoodGinnyHope

promptstringOpcionalminLength 1maxLength 5000

O texto do script que o avatar digital irá ler; obrigatório quando audio_url não é fornecido.

audio_urlstringOpcionalpattern ^https://

Endereço HTTPS do áudio usado para sincronização labial, com duração máxima de 600 segundos; quando fornecido, prompt e voice são ignorados.

image_urlstringObrigatóriopattern ^https://

Endereço HTTPS da foto a ser animada, que deve conter um único rosto nítido e frontal, nos formatos jpg, jpeg, png, webp, gif, avif, heic e heif.

backgroundobjectOpcional

Configuração de fundo usada para preencher as áreas da imagem não cobertas pelo retrato quando a proporção de tela da saída difere da foto original; pode ser especificada por cor ou imagem, com padrão branco.

typestringObrigatório

O modo de preenchimento do fundo, que determina se o campo value é interpretado como cor ou como URL de imagem.

Opções:colorimage

valuestringObrigatóriominLength 1

O valor concreto do fundo: quando type é cor, informe um valor hexadecimal #RRGGBB; quando type é imagem, informe um endereço HTTPS de imagem.

resolutionstringOpcionalPadrão: "720p"

A resolução do vídeo de saída; o padrão é 720p.

Opções:720p1080p

aspect_ratiostringOpcionalPadrão: "16:9"

A proporção de tela do vídeo de saída; o padrão é 16:9; quando definido como auto, prioriza-se manter a proporção da foto de origem e, se não for possível lê-la, recorre-se a 16:9.

Opções:16:99:164:55:41:1auto

callbackobjectOpcional

Configuração de notificação de estado terminal. Se omitida, sem callback: consulte a tarefa por conta própria.

Callbacks (Webhook)

Informe callback.url na criação e o HiAPI fará POST no seu serviço no estado terminal, sem polling. O corpo do callback replica a estrutura do detalhe da tarefa; assinatura, retries e idempotência estão descritos na introdução da API assíncrona unificada.

urlstringObrigatório

Obrigatória se callback estiver presente. No estado terminal é enviado um POST para esta URL; deve ser uma URL http(s) válida.

whenstringOpcionalPadrão: "final"

Atualmente só há suporte a final — notifica tanto em success quanto em fail.

Opções:final

storagestringOpcionalPadrão: "temp"

Nível de armazenamento de artefatos: temp (padrão, ~7 dias) ou persistent (longo prazo, cobrado por tamanho). Saldo insuficiente ou limite excedido ⇒ rebaixamento silencioso para temp; o nível efetivo aparece na resposta de detalhes.

Opções:temppersistent

Exemplos de requisição

# Envia uma tarefa assíncrona; retorna um taskId imediatamente (sem esperar a geração)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "heygen-avatar-iv",
  "input": {
    "voice": "Warm Pro Narrator",
    "image_url": "…",
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "heygen-avatar-iv",
    input: {
      "voice": "Warm Pro Narrator",
      "image_url": "…",
      "resolution": "720p",
      "aspect_ratio": "16:9"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "heygen-avatar-iv",
        "input": {
          "voice": "Warm Pro Narrator",
          "image_url": "…",
          "resolution": "720p",
          "aspect_ratio": "16:9"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Obter detalhes da tarefa

GET https://api.hiapi.ai/v1/tasks/:id

Campos da resposta

taskIdstringObrigatório

ID da tarefa, sempre com prefixo tk-hiapi-.

modelstringObrigatório

Nome completo resolvido do modelo. Tarefas enviadas com o parâmetro route retornam base@route (ex.: gpt-image-2/text-to-image@ext); caso contrário, igual ao nome enviado.

routestringOpcional

Presente apenas se o parâmetro route explícito foi usado; ecoa o valor enviado.

statusstringObrigatório

Estado da tarefa.

Valores de status

queued Na fila, ainda não iniciada. handling Em processamento. archiving Processamento concluído, preparando artefatos. success Terminal: concluído, artefatos disponíveis (retorna output). fail Terminal: falha (retorna error). Após o envio, acompanhe status: success e fail são terminais, os demais não. Faça polling a cada 1–3 s até o estado terminal. Em caso de sucesso, baixe os artefatos em output[].url e transfira antes de expireAt; para retenção longa, use storage: "persistent" na criação.

creatednumberObrigatório

Momento de criação da tarefa (segundos Unix).

completednumberObrigatório

Segundos Unix do estado terminal; 0 enquanto não terminal.

outputarrayOpcional

Presente apenas com status == success. Lista de artefatos — sempre um array; uma tarefa pode retornar vários types ao mesmo tempo (ex.: video + first_frame).

Array [ object ]

Itens do array

urlstringObrigatório

URL do artefato, baixável diretamente.

typestringObrigatório

Valores possíveis no momento: video, image, audio, first_frame, last_frame, thumbnail; poderão ser ampliados.

expireAtnumberObrigatório

Segundos Unix de disponibilidade do artefato; baixe ou transfira antes da expiração.

errorobjectOpcional

Presente apenas com status == fail.

codestringObrigatório

Código de erro de negócio.

messagestringObrigatório

Descrição do erro.

Exemplos de resposta

Sucesso

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

Em processamento (não final)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Falhou

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}