guides

HeyGen Avatar 6 API: o que é o HeyGen Avatar 6, IDs de modelo, modos de entrada, limites e preço

Poyo.ai Team
9 min read
Share:

HeyGen Avatar 6 API na PoYo: IDs de modelo, modos de entrada, limites e preço

A HeyGen Avatar 6 API já está disponível na PoYo com dois IDs de modelo: heygen-avatar-6 e o nível Turbo heygen-avatar-6-turbo, pela metade do preço em 1080p. Os dois transformam uma foto, um vídeo de referência de um personagem animado ou um dos 1,248 looks de avatar público da HeyGen em um MP4 falante com sincronização labial em 1080p ou 2K, conduzido pelo seu áudio ou, nos avatares públicos, por texto. Você pode testar os dois níveis na página do modelo HeyGen Avatar 6 antes de escrever código.

Esta visão geral mostra o que a HeyGen lançou, o formato da requisição na PoYo, os limites que o seu código precisa validar, o preço por segundo e o que medimos no dia do lançamento.

O que é o HeyGen Avatar 6?

O HeyGen Avatar 6 é o modelo de vídeo de avatares falantes da HeyGen. O relatório técnico da HeyGen, de 17 de novembro de 2026, diz que "o Avatar 6 reproduz a aparência, a fala e os movimentos de uma pessoa, até 2K" e que funciona "a partir de uma única foto". A HeyGen descreve dois níveis, Avatar 6 Quality e Avatar 6 Turbo; na PoYo eles são heygen-avatar-6 e heygen-avatar-6-turbo.

DataO que aconteceu
17 de novembro de 2026A HeyGen publica o relatório técnico do Avatar 6
19 de novembro de 2026Os dois níveis podem ser chamados na PoYo como heygen-avatar-6 e heygen-avatar-6-turbo

Três afirmações da HeyGen importam para uma integração, porque correspondem a campos da requisição:

  • 2K nativo. A HeyGen diz que "cada frame [é] gerado em 2880×1620". Na PoYo você escolhe isso com "resolution": "2K".
  • Prompts de movimento. O relatório da HeyGen diz: "Escreva a ação ao lado das palavras. O Avatar 6 a executa no momento exato." Na PoYo é o campo prompt, com até 1,200 caracteres.
  • Preferência sobre o Avatar V. Na votação online da HeyGen, 69.7% de 879 votos preferiram o Avatar 6 Quality ao Avatar V, e 64.3% de 863 votos preferiram o Avatar 6 Turbo ao Avatar V Turbo. São números da própria HeyGen.

HeyGen Avatar 6 API em resumo

Itemheygen-avatar-6heygen-avatar-6-turbo
Nível HeyGenAvatar 6 QualityAvatar 6 Turbo
Endpoint de envioPOST https://api.poyo.ai/api/generate/submitIgual
ResultadoGET /api/generate/status/{task_id} ou callback_urlIgual
Modos de entradaFoto, vídeo de referência, avatar públicoOs mesmos três
SaídaUm MP4, 1080p (padrão) ou 2KIgual
Entrada de falaÁudio de 2–60 s, ou texto de até 1,000 caracteres (só avatar público)Igual
Preço, 1080p20 créditos ($0.10) por segundo10 créditos ($0.05) por segundo
Preço, 2K29 créditos ($0.145) por segundo18 créditos ($0.09) por segundo

Os campos da requisição são idênticos, então trocar de nível significa mudar apenas a string model. As regras dos campos estão na documentação da PoYo do HeyGen Avatar 6.

Três modos de entrada, um endpoint

Não existe um campo mode. São as entradas que você envia que escolhem o modo, nesta ordem:

ModoSelecionado quandoEntradasProporção
Avatar públicoavatar está presenteavatar + text (+ voice opcional), ou avatar + audio_urlaspect_ratio: 16:9 (padrão), 9:16, 1:1, 4:5, 5:4
Vídeo de referênciavideo_url está presente (e não há avatar)video_url + audio_url, opcionalmente uma foto em image_urlsSegue o vídeo de entrada
FotoPadrãoimage_urls (exatamente uma) + audio_urlSegue a foto de entrada

prompt e resolution funcionam em todos os modos. aspect_ratio e voice pertencem apenas ao modo avatar público. Envie as entradas de um único modo por requisição. A documentação para desenvolvedores da própria HeyGen divide esse trabalho entre duas APIs separadas (uma API de modelo para imagem ou vídeo mais áudio, e uma API de aplicação para os looks de avatar da HeyGen); na PoYo é um único formato de requisição para ambos.

O modo vídeo de referência é para personagens animados ou ilustrados. Para uma pessoa real, use o modo foto com uma foto.

Limites para validar antes de enviar

CampoRegra
image_urlsExatamente uma URL; é usada image_urls[0]
video_urlPelo menos 2 segundos, até 50 MB
audio_url2–60 segundos, até 15 MB; o vídeo tem a duração do áudio
text1–1,000 caracteres (modo avatar público, no lugar de audio_url)
avatarUm de 1,248 nomes (156 pessoas); maiúsculas/minúsculas e espaços extras são ignorados
voiceUm de 102 nomes; padrão Warm Pro Narrator
promptAté 1,200 caracteres
resolution1080p ou 2K

Todas as URLs de mídia precisam ser públicas e baixáveis diretamente por HTTP ou HTTPS. A PoYo verifica a duração do áudio, a duração do vídeo de referência e o nome do avatar no envio, então entradas erradas falham na hora, e não depois de uma espera. A saída pode ser cerca de um décimo de segundo mais curta que o áudio. Todos os nomes de avatar e de voz estão em Avatars and Voices, com um catálogo JSON para download.

Preço da HeyGen Avatar 6 API na PoYo

A PoYo cobra por segundo de saída em créditos (1 crédito = $0.005):

Modelo1080p por segundo2K por segundo10 s em 1080p60 s em 1080p
heygen-avatar-6-turbo10 créditos ($0.05)18 créditos ($0.09)100 créditos ($0.50)600 créditos ($3.00)
heygen-avatar-620 créditos ($0.10)29 créditos ($0.145)200 créditos ($1.00)1,200 créditos ($6.00)

Os segundos cobrados são arredondados para cima, para segundos inteiros. Com audio_url, a cobrança segue a duração do áudio e é feita no envio. Com text, a PoYo reserva créditos quando você envia e faz o acerto pela duração do vídeo final quando a tarefa termina. O detalhamento completo, com exemplos práticos, está em Preço da HeyGen Avatar 6 API.

Resultados dos testes do dia do lançamento

A equipe da PoYo rodou estes testes na API de produção em 19 de novembro de 2026, no modo avatar público com texto. O tempo real vai do envio ao resultado, como visto por um cliente fazendo polling, então considere-o aproximado.

ModeloAvatar / vozRoteiroSaídaCusto nos preços atuaisTempo real
heygen-avatar-6-turboAbigail Office Front / Jessica Anne Bogart27 palavras, 16:9, 1080p10.16 s110 créditos (11 s × 10)Cerca de 2.4 min
heygen-avatar-6Bryan Tech Expert / Andrew21 palavras, 16:9, 1080p6.88 s140 créditos (7 s × 20)Cerca de 2 min

Dois minutos ou mais para um clipe curto significam que esta é uma API assíncrona: envie, guarde o task_id e faça polling ou receba um callback. Não mantenha aberta uma requisição HTTP voltada ao usuário enquanto a tarefa roda.

HeyGen Avatar 6 API: início rápido

Este é o exemplo da documentação para o modo avatar público com texto:

curl https://api.poyo.ai/api/generate/submit \
  -H "Authorization: Bearer $POYO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "heygen-avatar-6-turbo",
    "input": {
      "avatar": "Abigail Office Front",
      "text": "Hello and welcome to this demonstration of HeyGen Avatar 6.",
      "voice": "Warm Pro Narrator",
      "prompt": "Speak with calm confidence and nod slightly at the end.",
      "aspect_ratio": "16:9",
      "resolution": "1080p"
    }
  }'

Confira code no corpo (precisa ser 200), salve data.task_id, depois chame GET https://api.poyo.ai/api/generate/status/{task_id} até status ser finished e leia o MP4 em data.files[].file_url. Os vídeos gerados ficam disponíveis por 3 dias, então copie-os para o seu próprio armazenamento. O modo foto, o modo vídeo de referência, um loop em Python com limite de tempo e o tratamento de erros estão no guia da HeyGen Avatar 6 API.

Quais requisições combinam com a HeyGen Avatar 6 API

Você precisa deChame
Um vídeo com apresentador a partir de um roteiro, sem arquivo de áudioheygen-avatar-6 ou -turbo no modo avatar público (guia text-to-avatar)
A foto de uma pessoa real falando o seu áudio, 1080p ou 2KModo foto
Um mascote ou personagem de desenho falandoModo vídeo de referência
Rascunhos, prévias, alto volumeheygen-avatar-6-turbo (veja Avatar 6 vs Turbo)
O menor preço por segundo a partir de foto mais áudioCompare com o Kling Avatar 2.0
Áudio com mais de 60 segundosO OmniHuman 2.0 aceita 4–300 s de áudio em 720p, 21 créditos por segundo

Perguntas frequentes

Quais são os IDs de modelo da HeyGen Avatar 6 API?

heygen-avatar-6 (o nível Avatar 6 Quality da HeyGen) e heygen-avatar-6-turbo. Os dois usam POST https://api.poyo.ai/api/generate/submit com os mesmos campos input.

Quanto custa a HeyGen Avatar 6 API?

Na PoYo, por segundo de saída: Turbo 10 créditos ($0.05) em 1080p e 18 créditos ($0.09) em 2K; Avatar 6 20 créditos ($0.10) em 1080p e 29 créditos ($0.145) em 2K. Os segundos são arredondados para cima.

A HeyGen Avatar 6 API consegue criar um vídeo só com texto?

Sim, no modo avatar público. Envie avatar e até 1,000 caracteres de text, mais um voice opcional entre as 102 vozes disponíveis. Os modos foto e vídeo de referência precisam de audio_url.

Qual a duração máxima de um vídeo da HeyGen Avatar 6 API?

Com áudio, 2–60 segundos, igual ao áudio. Com texto, o vídeo dura o tempo que o avatar leva para ler até 1,000 caracteres.

Quais resoluções a HeyGen Avatar 6 API suporta?

1080p (padrão) e 2K. O modo avatar público adiciona aspect_ratio (16:9, 9:16, 1:1, 4:5, 5:4); os outros modos mantêm a proporção da entrada.

A HeyGen Avatar 6 API suporta webhooks?

Sim. Adicione um callback_url no nível superior e a PoYo envia o resultado da tarefa quando ela estiver finished ou failed. Você também pode fazer polling do endpoint de status.

Share: