![]()
A HeyGen Avatar 6 API na PoYo tem dois IDs de modelo: heygen-avatar-6, o nível Avatar 6 Quality da HeyGen, e heygen-avatar-6-turbo. Eles compartilham um endpoint, um formato de requisição e todos os limites, então a escolha é uma decisão de roteamento por requisição entre custo e qualidade, não um projeto de integração. Esta página mostra o que é igual, o que muda, o que medimos e uma regra para escolher. Os dois 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 da 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 desenvolvedores 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 (padrão), 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 no envio, texto reservado e depois acertado | Igual |
Como nada em input muda, um corpo de requisição que funciona em um modelo funciona no outro. A troca é a string model.
O que muda: o preço
1 crédito = $0.005, por segundo de saída:
| Resolução | heygen-avatar-6 | heygen-avatar-6-turbo | Economia 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 clipe, trocando só o ID do modelo:
| Clipe | 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 roteamento: o Turbo em 2K (18 créditos por segundo) é mais barato que o Avatar 6 em 1080p (20). Se você precisa mais da quantidade de pixels do que do nível Quality, o Turbo 2K é o jeito mais barato de conseguir isso.
Detalhes em Preço da HeyGen Avatar 6 API.
O que muda: qualidade e velocidade, segundo a HeyGen
A HeyGen chama os níveis de "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 números de latência para o Turbo. O que ela 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, então não há um número oficial de quanto você abre mão com o Turbo.
O que medimos no dia do lançamento
A equipe da PoYo rodou uma requisição de texto em cada modelo na API de produção em 19 de novembro de 2026. O tempo real vai do envio ao resultado para um cliente consultando a cada poucos segundos, então considere-o aproximado.
heygen-avatar-6-turbo | heygen-avatar-6 | |
|---|---|---|
| Avatar / voz | Abigail Office Front / Jessica Anne Bogart | Bryan Tech Expert / Andrew |
| Roteiro | 27 palavras | 21 palavras |
| Configurações | 16:9, 1080p | 16:9, 1080p |
| Duração da saída | 10.16 s | 6.88 s |
| Custo nos 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 roteiros e avatares diferentes, então não mostram o Turbo sendo mais rápido ou mais lento. Elas mostram, sim, a diferença de custo na prática: o clipe Turbo mais longo ainda custou menos que o clipe Avatar 6 mais curto. Também mostram que os dois níveis levam minutos, então nenhum deles é uma API síncrona em que se espera na própria requisição. Planeje polling ou um callback_url em qualquer caso.
Qual ID de modelo da HeyGen Avatar 6 API chamar
| Situação | ID do modelo | Por quê |
|---|---|---|
| Rascunhos, revisões de roteiro e de tempo | heygen-avatar-6-turbo | Metade do preço em 1080p; mesmos campos, então o corpo aprovado roda de novo no Avatar 6 sem mudanças |
| Clipes personalizados em alto volume | heygen-avatar-6-turbo | Em escala, o custo por segundo domina |
| Prévias para usuários no seu app | heygen-avatar-6-turbo | Iterações baratas enquanto o usuário testa avatares e roteiros |
| 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 duas etapas é o encaixe natural: gere todos os rascunhos no Turbo, guarde o corpo exato da requisição e reenvie o corpo aprovado com "model": "heygen-avatar-6". As duas requisições abaixo são idênticas, exceto pelo 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, então a duração pode ser um pouco diferente da do rascunho. Com um arquivo de áudio, os dois renders têm a duração do mesmo áudio e custam exatamente o que a tabela prevê. Para o fluxo completo da requisição, veja o guia da HeyGen Avatar 6 API.
Erros e novas tentativas são iguais nos dois níveis
Rotear entre os dois IDs não muda o tratamento de erros. Os dois retornam 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 basta, 429 para limites de taxa e 5xx para falhas temporárias. Um 400 no Turbo também será um 400 no Avatar 6, então nunca "tente no outro nível" para resolver um erro de validação. Corrija a entrada.
As reservas valem para os dois níveis. Tarefas de texto em qualquer um dos modelos retêm créditos desde o envio até o acerto, e a mensagem do 402 conta todas juntas. No nosso teste do dia do lançamento, depois de enviadas uma tarefa de texto no Turbo e uma no Avatar 6, uma terceira requisição de texto (Turbo, 2K) foi recusada 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." Dimensione o seu saldo para todas as tarefas de texto em andamento, seja qual for o modelo em que rodam.
Uma função de roteamento
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 requisições com áudio, que são cobradas pela duração do áudio arredondada para cima. Para requisições de texto é só 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 da 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 desenvolvedores da HeyGen não publicam números de latência para nenhum dos níveis. Nas nossas duas execuções do dia do lançamento, os dois levaram cerca de 2 a 2.4 minutos para um clipe curto, com roteiros diferentes, então trate a velocidade como algo a medir nas suas próprias requisições.
Posso trocar do Turbo para o Avatar 6 sem mudar a minha requisição?
Sim. Troque 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 qual nível da HeyGen Avatar 6 API devo começar?
Comece no Turbo enquanto ajusta roteiros, prompts e a escolha de avatar, e depois envie os renders finais para heygen-avatar-6. O guia text-to-avatar é um ponto de partida barato.