![]()
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».
| Elemento | heygen-avatar-6 | heygen-avatar-6-turbo |
|---|---|---|
| Endpoint | POST /api/generate/submit | Igual |
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 voces | 1,248 looks, 102 voces | La misma lista |
| Audio | 2–60 s, hasta 15 MB | Igual |
| Texto | Hasta 1,000 caracteres | Igual |
prompt | Hasta 1,200 caracteres | Igual |
resolution | 1080p (por defecto), 2K | Igual |
aspect_ratio (avatar público) | 16:9, 9:16, 1:1, 4:5, 5:4 | Igual |
| Reglas de cobro | Segundos redondeados hacia arriba; audio cobrado en el envío, texto reservado y luego liquidado | Igual |
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ón | heygen-avatar-6 | heygen-avatar-6-turbo | Ahorro con 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% |
Precio por el mismo clip, cambiando solo el ID de 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) |
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-turbo | heygen-avatar-6 | |
|---|---|---|
| Avatar / voz | Abigail Office Front / Jessica Anne Bogart | Bryan Tech Expert / Andrew |
| Guion | 27 palabras | 21 palabras |
| Ajustes | 16:9, 1080p | 16:9, 1080p |
| Duración de salida | 10.16 s | 6.88 s |
| Coste a precios actuales | 110 créditos (11 s × 10) | 140 créditos (7 s × 20) |
| Tiempo real | Unos 2.4 min | Unos 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ón | ID de modelo | Por qué |
|---|---|---|
| Borradores, revisiones de guion y de tiempos | heygen-avatar-6-turbo | La 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 volumen | heygen-avatar-6-turbo | El coste por segundo domina a escala |
| Usuarios que previsualizan en tu app | heygen-avatar-6-turbo | Iteraciones baratas mientras el usuario prueba avatares y guiones |
| Vídeo final de presentador o de marca | heygen-avatar-6 | El nivel Quality de HeyGen |
| 2K con presupuesto ajustado | heygen-avatar-6-turbo + 2K | 18 créditos por segundo, por debajo de Avatar 6 en 1080p |
| Máster final en 2K | heygen-avatar-6 + 2K | Nivel 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.