![]()
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.
| 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 | Os 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
| Item | heygen-avatar-6 | heygen-avatar-6-turbo |
|---|---|---|
| Nível HeyGen | Avatar 6 Quality | Avatar 6 Turbo |
| Endpoint de envio | 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 (padrão) ou 2K | Igual |
| Entrada de fala | Áudio de 2–60 s, ou texto de 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 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:
| Modo | Selecionado quando | Entradas | Proporção |
|---|---|---|---|
| Avatar público | avatar está presente | avatar + text (+ voice opcional), ou avatar + audio_url | aspect_ratio: 16:9 (padrão), 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 | Padrão | 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. 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
| Campo | Regra |
|---|---|
image_urls | Exatamente uma URL; é usada image_urls[0] |
video_url | Pelo menos 2 segundos, até 50 MB |
audio_url | 2–60 segundos, até 15 MB; o vídeo tem a duração do áudio |
text | 1–1,000 caracteres (modo avatar público, no lugar de audio_url) |
avatar | Um de 1,248 nomes (156 pessoas); maiúsculas/minúsculas e espaços extras são ignorados |
voice | Um de 102 nomes; padrão Warm Pro Narrator |
prompt | Até 1,200 caracteres |
resolution | 1080p 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):
| 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 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.
| Modelo | Avatar / voz | Roteiro | Saída | Custo nos 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 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 de | Chame |
|---|---|
| Um vídeo com apresentador a partir de um roteiro, sem arquivo de áudio | heygen-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 2K | Modo foto |
| Um mascote ou personagem de desenho falando | Modo vídeo de referência |
| Rascunhos, prévias, alto volume | heygen-avatar-6-turbo (veja Avatar 6 vs Turbo) |
| O menor preço por segundo a partir de foto mais áudio | Compare 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. 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.