Source: https://ailoot.ai/models/es/heygen-heygen-video-1/
Canonical: https://ailoot.ai/models/es/heygen-heygen-video-1/
Language: es

# HeyGen: HeyGen Video

[Markdown](https://ailoot.ai/models/es/heygen-heygen-video-1/index.md) · [JSON](https://ailoot.ai/models/es/heygen-heygen-video-1/facts.json)

## [HeyGen: HeyGen Video](https://ailoot.ai/models/es/heygen-heygen-video-1/)

HeyGen Video genera escenas de 5–15 segundos con diálogo, ambiente y efectos a partir de texto, una primera imagen o referencias visuales y de audio. Su modelo de propósito general heygen-video-1 admite planos de productos y personajes, con controles de referencia y salida MP4. Las acciones claras y acotadas le proporcionan un encargo de producción útil.

- [**Ailoot Ultra · Vídeo** `POST /v1/videos` `heygen/heygen-video-1`](https://ailoot.ai/models/es/heygen-heygen-video-1/#method-0)

Sobre el modelo

Esta descripción cubre las capacidades del modelo. Las entradas, salidas y opciones disponibles en Ailoot se indican a continuación para el método seleccionado.

HeyGen Video es el modelo de generación de escenas de propósito general de HeyGen, identificado por el fabricante como heygen-video-1. Crea conjuntamente el sujeto, el escenario, la luz y el sonido a partir de un encargo creativo. Cada clip dura 5–15 segundos y contiene su pista de audio generada, incluidos diálogo, ambiente y efectos. Las entradas útiles de producción incluyen una descripción de escena, una fotografía de producto o material que establece una persona, un lugar o un movimiento. El recurso resultante es una escena breve para una presentación de producto, un inserto de incorporación de usuarios, una vista de inmueble u otro trabajo de vídeo editado.

Tres modos asignan funciones diferentes a las entradas. Texto a vídeo crea una escena a partir de la instrucción. Imagen a vídeo comienza literalmente en la imagen suministrada y después sigue el encargo para la acción. Referencia a vídeo utiliza imágenes, vídeo y audio opcional proporcionados para orientar una escena recién compuesta; exige al menos una imagen o un vídeo de referencia. Elija una imagen de primer fotograma cuando la composición de apertura deba coincidir con una imagen fija, o referencias cuando un objeto conocido deba aparecer en otra composición. Este modelo de escenas es distinto de los motores de renderizado de avatares de HeyGen y del flujo de composición Video Agent.

La guía del fabricante favorece indicaciones de plano detalladas y concretas: un sujeto, una localización y una acción acotada, con cámara fija o de movimiento suave. Describa la posición de cámara, la intención de lente o profundidad de campo, la luz, la textura de las superficies y el tratamiento de color. Explique dónde se tocan los objetos cuando una acción depende del contacto. Para un ejemplo original de producto, utilice una fotografía de referencia de un termo de viaje y pida que esté sobre una encimera de madera mientras un presentador habla a su lado, con un pequeño movimiento de cámara hacia el termo. Examine la forma, la posición y las marcas visibles del termo en el resultado.

Las listas de referencias admiten hasta nueve imágenes, tres vídeos y tres elementos de audio, con un máximo de doce referencias en total. Las imágenes, los vídeos y el audio se numeran por separado en el formato de instrucciones del fabricante: la primera imagen es \<Picture 1\> y el primer vídeo es \<Video 1\>. Asigne a cada referencia una función e identifíquela explícitamente en el encargo. El modelo lee los primeros cinco segundos de cada vídeo de referencia, por lo que debe preparar la sección pertinente al principio. La referencia de API también especifica proporciones de vídeo de referencia entre 1:4 y 4:1. Un clip largo que contiene el movimiento deseado solo al final es una mala preparación para esa ventana de entrada de cinco segundos.

La interfaz documentada de referencias acepta un recurso HTTPS directamente accesible, un identificador de recurso cargado o base64 insertado. La guía enumera tamaños máximos de imagen de 16 MB mediante URL y 5 MB insertados; el vídeo o audio pueden llegar a 32 MB mediante URL y 16 MB insertados. Prepare material de origen legible, con el sujeto importante fácil de distinguir y sin instrucciones enfrentadas entre referencias diferentes. Mantenga la orientación prevista en la imagen de primer fotograma. Estos detalles de entrada corresponden al flujo de referencias del fabricante y ayudan a organizar los materiales creativos para el modo seleccionado.

Dirija el sonido en el mismo encargo que la imagen. Indique el diálogo, la interpretación vocal, el ambiente de habitación y los efectos específicos, incluido si un sonido debe estar cerca o lejos. Especifique el tratamiento musical previsto cuando la escena deba contener solo voz y ambiente. La guía sugiere prever aproximadamente 2.5 palabras habladas por segundo como estimación de planificación, por lo que debe dejar espacio para pausas y acción visible. Una introducción breve puede planificarse como una frase seguida de un momento que revele el producto. Escuche las palabras reales y compruebe si el sonido generado encaja con el espacio y la acción.

La duración de salida se selecciona en segundos enteros de cinco a quince, con cinco segundos como valor predeterminado. La resolución es una clase de tamaño: 480p, 768p, 1080p o 2k. Las opciones documentadas de encuadre son 21:9, 16:9, 4:3, 1:1, 3:4 y 9:16. Para texto y referencia a vídeo a 1080p o 2k, seleccione 16:9 o 9:16; el encuadre adaptable de referencias está documentado a 480p y 768p. Imagen a vídeo sigue las proporciones de la primera imagen, por lo que debe recortar antes de generar cuando cambie la forma requerida. Revise las dimensiones reales del resultado completado, en lugar de asumir que una etiqueta de clase de tamaño implica una pareja convencional de píxeles.

La guía del modelo especifica vídeo MP4 con codificación de imagen H.264 y audio AAC a 32 kHz estéreo. Una generación se procesa de forma asíncrona y la tarea completada proporciona la ubicación del vídeo reproducible, la duración y las dimensiones. Su ubicación firmada de vídeo puede renovarse recuperando de nuevo la tarea. Conserve el clip real, los materiales de referencia y el encargo para una revisión de edición. Un registro pendiente o en procesamiento permite seguir la generación; el vídeo completado es el recurso de producción que se evalúa por imagen, voz y sonido.

El fabricante documenta opciones de mejora de instrucciones turbo, quality y disabled; disabled mantiene la redacción preparada tal como está escrita. Una semilla fija es útil al comparar un cambio en una cláusula manteniendo las demás entradas. Registre la semilla y los ajustes elegidos con el encargo del plano. Para letras en pantalla, mantenga breve una frase prevista y escríbala con precisión; la guía recomienda componer después los párrafos, la letra pequeña y los diagramas etiquetados. Compruebe cada carácter visible de un título generado, en lugar de asumir que las palabras se reprodujeron correctamente.

La guía identifica como áreas menos fiables el texto largo en pantalla, el movimiento orgánico suave de pétalos, papel o cabello y la manipulación cercana con manos. Para explicar un procedimiento, deje que una frase claramente escrita comunique los pasos mientras la imagen muestra una persona u objeto estable; utilice imágenes verificadas por separado cuando la propia operación física deba ser exacta. Revise todo el plano para comprobar continuidad de objetos, contacto, detalle de rostros y manos, diálogo y sonido. Una lista concisa de lo que debe cambiar en la siguiente toma mantiene práctico un encargo de producción detallado.

**Ailoot Ultra · Vídeo** `POST /v1/videos` `heygen/heygen-video-1`

[`heygen/heygen-video-1`](https://ailoot.ai/models/es/#m=heygen%2Fheygen-video-1&route=Ultra&caller=heygen%2Fheygen-video-1&fmt=videos)

HeyGen /`heygen/heygen-video-1`

### Primeros pasos

HeyGen Video genera escenas de 5–15 segundos con diálogo, ambiente y efectos a partir de texto, una primera imagen o referencias visuales y de audio. Su modelo de propósito general heygen-video-1 admite planos de productos y personajes, con controles de referencia y salida MP4. Las acciones claras y acotadas le proporcionan un encargo de producción útil.

Entradas aceptadas

Texto · Imágenes · Audio · Vídeo

Resultados

Vídeo

### Disponible en Ailoot · entradas y métodos

**Ailoot Ultra · Vídeo** `POST /v1/videos`

Tipos de entrada

`text`, `image`, `audio`, `video`

Tipos de salida

`video`

Formato de salida

bytes MP4 originales; sin normalización ni transcodificación

| Campo | Tipo | Requisito | Valores y límites | Predeterminado |
| --- | --- | --- | --- | --- |
| Campo`model` | Tipo`string` | RequisitoObligatorio | Valores y límites heygen/heygen-video-1 | Predeterminado— |
| Campo`prompt` | Tipo`string` | RequisitoObligatorio | Valores y límites | Predeterminado— |
| Campo`duration` | Tipo`integer` | RequisitoObligatorio | Valores y límites 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Mínimo: 1 Máximo: 600 | Predeterminado— |
| Campo`resolution` | Tipo`string` | RequisitoOpcional | Valores y límites 480p, 768p, 2K | Predeterminado— |
| Campo`aspect_ratio` | Tipo`string` | RequisitoOpcional | Valores y límites 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | Predeterminado— |
| Campo`generate_audio` | Tipo`boolean` | RequisitoOpcional | Valores y límites false | Predeterminado— |
| Campo`frame_images` | Tipo`array` | RequisitoOpcional | Valores y límites Número mínimo de elementos: 1 Número máximo de elementos: 1 Contenido de entrada: Lista de objetos de fotograma. Cada objeto contiene type=image\_url, image\_url con url y frame\_type. Usa una URL HTTPS de imagen y establece frame\_type en first\_frame. Cada función de fotograma aparece como máximo una vez. Claves exactas: type, image\_url, frame\_type Condiciones: Estas claves describen cada objeto de fotograma; image\_url solo contiene url. Omite frame\_images para una solicitud que solo contenga texto. | Predeterminado— |
| Campo`input_references` | Tipo`array` | RequisitoOpcional | Valores y límites | Predeterminado— |
| Campo`seed` | Tipo`integer` | RequisitoOpcional | Valores y límites Mínimo: -9.223.372.036.854.775.808 Máximo: 9.223.372.036.854.775.807 | Predeterminado— |
| Campo`callback_url` | Tipo`string` | RequisitoOpcional | Valores y límites Patrón: ^https:// | Predeterminado— |
| Campo`session_id` | Tipo`string` | RequisitoOpcional | Valores y límites | Predeterminado— |
| Campo`trace` | Tipo`object` | RequisitoOpcional | Valores y límites | Predeterminado— |
| Campo`user` | Tipo`string` | RequisitoOpcional | Valores y límites | Predeterminado— |

Combinaciones de materiales de entrada

**Texto a vídeo** · Una instrucción escrita. · Obligatorio: model, prompt, duration

`Proporciona prompt como texto y duration en segundos enteros. Elige una resolución compatible y, si hace falta, una relación de aspecto.`

`model`: Tipo: string · heygen/heygen-video-1

`prompt`: Tipo: string · Máximo de bytes UTF-8: 10.000 · Se requiere contenido distinto de espacios en blanco: Sí

**Imagen a vídeo** · Una instrucción escrita y una imagen del primer fotograma. · Obligatorio: model, prompt, duration, frame\_images

`frame_images es una lista. Cada objeto de fotograma incluye type, image_url y frame_type; image_url contiene url. Establece type en image_url. Usa first_frame. Cada función de fotograma aparece como máximo una vez. Proporciona una URL HTTPS pública de imagen para cada fotograma. Elige una resolución compatible y, si hace falta, una relación de aspecto.`

Claves exactas: type, image\_url, frame\_type

`model`: Tipo: string · heygen/heygen-video-1

`prompt`: Tipo: string · Máximo de bytes UTF-8: 10.000 · Se requiere contenido distinto de espacios en blanco: Sí

**Reference to video** · Una instrucción escrita y referencias de imagen, vídeo y audio compatibles. · Obligatorio: model, prompt, duration, input\_references

`input_references es una lista de objetos. Establece type en image_url, video_url o audio_url y utiliza el campo correspondiente que contiene url. Usa URL HTTPS públicas. Omite frame_images para seleccionar el modo de referencias. Elige una resolución compatible y, si hace falta, una relación de aspecto.`

`model`: Tipo: string · heygen/heygen-video-1

`prompt`: Tipo: string · Máximo de bytes UTF-8: 10.000 · Se requiere contenido distinto de espacios en blanco: Sí

Parámetros del método y ciclo de vida

| Parámetro | Contrato |
| --- | --- |
| Parámetro`content_type` | Contratoapplication/json |
| Parámetro`required` | Contratomodel, prompt, duration |
| Parámetro`material_types` | Contratotext, image, audio, video |
| Parámetro`additional_properties` | Contratofalse |
| Parámetro`optional_controls` | Contratoresolution, aspect\_ratio, generate\_audio, frame\_images, input\_references, seed, callback\_url, session\_id, trace, user |

Ciclo de vida: `submit_once_poll_original`

`GET /v1/videos/{public_id}`

`GET /v1/videos/{public_id}/content`

### Planes

##### Cómo se calcula el cargo definitivo

Las tarifas mostradas estiman el coste antes de la generación. El cargo final se calcula a partir del coste registrado para la generación original. La duración medida del resultado y las cantidades previstas no constituyen la cantidad facturable final.

Las referencias tarifarias no añaden opciones a la solicitud. Los parámetros admitidos se indican en el método seleccionado.

Modo rápido

Sin especificar Cuando se selecciona el modo rápido

Modo flex

Sin especificar Cuando se selecciona el modo flex

Esfuerzo máximo de razonamiento

Sin especificar Cuando el esfuerzo máximo de razonamiento utiliza el ajuste predeterminado (default)

#### Tarifas estimadas para comparar

#### Precios por configuración

Relaciona cada cargo con las condiciones mostradas. Usa una tarifa para cada conjunto de configuraciones alternativas.

| Configuración | Tabla de tarifas | Cantidad prevista | Unidad de facturación | Condiciones de facturación | Cargo |
| --- | --- | --- | --- | --- | --- |
| ConfiguraciónTarifas base por token | Tabla de tarifasTarifa base | Cantidad prevista— | Unidad de facturación— | Condiciones de facturación— | Cargo Entrada · Tokens de entrada · Estimación solo para comparar **—** / 1K tokens Salida · Tokens de salida · Estimación solo para comparar **—** / 1K tokens Entrada · Lectura de caché · Estimación solo para comparar **—** / 1K tokens Entrada · Escritura en caché · Estimación solo para comparar **—** / 1K tokens Entrada · Escritura en caché, 1 hora · Estimación solo para comparar **—** / 1K tokens |
| ConfiguraciónPrecio del vídeo | Tabla de tarifas— | Cantidad prevista— | Unidad de facturaciónpor segundo de vídeo | Condiciones de facturaciónresolution: 2k | Cargo Salida · Precio del vídeo · Estimación solo para comparar **$0.2** por segundo de vídeo |
| ConfiguraciónPrecio del vídeo | Tabla de tarifas— | Cantidad prevista— | Unidad de facturaciónpor segundo de vídeo | Condiciones de facturaciónresolution: 480p | Cargo Salida · Precio del vídeo · Estimación solo para comparar **$0.04** por segundo de vídeo |
| ConfiguraciónPrecio del vídeo | Tabla de tarifas— | Cantidad prevista— | Unidad de facturaciónpor segundo de vídeo | Condiciones de facturaciónresolution: 768p | Cargo Salida · Precio del vídeo · Estimación solo para comparar **$0.072** por segundo de vídeo |
| ConfiguraciónPrecio del vídeo | Tabla de tarifas— | Cantidad prevista— | Unidad de facturaciónpor segundo de vídeo | Condiciones de facturaciónmodo de generación: reference; resolución: 2k | Cargo Salida · Precio del vídeo · Estimación solo para comparar **$0.36** por segundo de vídeo |
| ConfiguraciónPrecio del vídeo | Tabla de tarifas— | Cantidad prevista— | Unidad de facturaciónpor segundo de vídeo | Condiciones de facturaciónmodo de generación: reference; resolución: 480p | Cargo Salida · Precio del vídeo · Estimación solo para comparar **$0.14** por segundo de vídeo |
| ConfiguraciónPrecio del vídeo | Tabla de tarifas— | Cantidad prevista— | Unidad de facturaciónpor segundo de vídeo | Condiciones de facturaciónmodo de generación: reference; resolución: 768p | Cargo Salida · Precio del vídeo · Estimación solo para comparar **$0.2** por segundo de vídeo |
| Configuraciónimagen de referencia de entrada | Tabla de tarifas— | Cantidad prevista— | Unidad de facturaciónpor imagen de referencia de entrada | Condiciones de facturación— | Cargo Entrada · imagen de referencia de entrada · Estimación solo para comparar **$0.08** por imagen de referencia de entrada |
| ConfiguraciónCoste estimado de generación | Tabla de tarifas— | Cantidad previstaestimación para una generación | Unidad de facturación— | Condiciones de facturación— | Cargo Salida · Coste estimado de generación · Estimación solo para comparar **$0.2** estimación previa a la generación Esta estimación no es un cargo adicional ni una tarifa fija para la generación completada. |

Ailoot reserva un importe estimado antes de la solicitud. Tras obtener el resultado, liquida el cargo definitivo según el uso medido. En las respuestas en flujo, la liquidación usa el registro de uso final. [Cómo funcionan la reserva y la liquidación →](https://ailoot.ai/docs/es/billing/reserve/)

#### Detalles de la tarifa de referencia

Las tablas de referencia del modelo no cambian la selección del método, las estimaciones de coste ni los cargos. Los cargos aplicados usan las tarifas del método Ailoot seleccionado.

Referencias de precios de configuraciones de vídeo

#### Precios por configuración

Relaciona cada cargo con las condiciones mostradas. Usa una tarifa para cada conjunto de configuraciones alternativas.

| Configuración | Condiciones de facturación | Cargo |
| --- | --- | --- |
| ConfiguraciónPrecio del vídeo | Condiciones de facturaciónresolution: 2k | Cargo Salida · Precio del vídeo **$0.18** por segundo de vídeo Referencia de precios publicada para la configuración mostrada. Los cargos finales se calculan según la configuración realmente facturada. |
| ConfiguraciónPrecio del vídeo | Condiciones de facturaciónresolution: 480p | Cargo Salida · Precio del vídeo **$0.04** por segundo de vídeo Referencia de precios publicada para la configuración mostrada. Los cargos finales se calculan según la configuración realmente facturada. |
| ConfiguraciónPrecio del vídeo | Condiciones de facturaciónresolution: 768p | Cargo Salida · Precio del vídeo **$0.06** por segundo de vídeo Referencia de precios publicada para la configuración mostrada. Los cargos finales se calculan según la configuración realmente facturada. |
| ConfiguraciónPrecio del vídeo | Condiciones de facturaciónmodo de generación: reference; resolución: 2k | Cargo Salida · Precio del vídeo **$0.36** por segundo de vídeo Referencia de precios publicada para la configuración mostrada. Los cargos finales se calculan según la configuración realmente facturada. |
| ConfiguraciónPrecio del vídeo | Condiciones de facturaciónmodo de generación: reference; resolución: 480p | Cargo Salida · Precio del vídeo **$0.08** por segundo de vídeo Referencia de precios publicada para la configuración mostrada. Los cargos finales se calculan según la configuración realmente facturada. |
| ConfiguraciónPrecio del vídeo | Condiciones de facturaciónmodo de generación: reference; resolución: 768p | Cargo Salida · Precio del vídeo **$0.12** por segundo de vídeo Referencia de precios publicada para la configuración mostrada. Los cargos finales se calculan según la configuración realmente facturada. |

### Solicitudes de ejemplo

#### Ailoot Ultra · Vídeo

curl · crea un vídeo

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"heygen/heygen-video-1","prompt":"A serene mountain landscape at sunset","resolution":"480p"}', encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
```

### Recibir y guardar resultados

#### Ailoot Ultra · Vídeo

URL firmadas de contenido bajo tu titularidad

- `GET /v1/videos/{public_id}`
- `GET /v1/videos/{public_id}/content`

##### Consultar el estado de la tarea

Obtener el estado de la operación original con GET

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
  -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
```

Otras consultas de contenido

Guarda todos los resultados completados que te pertenecen

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
    if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
    urls.append((str(i),u))
for label,path in urls:
    u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
    if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
    target=Path('owned-'+label+'.bin')
    subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
```

##### Conserva todos los resultados completados

Guarda todos los vídeos completados o archivos recibidos; descarga cada URL de archivo que se haya devuelto.

Conserva todos los resultados reales bajo tu titularidad y los metadatos medidos que se devuelvan.

##### Si es necesario revisar la respuesta original

503 result\_pending\_check + originalid + X-Should-Retry:false; no repitas nunca la operación original

Campos de respuesta

| Campo | Tipo | Significado |
| --- | --- | --- |
| Campo`index` | Tipointeger | SignificadoPosición de este vídeo en la lista de resultados, empezando por cero. |
| Campo`content_url` | Tipostring | SignificadoURL HTTPS firmada de descarga de este vídeo completado. |
| Campo`sha256` | Tipostring \| null | SignificadoHuella SHA-256 de los bytes del vídeo original; null si no está disponible. |
| Campo`size_bytes` | Tipointeger \| null | SignificadoTamaño del archivo de vídeo original en bytes; null si no está disponible. |
| Campo`duration_ms` | Tipointeger \| null | SignificadoDuración medida del vídeo en milisegundos; null si no está disponible. |
| Campo`width` | Tipointeger \| null | SignificadoAnchura del vídeo en píxeles; null si no está disponible. |
| Campo`height` | Tipointeger \| null | SignificadoAltura del vídeo en píxeles; null si no está disponible. |
| Campo`video_codec` | Tipostring \| null | SignificadoIdentificador del códec de vídeo; null si no se ha registrado. |
| Campo`has_audio` | Tipoboolean \| null | SignificadoIndica si el vídeo contiene una pista de audio; null si no se ha medido. |
| Campo`audio_codec` | Tipostring \| null | SignificadoIdentificador del códec de audio; null cuando no se ha registrado ninguno. |

Errores y siguientes pasos

| Respuesta | Condición | Siguiente paso |
| --- | --- | --- |
| Respuesta404 · `not_found_error` | CondiciónEl acceso al vídeo no está disponible o no se ha encontrado este ID de vídeo. | Siguiente pasoComprueba el acceso al vídeo. Para un vídeo existente, usa su ID público original y la misma clave API. |
| Respuesta401 · `authentication_error` | CondiciónLa clave API no corresponde a la cuenta autenticada. | Siguiente pasoComprueba tu clave API y el acceso de tu cuenta antes de enviar la solicitud. |
| Respuesta400 · `invalid_request_error` | CondiciónNo se ha podido leer la solicitud o el índice de descarga no es válido. | Siguiente pasoCorrige el cuerpo de la solicitud. Para una descarga, elige un índice de salida devuelto por la tarea original. |
| Respuesta422 · `price_unavailable` | CondiciónNo se puede calcular el precio de la configuración de vídeo seleccionada. | Siguiente pasoElige una configuración de vídeo compatible y completa sus opciones obligatorias antes de enviar una solicitud corregida. |
| Respuesta422 · `invalid_request_error` | CondiciónUna entrada de vídeo o la tarea original de continuación no es válida. | Siguiente pasoUsa entradas HTTPS válidas. Para continuar, usa el ID público de tu vídeo original completado con la misma clave API. |
| Respuesta402 · `billing_error` | CondiciónEl saldo disponible o los límites no permiten efectuar una reserva. | Siguiente pasoComprueba tu saldo disponible y tus límites antes de enviar una nueva solicitud. |
| Respuesta503 · `server_error` | CondiciónLa verificación del vídeo, el almacenamiento o el acceso al servicio no están disponibles temporalmente. | Siguiente pasoEspera a que el servicio esté disponible. Si ya tienes un ID de vídeo, comprueba esa tarea original en lugar de crear otra generación. |
| Respuesta503 · `result_pending_check` | CondiciónEs necesario comprobar el resultado del vídeo original y el cargo. | Siguiente pasoConserva el ID de vídeo devuelto y comprueba esa tarea. No envíes una solicitud de generación sustitutiva mientras se esté comprobando. |
| Respuesta503 · `owned_result_unavailable` | CondiciónLa descarga del vídeo existente no está disponible temporalmente. | Siguiente pasoComprueba más tarde la misma tarea de vídeo y descarga su resultado existente. Una nueva generación crea una operación independiente. |
| Respuesta409 · `video_not_ready` | CondiciónEl contenido del vídeo no se ha publicado. | Siguiente pasoComprueba el estado de la tarea original. Descarga cuando indique completed; si indica failed, sigue su aviso de comprobación del cargo. |

### Alias

#### Alias del modelo

**Ailoot Ultra** [`heygen/heygen-video-1`](https://ailoot.ai/models/es/#m=heygen%2Fheygen-video-1&route=Ultra&caller=heygen%2Fheygen-video-1&fmt=videos)

#### Alias de rutas de métodos

Usa las rutas de método indicadas arriba.

#### ID de modelo relacionados

[`heygen/heygen-video-1`](https://ailoot.ai/models/es/#m=heygen%2Fheygen-video-1&route=Ultra&caller=heygen%2Fheygen-video-1&fmt=videos)

FAQ · HeyGen: HeyGen Video

¿Qué entradas y resultados están disponibles?

`POST /v1/videos` · `heygen/heygen-video-1`: `text`, `image`, `audio`, `video` → `video`

¿Qué campos utiliza la solicitud?

`POST /v1/videos` · `heygen/heygen-video-1`: `model`, `prompt`, `duration`, `resolution`, `aspect_ratio`, `generate_audio`, `frame_images`, `input_references`, `seed`, `callback_url`, `session_id`, `trace`, `user`

¿Qué límites se aplican?

`POST /v1/videos` · `heygen/heygen-video-1`: `duration.minimum`: `1`; `duration.maximum`: `600`; `frame_images.max_items`: `1`; `frame_images.min_items`: `1`; `seed.minimum`: `-9223372036854775808`; `seed.maximum`: `9223372036854775807`

Conecta Ailoot a Claude Code, OpenCode, Hermes o tu aplicación.

## La empresa y su cartera de proyectos

La empresa y su cartera de proyectos: millones de clientes; ventas por miles de millones al mes.

## Compra tokens con descuento.

Ahorro por suscripción para trabajo habitual. Códigos promocionales: hasta el 50% al comprar tokens.

Suscripción

Elige un plan con descuento para tus peticiones habituales.

Código de hasta el 50%

Introduce el código al comprar. El precio se recalcula según la promoción vigente.

Gasto en el historial

Modelo, tokens e importe quedan guardados por cada petición.

[Elegir suscripción](https://ailoot.ai/docs/es/billing/subscriptions/) · [Consultar precios de modelos](https://ailoot.ai/models/es/)

## Conecta la API al producto que vendes.

SaaS, aplicaciones y bots bajo la oferta y el acuerdo de licencia Ailoot. Solicita una licencia de reventa para redistribuir el acceso.

Aplicación comercial

Integra generación de texto, imágenes, vídeo y sonido en funciones de pago de tu servicio.

Licencia para revendedores

Envía descripción del proyecto y esquema de acceso. Solicita condiciones escritas de uso y reventa.

Documentos en la web

La oferta, el acuerdo de licencia y la política de datos están disponibles antes de conectar.

[Solicitar licencia de reventa](mailto:support@ailoot.ai) · [Oferta y acuerdo de licencia](https://ailoot.ai/legal/offer?lang=es)

## Ailoot · La empresa y su cartera de proyectos





Ailoot se apoya en la experiencia operativa acumulada, una amplia base de clientes, un servicio estable y el seguimiento continuo de KPI.





La empresa y su cartera de proyectos: millones de clientes; ventas por miles de millones al mes.





Ailoot aplica esa experiencia operativa al acceso por API a funciones de IA en productos de clientes, agentes, aplicaciones y automatizaciones.