![]()
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.
| Data | O que aconteceu |
|---|---|
| 17 de novembro de 2026 | A HeyGen publica o relatório técnico do Avatar 6 |
| 19 de novembro de 2026 | Ambos 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
| Item | heygen-avatar-6 | heygen-avatar-6-turbo |
|---|---|---|
| Nível HeyGen | Avatar 6 Quality | Avatar 6 Turbo |
| Endpoint de submissão | POST https://api.poyo.ai/api/generate/submit | Igual |
| Resultado | GET /api/generate/status/{task_id} ou callback_url | Igual |
| Modos de entrada | Foto, vídeo de referência, avatar público | Os mesmos três |
| Saída | Um MP4, 1080p (predefinido) ou 2K | Igual |
| Entrada de fala | Áudio de 2–60 s, ou texto até 1,000 caracteres (só avatar público) | Igual |
| Preço, 1080p | 20 créditos ($0.10) por segundo | 10 créditos ($0.05) por segundo |
| Preço, 2K | 29 créditos ($0.145) por segundo | 18 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:
| Modo | Selecionado quando | Entradas | Proporção |
|---|---|---|---|
| Avatar público | avatar está presente | avatar + text (+ voice opcional), ou avatar + audio_url | aspect_ratio: 16:9 (predefinido), 9:16, 1:1, 4:5, 5:4 |
| Vídeo de referência | video_url está presente (e não há avatar) | video_url + audio_url, opcionalmente uma foto em image_urls | Segue o vídeo de entrada |
| Foto | Predefinido | image_urls (exatamente uma) + audio_url | Segue 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
| Campo | Regra |
|---|---|
image_urls | Exatamente um URL; é usado image_urls[0] |
video_url | Pelo menos 2 segundos, até 50 MB |
audio_url | 2–60 segundos, até 15 MB; o vídeo dura o mesmo que o áudio |
text | 1–1,000 caracteres (modo avatar público, em vez de audio_url) |
avatar | Um de 1,248 nomes (156 pessoas); maiúsculas/minúsculas e espaços extra ignorados |
voice | Um de 102 nomes; predefinido Warm Pro Narrator |
prompt | Até 1,200 caracteres |
resolution | 1080p 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):
| Modelo | 1080p por segundo | 2K por segundo | 10 s em 1080p | 60 s em 1080p |
|---|---|---|---|---|
heygen-avatar-6-turbo | 10 créditos ($0.05) | 18 créditos ($0.09) | 100 créditos ($0.50) | 600 créditos ($3.00) |
heygen-avatar-6 | 20 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.
| Modelo | Avatar / voz | Guião | Saída | Custo aos preços atuais | Tempo real |
|---|---|---|---|---|---|
heygen-avatar-6-turbo | Abigail Office Front / Jessica Anne Bogart | 27 palavras, 16:9, 1080p | 10.16 s | 110 créditos (11 s × 10) | Cerca de 2.4 min |
heygen-avatar-6 | Bryan Tech Expert / Andrew | 21 palavras, 16:9, 1080p | 6.88 s | 140 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 de | Chama |
|---|---|
| Um vídeo com apresentador a partir de um guião, sem ficheiro de áudio | heygen-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 2K | Modo foto |
| Uma mascote ou personagem de desenho animado a falar | Modo vídeo de referência |
| Rascunhos, pré-visualizações, grande volume | heygen-avatar-6-turbo (ver Avatar 6 vs Turbo) |
| O preço por segundo mais baixo a partir de foto mais áudio | Compara com o Kling Avatar 2.0 |
| Áudio com mais de 60 segundos | O 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.