comparisons

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

Poyo.ai Team
9 min read
Share:

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

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

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 (predefinido), 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 na submissão, texto reservado e depois acertadoIgual

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çãoheygen-avatar-6heygen-avatar-6-turboPoupança 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 clip, mudando apenas o ID do modelo:

Clipheygen-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 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-turboheygen-avatar-6
Avatar / vozAbigail Office Front / Jessica Anne BogartBryan Tech Expert / Andrew
Guião27 palavras21 palavras
Definições16:9, 1080p16:9, 1080p
Duração da saída10.16 s6.88 s
Custo aos 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 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çãoID do modeloPorquê
Rascunhos, revisões de guião e de temposheygen-avatar-6-turboMetade 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 volumeheygen-avatar-6-turboEm escala, o custo por segundo domina
Pré-visualizações para utilizadores na tua appheygen-avatar-6-turboIterações baratas enquanto o utilizador experimenta avatares e guiões
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 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.

Share: