guides

HeyGen Avatar 6 API: qué es HeyGen Avatar 6, IDs de modelo, modos de entrada, límites y precio

Poyo.ai Team
10 min read
Share:

HeyGen Avatar 6 API en PoYo: IDs de modelo, modos de entrada, límites y precio

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.

FechaQué ocurrió
17 de noviembre de 2026HeyGen publica el informe técnico de Avatar 6
19 de noviembre de 2026Ambos 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

Elementoheygen-avatar-6heygen-avatar-6-turbo
Nivel de HeyGenAvatar 6 QualityAvatar 6 Turbo
Endpoint de envíoPOST https://api.poyo.ai/api/generate/submitIgual
ResultadoGET /api/generate/status/{task_id} o callback_urlIgual
Modos de entradaFoto, vídeo de referencia, avatar públicoLos mismos tres
SalidaUn MP4, 1080p (por defecto) o 2KIgual
Entrada de vozAudio de 2–60 s, o texto de hasta 1,000 caracteres (solo avatar público)Igual
Precio, 1080p20 créditos ($0.10) por segundo10 créditos ($0.05) por segundo
Precio, 2K29 créditos ($0.145) por segundo18 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:

ModoSe selecciona cuandoEntradasRelación de aspecto
Avatar públicoavatar está presenteavatar + text (+ voice opcional), o avatar + audio_urlaspect_ratio: 16:9 (por defecto), 9:16, 1:1, 4:5, 5:4
Vídeo de referenciavideo_url está presente (y no hay avatar)video_url + audio_url, opcionalmente una foto en image_urlsSigue al vídeo de entrada
FotoPor defectoimage_urls (exactamente una) + audio_urlSigue 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

CampoRegla
image_urlsExactamente una URL; se usa image_urls[0]
video_urlAl menos 2 segundos, hasta 50 MB
audio_url2–60 segundos, hasta 15 MB; el vídeo dura lo mismo que el audio
text1–1,000 caracteres (modo de avatar público, en lugar de audio_url)
avatarUno de 1,248 nombres (156 personas); se ignoran mayúsculas/minúsculas y espacios extra
voiceUno de 102 nombres; por defecto Warm Pro Narrator
promptHasta 1,200 caracteres
resolution1080p 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):

Modelo1080p por segundo2K por segundo10 s en 1080p60 s en 1080p
heygen-avatar-6-turbo10 créditos ($0.05)18 créditos ($0.09)100 créditos ($0.50)600 créditos ($3.00)
heygen-avatar-620 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.

ModeloAvatar / vozGuionSalidaCoste a precios actualesTiempo real
heygen-avatar-6-turboAbigail Office Front / Jessica Anne Bogart27 palabras, 16:9, 1080p10.16 s110 créditos (11 s × 10)Unos 2.4 min
heygen-avatar-6Bryan Tech Expert / Andrew21 palabras, 16:9, 1080p6.88 s140 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

NecesitasLlama a
Un vídeo de presentador a partir de un guion, sin archivo de audioheygen-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 2KModo de foto
Una mascota o un personaje de dibujos animados hablandoModo de vídeo de referencia
Borradores, vistas previas, gran volumenheygen-avatar-6-turbo (consulta Avatar 6 frente a Turbo)
El precio por segundo más bajo a partir de foto y audioCompara con Kling Avatar 2.0
Audio de más de 60 segundosOmniHuman 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.

Share: