![]()
La HeyGen Avatar 6 API ya está disponible en PoYo con dos IDs de modelo: heygen-avatar-6 y el nivel Turbo heygen-avatar-6-turbo, a la mitad del precio en 1080p. Ambos convierten una foto, un vídeo de referencia de un personaje animado o uno de los 1,248 looks de avatar públicos de HeyGen en un MP4 parlante con sincronización labial en 1080p o 2K, impulsado por tu audio o, en el caso de los avatares públicos, por texto. Puedes probar los dos niveles en la página del modelo HeyGen Avatar 6 antes de escribir código.
Este resumen explica lo que ha lanzado HeyGen, el formato de las solicitudes en PoYo, los límites que tu código debe validar, el precio por segundo y lo que medimos el día del lanzamiento.
¿Qué es HeyGen Avatar 6?
HeyGen Avatar 6 es el modelo de vídeo de avatares parlantes de HeyGen. El informe técnico de HeyGen, fechado el 17 de noviembre de 2026, afirma que «Avatar 6 reproduce cómo una persona se ve, habla y se mueve, hasta 2K», y que funciona «a partir de una sola foto». HeyGen describe dos niveles, Avatar 6 Quality y Avatar 6 Turbo; en PoYo son heygen-avatar-6 y heygen-avatar-6-turbo.
| Fecha | Qué ocurrió |
|---|---|
| 17 de noviembre de 2026 | HeyGen publica el informe técnico de Avatar 6 |
| 19 de noviembre de 2026 | Ambos niveles se pueden llamar en PoYo como heygen-avatar-6 y heygen-avatar-6-turbo |
Tres afirmaciones de HeyGen importan para una integración, porque se corresponden con campos de la solicitud:
- 2K nativo. HeyGen afirma que «cada fotograma [se] genera a 2880×1620». En PoYo lo eliges con
"resolution": "2K". - Prompts de movimiento. El informe de HeyGen dice: «Escribe la acción junto a las palabras. Avatar 6 la ejecuta justo en el momento indicado». En PoYo es el campo
prompt, de hasta 1,200 caracteres. - Preferencia frente a Avatar V. En la votación en línea de HeyGen, 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. Son cifras de la propia HeyGen.
HeyGen Avatar 6 API de un vistazo
| Elemento | heygen-avatar-6 | heygen-avatar-6-turbo |
|---|---|---|
| Nivel de HeyGen | Avatar 6 Quality | Avatar 6 Turbo |
| Endpoint de envío | POST https://api.poyo.ai/api/generate/submit | Igual |
| Resultado | GET /api/generate/status/{task_id} o callback_url | Igual |
| Modos de entrada | Foto, vídeo de referencia, avatar público | Los mismos tres |
| Salida | Un MP4, 1080p (por defecto) o 2K | Igual |
| Entrada de voz | Audio de 2–60 s, o texto de hasta 1,000 caracteres (solo avatar público) | Igual |
| Precio, 1080p | 20 créditos ($0.10) por segundo | 10 créditos ($0.05) por segundo |
| Precio, 2K | 29 créditos ($0.145) por segundo | 18 créditos ($0.09) por segundo |
Los campos de la solicitud son idénticos, así que cambiar de nivel solo implica cambiar la cadena model. Las reglas de cada campo están en la documentación de HeyGen Avatar 6 en PoYo.
Tres modos de entrada, un solo endpoint
No existe un campo mode. Las entradas que envías eligen el modo, en este orden:
| Modo | Se selecciona cuando | Entradas | Relación de aspecto |
|---|---|---|---|
| Avatar público | avatar está presente | avatar + text (+ voice opcional), o avatar + audio_url | aspect_ratio: 16:9 (por defecto), 9:16, 1:1, 4:5, 5:4 |
| Vídeo de referencia | video_url está presente (y no hay avatar) | video_url + audio_url, opcionalmente una foto en image_urls | Sigue al vídeo de entrada |
| Foto | Por defecto | image_urls (exactamente una) + audio_url | Sigue a la foto de entrada |
prompt y resolution funcionan en todos los modos. aspect_ratio y voice pertenecen solo al modo de avatar público. Envía las entradas de un único modo por solicitud. La documentación para desarrolladores de HeyGen reparte este trabajo entre dos APIs distintas (una API de modelo para imagen o vídeo más audio, y una API de aplicación para los looks de avatar de HeyGen); en PoYo es una sola forma de solicitud para ambos casos.
El modo de vídeo de referencia está pensado para personajes animados o ilustrados. Para una persona real, usa el modo de foto con una sola foto.
Límites que debes validar antes de enviar
| Campo | Regla |
|---|---|
image_urls | Exactamente una URL; se usa image_urls[0] |
video_url | Al menos 2 segundos, hasta 50 MB |
audio_url | 2–60 segundos, hasta 15 MB; el vídeo dura lo mismo que el audio |
text | 1–1,000 caracteres (modo de avatar público, en lugar de audio_url) |
avatar | Uno de 1,248 nombres (156 personas); se ignoran mayúsculas/minúsculas y espacios extra |
voice | Uno de 102 nombres; por defecto Warm Pro Narrator |
prompt | Hasta 1,200 caracteres |
resolution | 1080p o 2K |
Todas las URLs de medios deben ser públicas y descargables directamente por HTTP o HTTPS. PoYo comprueba la duración del audio, la duración del vídeo de referencia y el nombre del avatar en el momento del envío, así que las entradas incorrectas fallan de inmediato en lugar de tras una espera. La salida puede ser alrededor de una décima de segundo más corta que el audio. Todos los nombres de avatares y voces están en Avatars and Voices, con un catálogo JSON descargable.
Precio de la HeyGen Avatar 6 API en PoYo
PoYo factura por segundo de salida en créditos (1 crédito = $0.005):
| Modelo | 1080p por segundo | 2K por segundo | 10 s en 1080p | 60 s en 1080p |
|---|---|---|---|---|
heygen-avatar-6-turbo | 10 créditos ($0.05) | 18 créditos ($0.09) | 100 créditos ($0.50) | 600 créditos ($3.00) |
heygen-avatar-6 | 20 créditos ($0.10) | 29 créditos ($0.145) | 200 créditos ($1.00) | 1,200 créditos ($6.00) |
Los segundos facturados se redondean hacia arriba a segundos enteros. Con audio_url, el cargo sigue la duración del audio y se cobra en el momento del envío. Con text, PoYo reserva créditos al enviar y liquida según la duración del vídeo terminado cuando finaliza la tarea. El desglose completo, con ejemplos prácticos, está en Precios de la HeyGen Avatar 6 API.
Resultados de las pruebas del día del lanzamiento
El equipo de PoYo las ejecutó en la API de producción el 19 de noviembre de 2026, en modo de avatar público con texto. El tiempo real va desde el envío hasta el resultado visto por un cliente que hace polling, así que tómalo como aproximado.
| Modelo | Avatar / voz | Guion | Salida | Coste a precios actuales | Tiempo real |
|---|---|---|---|---|---|
heygen-avatar-6-turbo | Abigail Office Front / Jessica Anne Bogart | 27 palabras, 16:9, 1080p | 10.16 s | 110 créditos (11 s × 10) | Unos 2.4 min |
heygen-avatar-6 | Bryan Tech Expert / Andrew | 21 palabras, 16:9, 1080p | 6.88 s | 140 créditos (7 s × 20) | Unos 2 min |
Dos minutos o más para un clip corto significan que se trata de una API asíncrona: envía, guarda el task_id y consulta el estado o recibe un callback. No mantengas abierta una solicitud HTTP de cara al usuario mientras se ejecuta.
Inicio rápido con la HeyGen Avatar 6 API
Este es el ejemplo de la documentación para el modo de avatar público con texto:
curl https://api.poyo.ai/api/generate/submit \
-H "Authorization: Bearer $POYO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"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",
"prompt": "Speak with calm confidence and nod slightly at the end.",
"aspect_ratio": "16:9",
"resolution": "1080p"
}
}'
Comprueba code en el cuerpo (debe ser 200), guarda data.task_id y luego llama a GET https://api.poyo.ai/api/generate/status/{task_id} hasta que status sea finished, y lee el MP4 de data.files[].file_url. Los vídeos generados permanecen disponibles durante 3 días, así que cópialos a tu propio almacenamiento. El modo de foto, el modo de vídeo de referencia, un bucle de Python acotado y el manejo de errores están en la guía de la HeyGen Avatar 6 API.
Qué solicitudes enviar a la HeyGen Avatar 6 API
| Necesitas | Llama a |
|---|---|
| Un vídeo de presentador a partir de un guion, sin archivo de audio | heygen-avatar-6 o -turbo en modo de avatar público (guía de texto a avatar) |
| La foto de una persona real diciendo tu audio, en 1080p o 2K | Modo de foto |
| Una mascota o un personaje de dibujos animados hablando | Modo de vídeo de referencia |
| Borradores, vistas previas, gran volumen | heygen-avatar-6-turbo (consulta Avatar 6 frente a Turbo) |
| El precio por segundo más bajo a partir de foto y audio | Compara con Kling Avatar 2.0 |
| Audio de más de 60 segundos | OmniHuman 2.0 acepta 4–300 s de audio en 720p, a 21 créditos por segundo |
Preguntas frecuentes
¿Cuáles son los IDs de modelo de la HeyGen Avatar 6 API?
heygen-avatar-6 (el nivel Avatar 6 Quality de HeyGen) y heygen-avatar-6-turbo. Ambos usan POST https://api.poyo.ai/api/generate/submit con los mismos campos de input.
¿Cuánto cuesta la HeyGen Avatar 6 API?
En PoYo, por segundo de salida: Turbo 10 créditos ($0.05) en 1080p y 18 créditos ($0.09) en 2K; Avatar 6 20 créditos ($0.10) en 1080p y 29 créditos ($0.145) en 2K. Los segundos se redondean hacia arriba.
¿Puede la HeyGen Avatar 6 API crear un vídeo solo a partir de texto?
Sí, en modo de avatar público. Envía avatar y hasta 1,000 caracteres de text, además de una voice opcional de entre las 102 voces disponibles. Los modos de foto y de vídeo de referencia necesitan audio_url.
¿Cuánto puede durar un vídeo de la HeyGen Avatar 6 API?
Con audio, 2–60 segundos, igual que el audio. Con texto, el vídeo dura lo que tarde el avatar en leer hasta 1,000 caracteres.
¿Qué resoluciones admite la HeyGen Avatar 6 API?
1080p (por defecto) y 2K. El modo de avatar público añade aspect_ratio (16:9, 9:16, 1:1, 4:5, 5:4); los demás modos conservan la relación de aspecto de la entrada.
¿Admite webhooks la HeyGen Avatar 6 API?
Sí. Añade un callback_url en el nivel superior y PoYo enviará el resultado de la tarea cuando esté finished o failed. También puedes consultar el endpoint de estado.