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 no PoYo: IDs de modelo, modos de entrada, limites e preço

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

Esta visão geral explica o que a HeyGen lançou, o formato do pedido no PoYo, os limites que o teu código tem de 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, datado 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; no PoYo 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 2026Ambos os níveis podem ser chamados no 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 do pedido:

  • 2K nativo. A HeyGen diz que "cada frame [é] gerado a 2880×1620". No PoYo escolhes isto com "resolution": "2K".
  • Prompts de movimento. O relatório da HeyGen diz: "Escreve a ação ao lado das palavras. O Avatar 6 executa-a no momento exato." No PoYo é o campo prompt, até 1,200 caracteres.
  • Preferência face ao 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 num relance

Itemheygen-avatar-6heygen-avatar-6-turbo
Nível HeyGenAvatar 6 QualityAvatar 6 Turbo
Endpoint de submissãoPOST 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 (predefinido) ou 2KIgual
Entrada de falaÁudio de 2–60 s, ou texto 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 do pedido são idênticos, por isso mudar de nível significa mudar apenas a string model. As regras dos campos estão na documentação PoYo do HeyGen Avatar 6.

Três modos de entrada, um endpoint

Não existe um campo mode. São as entradas que envias que escolhem o modo, por esta ordem:

ModoSelecionado quandoEntradasProporção
Avatar públicoavatar está presenteavatar + text (+ voice opcional), ou avatar + audio_urlaspect_ratio: 16:9 (predefinido), 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
FotoPredefinidoimage_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. Envia as entradas de um só modo por pedido. A documentação para programadores da própria HeyGen divide este trabalho por 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); no PoYo é um único formato de pedido para ambos.

O modo vídeo de referência destina-se a personagens animadas ou ilustradas. Para uma pessoa real, usa o modo foto com uma foto.

Limites a validar antes de submeter

CampoRegra
image_urlsExatamente um URL; é usado image_urls[0]
video_urlPelo menos 2 segundos, até 50 MB
audio_url2–60 segundos, até 15 MB; o vídeo dura o mesmo que o áudio
text1–1,000 caracteres (modo avatar público, em vez de audio_url)
avatarUm de 1,248 nomes (156 pessoas); maiúsculas/minúsculas e espaços extra ignorados
voiceUm de 102 nomes; predefinido Warm Pro Narrator
promptAté 1,200 caracteres
resolution1080p ou 2K

Todos os URLs de media têm de ser públicos e descarregáveis diretamente por HTTP ou HTTPS. O PoYo verifica a duração do áudio, a duração do vídeo de referência e o nome do avatar no momento da submissão, por isso entradas erradas falham logo em vez de depois de uma espera. A saída pode ser cerca de um décimo de segundo mais curta do que o áudio. Todos os nomes de avatar e de voz estão em Avatars and Voices, com um catálogo JSON descarregável.

Preços da HeyGen Avatar 6 API no PoYo

O 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 na submissão. Com text, o PoYo reserva créditos quando submetes e acerta-os pela duração do vídeo final quando a tarefa termina. A análise completa, com exemplos práticos, está em Preços da HeyGen Avatar 6 API.

Resultados dos testes do dia do lançamento

A equipa PoYo executou-os na API de produção a 19 de novembro de 2026, em modo avatar público com texto. O tempo real vai da submissão ao resultado, tal como visto por um cliente que faz polling, por isso considera-o aproximado.

ModeloAvatar / vozGuiãoSaídaCusto aos 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 clip curto significam que esta é uma API assíncrona: submete, guarda o task_id e faz polling ou recebe um callback. Não mantenhas aberto um pedido HTTP voltado para o utilizador enquanto a tarefa corre.

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"
    }
  }'

Verifica code no corpo (tem de ser 200), guarda data.task_id e depois chama GET https://api.poyo.ai/api/generate/status/{task_id} até status ser finished e lê o MP4 em data.files[].file_url. Os vídeos gerados ficam disponíveis durante 3 dias, por isso copia-os para o teu próprio armazenamento. O modo foto, o modo vídeo de referência, um ciclo Python com limite de tempo e o tratamento de erros estão no guia da HeyGen Avatar 6 API.

Que pedidos pertencem à HeyGen Avatar 6 API

Precisas deChama
Um vídeo com apresentador a partir de um guião, sem ficheiro de áudioheygen-avatar-6 ou -turbo em modo avatar público (guia text-to-avatar)
A foto de uma pessoa real a dizer o teu áudio, 1080p ou 2KModo foto
Uma mascote ou personagem de desenho animado a falarModo vídeo de referência
Rascunhos, pré-visualizações, grande volumeheygen-avatar-6-turbo (ver Avatar 6 vs Turbo)
O preço por segundo mais baixo a partir de foto mais áudioCompara 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. Ambos usam POST https://api.poyo.ai/api/generate/submit com os mesmos campos input.

Quanto custa a HeyGen Avatar 6 API?

No 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 apenas a partir de texto?

Sim, em modo avatar público. Envia 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.

Quanto pode durar um vídeo da HeyGen Avatar 6 API?

Com áudio, 2–60 segundos, igual à duração do áudio. Com texto, o vídeo dura o tempo que o avatar demora a ler até 1,000 caracteres.

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

1080p (predefinida) e 2K. O modo avatar público acrescenta 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. Adiciona um callback_url no nível superior e o PoYo envia o resultado da tarefa quando está finished ou failed. Também podes fazer polling do endpoint de estado.

Share: