comparisons

HeyGen Avatar 6 API frente a Turbo: qué ID de modelo llamar

Poyo.ai Team
9 min read
Share:

HeyGen Avatar 6 API frente a Turbo: qué ID de modelo llamar

La HeyGen Avatar 6 API en PoYo tiene dos IDs de modelo: heygen-avatar-6, el nivel Avatar 6 Quality de HeyGen, y heygen-avatar-6-turbo. Comparten endpoint, formato de solicitud y todos los límites, así que elegir entre ellos es una decisión de enrutamiento por solicitud basada en coste y calidad, no un proyecto de integración. Esta página expone qué es igual, qué cambia, qué medimos y una regla para elegir. Ambos están en la página del modelo HeyGen Avatar 6.

Qué es idéntico en los dos niveles de la HeyGen Avatar 6 API

La documentación de HeyGen Avatar 6 en PoYo describe Turbo como el «nivel Turbo de Avatar 6, con las mismas entradas y modos». La documentación para desarrolladores de HeyGen dice lo mismo: ambos modelos «aceptan las mismas entradas».

Elementoheygen-avatar-6heygen-avatar-6-turbo
EndpointPOST /api/generate/submitIgual
Modo de foto (image_urls + audio_url)SíSí
Modo de vídeo de referencia (video_url + audio_url)SíSí
Modo de avatar público (avatar + text/voice o audio_url)SíSí
Avatares y voces1,248 looks, 102 vocesLa misma lista
Audio2–60 s, hasta 15 MBIgual
TextoHasta 1,000 caracteresIgual
promptHasta 1,200 caracteresIgual
resolution1080p (por defecto), 2KIgual
aspect_ratio (avatar público)16:9, 9:16, 1:1, 4:5, 5:4Igual
Reglas de cobroSegundos redondeados hacia arriba; audio cobrado en el envío, texto reservado y luego liquidadoIgual

Como nada cambia en input, un cuerpo de solicitud que funciona en un modelo funciona en el otro. El cambio es la cadena model.

Qué cambia: el precio

1 crédito = $0.005, por segundo de salida:

Resoluciónheygen-avatar-6heygen-avatar-6-turboAhorro con Turbo
1080p20 créditos ($0.10)10 créditos ($0.05)50%
2K29 créditos ($0.145)18 créditos ($0.09)38%

Precio por el mismo clip, cambiando solo el ID de 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)

Una comparación más que afecta al enrutamiento: Turbo en 2K (18 créditos por segundo) es más barato que Avatar 6 en 1080p (20). Si necesitas más la cantidad de píxeles que el nivel Quality, Turbo 2K es la forma más barata de conseguirla.

Más detalles en Precios de la HeyGen Avatar 6 API.

Qué cambia: calidad y velocidad, según HeyGen

HeyGen llama a los niveles «Avatar 6 Quality» y «Avatar 6 Turbo» en su informe técnico, pero no define la diferencia entre ellos ni publica cifras de latencia para Turbo. Lo que sí publica es cada nivel frente a su propio predecesor: el 69.7% de 879 votos prefirió Avatar 6 Quality a Avatar V, y el 64.3% de 863 votos prefirió Avatar 6 Turbo a Avatar V Turbo. HeyGen no publicó una votación Quality frente a Turbo, así que no hay una cifra oficial de cuánto se pierde con Turbo.

Lo que medimos el día del lanzamiento

El equipo de PoYo ejecutó una solicitud de texto en cada modelo en la API de producción el 19 de noviembre de 2026. El tiempo real va desde el envío hasta el resultado para un cliente que consulta el estado cada pocos segundos, así que tómalo como aproximado.

heygen-avatar-6-turboheygen-avatar-6
Avatar / vozAbigail Office Front / Jessica Anne BogartBryan Tech Expert / Andrew
Guion27 palabras21 palabras
Ajustes16:9, 1080p16:9, 1080p
Duración de salida10.16 s6.88 s
Coste a precios actuales110 créditos (11 s × 10)140 créditos (7 s × 20)
Tiempo realUnos 2.4 minUnos 2 min

Son dos ejecuciones únicas con guiones y avatares distintos, así que no demuestran que Turbo sea más rápido ni más lento. Sí muestran la diferencia de coste en la práctica: el clip de Turbo, más largo, costó aun así menos que el clip de Avatar 6, más corto. También muestran que ambos niveles tardan minutos, así que ninguno es una API síncrona en la que esperar a la respuesta. Planifica polling o un callback_url en cualquier caso.

Qué ID de modelo de la HeyGen Avatar 6 API llamar

SituaciónID de modeloPor qué
Borradores, revisiones de guion y de tiemposheygen-avatar-6-turboLa mitad de precio en 1080p; mismos campos, así que el cuerpo aprobado se vuelve a ejecutar en Avatar 6 sin cambios
Clips personalizados en gran volumenheygen-avatar-6-turboEl coste por segundo domina a escala
Usuarios que previsualizan en tu appheygen-avatar-6-turboIteraciones baratas mientras el usuario prueba avatares y guiones
Vídeo final de presentador o de marcaheygen-avatar-6El nivel Quality de HeyGen
2K con presupuesto ajustadoheygen-avatar-6-turbo + 2K18 créditos por segundo, por debajo de Avatar 6 en 1080p
Máster final en 2Kheygen-avatar-6 + 2KNivel superior a la máxima resolución

Un pipeline de dos pasos encaja de forma natural: genera cada borrador en Turbo, guarda el cuerpo exacto de la solicitud y vuelve a enviar el cuerpo aprobado con "model": "heygen-avatar-6". Las dos solicitudes siguientes son idénticas salvo por el 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"
  }
}

Con entrada de texto, el render final es una nueva generación, así que su duración puede diferir ligeramente de la del borrador. Con un archivo de audio, ambos renders duran lo mismo que ese audio y cuestan exactamente lo que predice la tabla. Para el flujo completo de la solicitud, consulta la guía de la HeyGen Avatar 6 API.

Los errores y los reintentos son iguales en ambos niveles

Enrutar entre los dos IDs no cambia el manejo de errores. Ambos devuelven los mismos valores de code en el cuerpo: 400 para un problema de entrada (audio fuera de 2–60 s, un nombre de avatar desconocido, campos de dos modos), 402 insufficient_credits_error cuando el saldo no alcanza, 429 para límites de tasa y 5xx para fallos transitorios. Un 400 en Turbo también será un 400 en Avatar 6, así que nunca «reintentes en el otro nivel» para arreglar un error de validación. Corrige la entrada.

Las reservas se aplican a ambos niveles. Las tareas de texto en cualquiera de los dos modelos retienen créditos desde el envío hasta que se liquidan, y el mensaje del 402 las cuenta todas juntas. En nuestra prueba del día del lanzamiento, después de enviar una tarea de texto en Turbo y otra en Avatar 6, una tercera solicitud de texto (Turbo, 2K) fue rechazada con HTTP 200 y code 402 en el cuerpo: «esta solicitud necesita al menos 252 créditos, y ya hay 344 créditos reservados por tus tareas de texto de HeyGen Avatar 6 sin terminar». Prevé saldo para todas las tareas de texto en curso, se ejecuten en el modelo que se ejecuten.

Una función de enrutamiento

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 es exacto para las solicitudes con audio, que se facturan según la duración del audio redondeada hacia arriba. Para las solicitudes de texto es solo una estimación, porque la duración facturada es la del vídeo terminado.

Preguntas frecuentes

¿Cuál es la diferencia entre la HeyGen Avatar 6 API y HeyGen Avatar 6 Turbo?

El precio y el nivel de HeyGen. Los campos, modos, límites, avatares y voces son los mismos. Turbo cuesta 10 créditos ($0.05) por segundo en 1080p frente a 20 ($0.10), y 18 ($0.09) en 2K frente a 29 ($0.145).

¿Es más rápido HeyGen Avatar 6 Turbo?

El informe técnico y la documentación para desarrolladores de HeyGen no publican cifras de latencia para ninguno de los dos niveles. En nuestras dos ejecuciones del día del lanzamiento, ambos tardaron entre 2 y 2.4 minutos para un clip corto, con guiones distintos, así que trata la velocidad como algo que debes medir con tus propias solicitudes.

¿Puedo pasar de Turbo a Avatar 6 sin cambiar mi solicitud?

Sí. Cambia model de heygen-avatar-6-turbo a heygen-avatar-6; todo lo que hay en input sigue siendo válido.

¿Admite 2K HeyGen Avatar 6 Turbo?

Sí, con "resolution": "2K", a 18 créditos ($0.09) por segundo.

¿Con qué nivel de la HeyGen Avatar 6 API debería empezar?

Empieza con Turbo mientras ajustas guiones, prompts y elección de avatar, y después envía los renders finales a heygen-avatar-6. La guía de texto a avatar es un punto de partida barato.

Share: