![]()
A HeyGen Avatar 6 API no PoYo tem dois IDs de modelo: heygen-avatar-6, o nível Avatar 6 Quality da HeyGen, e heygen-avatar-6-turbo. Partilham um endpoint, um formato de pedido e todos os limites, por isso a escolha é uma decisão de encaminhamento por pedido entre custo e qualidade, não um projeto de integração. Esta página mostra o que é igual, o que difere, o que medimos e uma regra para escolher. Ambos estão na página do modelo HeyGen Avatar 6.
O que é idêntico nos dois níveis da HeyGen Avatar 6 API
A documentação PoYo do HeyGen Avatar 6 descreve o Turbo como o "nível Turbo do Avatar 6, com as mesmas entradas e modos". A documentação para programadores da própria HeyGen diz o mesmo: os dois modelos "aceitam as mesmas entradas".
| Item | heygen-avatar-6 | heygen-avatar-6-turbo |
|---|---|---|
| Endpoint | POST /api/generate/submit | Igual |
Modo foto (image_urls + audio_url) | Sim | Sim |
Modo vídeo de referência (video_url + audio_url) | Sim | Sim |
Modo avatar público (avatar + text/voice ou audio_url) | Sim | Sim |
| Avatares e vozes | 1,248 looks, 102 vozes | Mesma lista |
| Áudio | 2–60 s, até 15 MB | Igual |
| Texto | Até 1,000 caracteres | Igual |
prompt | Até 1,200 caracteres | Igual |
resolution | 1080p (predefinido), 2K | Igual |
aspect_ratio (avatar público) | 16:9, 9:16, 1:1, 4:5, 5:4 | Igual |
| Regras de cobrança | Segundos arredondados para cima; áudio cobrado na submissão, texto reservado e depois acertado | Igual |
Como nada em input muda, um corpo de pedido que funciona num modelo funciona no outro. A mudança é a string model.
O que difere: o preço
1 crédito = $0.005, por segundo de saída:
| Resolução | heygen-avatar-6 | heygen-avatar-6-turbo | Poupança com Turbo |
|---|---|---|---|
| 1080p | 20 créditos ($0.10) | 10 créditos ($0.05) | 50% |
| 2K | 29 créditos ($0.145) | 18 créditos ($0.09) | 38% |
Preço pelo mesmo clip, mudando apenas o ID do modelo:
| Clip | heygen-avatar-6 | heygen-avatar-6-turbo |
|---|---|---|
| 10 s, 1080p | 200 créditos ($1.00) | 100 créditos ($0.50) |
| 10 s, 2K | 290 créditos ($1.45) | 180 créditos ($0.90) |
| 30 s, 1080p | 600 créditos ($3.00) | 300 créditos ($1.50) |
| 60 s, 1080p | 1,200 créditos ($6.00) | 600 créditos ($3.00) |
| 60 s, 2K | 1,740 créditos ($8.70) | 1,080 créditos ($5.40) |
Mais uma comparação que afeta o encaminhamento: o Turbo em 2K (18 créditos por segundo) é mais barato do que o Avatar 6 em 1080p (20). Se precisas mais da contagem de píxeis do que do nível Quality, o Turbo 2K é a forma mais barata de a obter.
Detalhes em Preços da HeyGen Avatar 6 API.
O que difere: qualidade e velocidade, segundo a HeyGen
A HeyGen chama aos níveis "Avatar 6 Quality" e "Avatar 6 Turbo" no seu relatório técnico, mas não define a diferença entre eles e não publica valores de latência para o Turbo. O que publica é cada nível contra o seu antecessor: 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. A HeyGen não publicou uma votação Quality contra Turbo, por isso não há um número oficial sobre quanto perdes com o Turbo.
O que medimos no dia do lançamento
A equipa PoYo executou um pedido de texto em cada modelo na API de produção a 19 de novembro de 2026. O tempo real vai da submissão ao resultado para um cliente que consulta a cada poucos segundos, por isso considera-o aproximado.
heygen-avatar-6-turbo | heygen-avatar-6 | |
|---|---|---|
| Avatar / voz | Abigail Office Front / Jessica Anne Bogart | Bryan Tech Expert / Andrew |
| Guião | 27 palavras | 21 palavras |
| Definições | 16:9, 1080p | 16:9, 1080p |
| Duração da saída | 10.16 s | 6.88 s |
| Custo aos preços atuais | 110 créditos (11 s × 10) | 140 créditos (7 s × 20) |
| Tempo real | Cerca de 2.4 min | Cerca de 2 min |
São duas execuções únicas com guiões e avatares diferentes, por isso não mostram que o Turbo seja mais rápido ou mais lento. Mostram, sim, a diferença de custo na prática: o clip Turbo mais longo custou mesmo assim menos do que o clip Avatar 6 mais curto. Mostram também que os dois níveis demoram minutos, por isso nenhum é uma API síncrona em que se espera no próprio pedido. Planeia polling ou um callback_url em qualquer caso.
Que ID de modelo da HeyGen Avatar 6 API chamar
| Situação | ID do modelo | Porquê |
|---|---|---|
| Rascunhos, revisões de guião e de tempos | heygen-avatar-6-turbo | Metade do preço em 1080p; mesmos campos, por isso o corpo aprovado volta a correr no Avatar 6 sem alterações |
| Clips personalizados em grande volume | heygen-avatar-6-turbo | Em escala, o custo por segundo domina |
| Pré-visualizações para utilizadores na tua app | heygen-avatar-6-turbo | Iterações baratas enquanto o utilizador experimenta avatares e guiões |
| Vídeo final de apresentador ou de marca | heygen-avatar-6 | O nível Quality da HeyGen |
| 2K com orçamento apertado | heygen-avatar-6-turbo + 2K | 18 créditos por segundo, abaixo do Avatar 6 em 1080p |
| Master final em 2K | heygen-avatar-6 + 2K | Nível mais alto na resolução mais alta |
Um pipeline em dois passos é o encaixe natural: gera todos os rascunhos no Turbo, guarda o corpo exato do pedido e volta a submeter o corpo aprovado com "model": "heygen-avatar-6". Os dois pedidos abaixo são idênticos exceto no modelo:
{
"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",
"aspect_ratio": "16:9",
"resolution": "1080p"
}
}
{
"model": "heygen-avatar-6",
"input": {
"avatar": "Abigail Office Front",
"text": "Hello and welcome to this demonstration of HeyGen Avatar 6.",
"voice": "Warm Pro Narrator",
"aspect_ratio": "16:9",
"resolution": "1080p"
}
}
Com entrada de texto, o render final é uma nova geração, por isso a sua duração pode diferir ligeiramente da do rascunho. Com um ficheiro de áudio, ambos os renders duram o mesmo que o áudio e custam exatamente o que a tabela prevê. Para o fluxo completo do pedido, vê o guia da HeyGen Avatar 6 API.
Erros e novas tentativas são iguais nos dois níveis
Encaminhar entre os dois IDs não muda o tratamento de erros. Ambos devolvem os mesmos valores de code no corpo: 400 para um problema de entrada (áudio fora de 2–60 s, um nome de avatar desconhecido, campos de dois modos), 402 insufficient_credits_error quando o saldo não chega, 429 para limites de taxa e 5xx para falhas temporárias. Um 400 no Turbo também será um 400 no Avatar 6, por isso nunca "tentes no outro nível" para corrigir um erro de validação. Corrige antes a entrada.
As reservas aplicam-se aos dois níveis. As tarefas de texto em qualquer um dos modelos retêm créditos desde a submissão até serem acertadas, e a mensagem do 402 conta-as todas em conjunto. No nosso teste do dia do lançamento, depois de submetidas uma tarefa de texto Turbo e uma tarefa de texto Avatar 6, um terceiro pedido de texto (Turbo, 2K) foi recusado com HTTP 200 e code 402 no corpo: "this request needs at least 252 credits, and 344 credits are already reserved by your unfinished HeyGen Avatar 6 text tasks." Dimensiona o teu saldo para todas as tarefas de texto em curso, seja qual for o modelo em que correm.
Uma função de encaminhamento
import math
def pick_model(final: bool) -> str:
"""Route a HeyGen Avatar 6 request. Fields stay identical; only the model changes."""
return "heygen-avatar-6" if final else "heygen-avatar-6-turbo"
PRICE_PER_SECOND = { # credits, 1 credit = $0.005
("heygen-avatar-6-turbo", "1080p"): 10,
("heygen-avatar-6-turbo", "2K"): 18,
("heygen-avatar-6", "1080p"): 20,
("heygen-avatar-6", "2K"): 29,
}
def estimate_credits(model: str, resolution: str, audio_seconds: float) -> float:
return math.ceil(audio_seconds) * PRICE_PER_SECOND[(model, resolution)]
estimate_credits é exata para pedidos com áudio, que são cobrados pela duração do áudio arredondada para cima. Para pedidos de texto é apenas uma estimativa, porque a duração cobrada é a do vídeo final.
Perguntas frequentes
Qual é a diferença entre a HeyGen Avatar 6 API e o HeyGen Avatar 6 Turbo?
O preço e o nível HeyGen. Os campos, modos, limites, avatares e vozes são os mesmos. O Turbo custa 10 créditos ($0.05) por segundo em 1080p contra 20 ($0.10), e 18 ($0.09) em 2K contra 29 ($0.145).
O HeyGen Avatar 6 Turbo é mais rápido?
O relatório técnico e a documentação para programadores da HeyGen não publicam valores de latência para nenhum dos níveis. Nas nossas duas execuções do dia do lançamento, ambos demoraram cerca de 2 a 2.4 minutos para um clip curto, com guiões diferentes, por isso trata a velocidade como algo a medir nos teus próprios pedidos.
Posso mudar do Turbo para o Avatar 6 sem alterar o meu pedido?
Sim. Muda model de heygen-avatar-6-turbo para heygen-avatar-6; tudo em input continua válido.
O HeyGen Avatar 6 Turbo suporta 2K?
Sim, com "resolution": "2K", a 18 créditos ($0.09) por segundo.
Com que nível da HeyGen Avatar 6 API devo começar?
Começa no Turbo enquanto afinas guiões, prompts e escolha de avatar, e depois envia os renders finais para heygen-avatar-6. O guia text-to-avatar é um ponto de partida barato.