comparisons

HeyGen Avatar 6 API vs Turbo: qual ID de modelo chamar

Poyo.ai Team
9 min read
Share:

HeyGen Avatar 6 API vs Turbo: qual ID de modelo chamar

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".

Itemheygen-avatar-6heygen-avatar-6-turbo
EndpointPOST /api/generate/submitIgual
Modo foto (image_urls + audio_url)SimSim
Modo vídeo de referência (video_url + audio_url)SimSim
Modo avatar público (avatar + text/voice ou audio_url)SimSim
Avatares e vozes1,248 looks, 102 vozesMesma lista
Áudio2–60 s, até 15 MBIgual
TextoAté 1,000 caracteresIgual
promptAté 1,200 caracteresIgual
resolution1080p (padrão), 2KIgual
aspect_ratio (avatar público)16:9, 9:16, 1:1, 4:5, 5:4Igual
Regras de cobrançaSegundos arredondados para cima; áudio cobrado no envio, texto reservado e depois acertadoIgual

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çãoheygen-avatar-6heygen-avatar-6-turboEconomia com Turbo
1080p20 créditos ($0.10)10 créditos ($0.05)50%
2K29 créditos ($0.145)18 créditos ($0.09)38%

Preço pelo mesmo clipe, trocando só o ID do modelo:

Clipeheygen-avatar-6heygen-avatar-6-turbo
10 s, 1080p200 créditos ($1.00)100 créditos ($0.50)
10 s, 2K290 créditos ($1.45)180 créditos ($0.90)
30 s, 1080p600 créditos ($3.00)300 créditos ($1.50)
60 s, 1080p1,200 créditos ($6.00)600 créditos ($3.00)
60 s, 2K1,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-turboheygen-avatar-6
Avatar / vozAbigail Office Front / Jessica Anne BogartBryan Tech Expert / Andrew
Roteiro27 palavras21 palavras
Configurações16:9, 1080p16:9, 1080p
Duração da saída10.16 s6.88 s
Custo nos preços atuais110 créditos (11 s × 10)140 créditos (7 s × 20)
Tempo realCerca de 2.4 minCerca 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çãoID do modeloPor quê
Rascunhos, revisões de roteiro e de tempoheygen-avatar-6-turboMetade 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 volumeheygen-avatar-6-turboEm escala, o custo por segundo domina
Prévias para usuários no seu appheygen-avatar-6-turboIterações baratas enquanto o usuário testa avatares e roteiros
Vídeo final de apresentador ou de marcaheygen-avatar-6O nível Quality da HeyGen
2K com orçamento apertadoheygen-avatar-6-turbo + 2K18 créditos por segundo, abaixo do Avatar 6 em 1080p
Master final em 2Kheygen-avatar-6 + 2KNí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.

Share: