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

# HeyGen: HeyGen Video

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

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

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

- [**Ailoot Ultra · Video** `POST /v1/videos` `heygen/heygen-video-1`](https://ailoot.ai/models/es-mx/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 sujeto, entorno, luz y sonido juntos desde un encargo creativo. Cada clip dura 5–15 segundos e incluye una pista generada con diálogo, ambiente y efectos. Las entradas útiles incluyen descripción de escena, fotografía de producto o material que establezca persona, lugar o movimiento. El recurso resultante es una escena corta para presentación de producto, inserción de bienvenida, vista de inmueble u otro trabajo de video editado.

Tres modos dan distintas funciones a las entradas. Texto a video crea desde la instrucción. Imagen a video comienza literalmente con la imagen aportada y sigue el encargo de acción. Referencia a video usa imágenes, video y audio opcional para una composición nueva; exige al menos una imagen o video de referencia. Elige primer fotograma si la apertura debe coincidir con una imagen fija o referencias si un objeto conocido debe aparecer en otra composición. Este modelo de escenas difiere de los motores de avatares y del flujo de composición Video Agent de HeyGen.

La guía favorece indicaciones concretas y detalladas: un sujeto, una locación y una acción acotada, con cámara fija o suave. Describe posición de cámara, lente o intención de profundidad de campo, luz, textura y color. Explica los puntos de contacto entre objetos cuando la acción dependa de ellos. Un ejemplo original puede usar una foto de un termo de viaje y pedir que esté sobre un mostrador de madera mientras una persona habla a su lado, con un pequeño acercamiento al termo. Revisa forma, posición y marcas visibles.

Las listas admiten hasta nueve imágenes, tres videos y tres audios, con máximo de doce referencias en total. Se numeran por tipo en el formato del fabricante: primera imagen \<Picture 1\>, primer video \<Video 1\>. Da una función explícita a cada referencia. El modelo lee los primeros cinco segundos de cada video; prepara ahí la sección pertinente. La referencia API también exige proporciones de video entre 1:4 y 4:1. Un clip largo cuyo movimiento deseado aparece al final es mala preparación para esa ventana de cinco segundos.

La interfaz acepta un recurso HTTPS directamente accesible, un identificador de recurso cargado o base64 integrado. La guía enumera máximos de imagen de 16 MB por URL y 5 MB integrado; video o audio de hasta 32 MB por URL y 16 MB integrado. Prepara fuentes legibles con sujeto distinguible y sin indicaciones contradictorias entre referencias. Conserva la orientación deseada en el primer fotograma. Estos detalles corresponden al flujo de referencias del fabricante y ayudan a organizar materiales para el modo elegido.

Dirige el sonido en el mismo encargo que la imagen. Indica diálogo, interpretación vocal, ambiente de sala y efectos concretos, incluida cercanía o distancia. Especifica el tratamiento musical cuando deba haber solo habla y ambiente. La guía sugiere aproximadamente 2.5 palabras habladas por segundo como estimación de planificación; deja espacio para pausas y acción. Una introducción breve puede ser una línea seguida de un momento que revele el producto. Escucha las palabras reales y si el sonido encaja con espacio y acción.

La duración se selecciona en segundos enteros de cinco a quince, con cinco por defecto. La resolución es una clase de tamaño: 480p, 768p, 1080p o 2k. Las relaciones documentadas son 21:9, 16:9, 4:3, 1:1, 3:4 y 9:16. En texto y referencia a video a 1080p o 2k, elige 16:9 o 9:16; se documenta encuadre adaptativo de referencia a 480p y 768p. Imagen a video sigue las proporciones iniciales, así que recorta antes cuando cambie la forma requerida. Revisa dimensiones reales en vez de suponer que la clase implica un par convencional de píxeles.

La guía especifica MP4 con imagen H.264 y audio AAC estéreo de 32 kHz. La generación es asíncrona y el trabajo completo aporta ubicación reproducible, duración y dimensiones. La ubicación firmada puede renovarse al consultar de nuevo el trabajo. Conserva clip, referencias y encargo para revisión de edición. El registro pendiente o en procesamiento sigue la generación; el video completo es el recurso de producción que evaluar en imagen, habla y sonido.

El fabricante documenta mejora de instrucciones con opciones turbo, quality y disabled; disabled conserva la redacción preparada. Una semilla fija sirve al comparar el cambio de una cláusula manteniendo otras entradas. Registra semilla y ajustes con el encargo. Para letras en pantalla, mantén breve la frase y escríbela exactamente; la guía recomienda componer después párrafos, letra pequeña y diagramas etiquetados. Revisa cada carácter de un título generado en vez de suponer reproducción correcta.

La guía identifica como menos fiables el texto largo en pantalla, movimiento orgánico suave de pétalos, papel o cabello y manipulación cercana con manos. Para explicar un procedimiento, deja que una línea clara transmita los pasos mientras la imagen muestra persona u objeto estables; usa visuales verificados por separado si la operación física debe ser exacta. Revisa toda la toma para continuidad de objetos, contacto, detalle de rostro y manos, diálogo y sonido. Una lista breve de cambios para la siguiente toma mantiene práctico un encargo detallado.

**Ailoot Ultra · Video** `POST /v1/videos` `heygen/heygen-video-1`

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

HeyGen /`heygen/heygen-video-1`

### Inicio

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

Entradas aceptadas

Texto · Imágenes · Audio · Video

Resultados

Video

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

**Ailoot Ultra · Video** `POST /v1/videos`

Entrada

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

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: Arreglo de objetos de fotograma. Cada objeto tiene type=image\_url, image\_url que contiene url y frame\_type. Usa una URL HTTPS de imagen y establece frame\_type en first\_frame. Cada función de fotograma puede aparecer como máximo una vez. Claves exactas: type, image\_url, frame\_type Condiciones: Estas claves describen cada objeto de fotograma; image\_url contiene únicamente url. Omite frame\_images para una solicitud de solo 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 video** · Una instrucción escrita. · Obligatorio: model, prompt, duration

`Proporciona prompt como texto y duration en segundos enteros. Elige una resolución compatible y, si es necesario, 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 video** · Una instrucción escrita y una imagen del primer fotograma. · Obligatorio: model, prompt, duration, frame\_images

`frame_images es un arreglo. Cada objeto de fotograma tiene type, image_url y frame_type; image_url contiene url. Establece type en image_url. Usa first_frame. Cada función de fotograma puede aparecer como máximo una vez. Proporciona una URL HTTPS pública de imagen para cada fotograma. Elige una resolución compatible y, si es necesario, 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 compatibles de imagen, video y audio. · Obligatorio: model, prompt, duration, input\_references

`input_references es un arreglo de objetos. Establece type en image_url, video_url o audio_url y usa 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 es necesario, 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`

### Tarifas

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

Las tarifas mostradas permiten estimar el costo antes de la generación. El cargo final se calcula a partir del costo registrado para la generación original. La duración medida de la salida y las cantidades estimadas no son 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 fast

Sin especificar Cuando se selecciona el modo fast

Modo flex

Sin especificar Cuando se selecciona el modo flex

Esfuerzo máximo de razonamiento

Sin especificar Cuando el esfuerzo máximo de razonamiento usa el ajuste 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 video | Tabla de tarifas— | Cantidad prevista— | Unidad de facturaciónpor segundo de video | Condiciones de facturaciónresolution: 2k | Cargo Salida · Precio del video · Estimación solo para comparar **$0.2** por segundo de video |
| ConfiguraciónPrecio del video | Tabla de tarifas— | Cantidad prevista— | Unidad de facturaciónpor segundo de video | Condiciones de facturaciónresolution: 480p | Cargo Salida · Precio del video · Estimación solo para comparar **$0.04** por segundo de video |
| ConfiguraciónPrecio del video | Tabla de tarifas— | Cantidad prevista— | Unidad de facturaciónpor segundo de video | Condiciones de facturaciónresolution: 768p | Cargo Salida · Precio del video · Estimación solo para comparar **$0.072** por segundo de video |
| ConfiguraciónPrecio del video | Tabla de tarifas— | Cantidad prevista— | Unidad de facturaciónpor segundo de video | Condiciones de facturaciónmodo de generación: reference; resolución: 2k | Cargo Salida · Precio del video · Estimación solo para comparar **$0.36** por segundo de video |
| ConfiguraciónPrecio del video | Tabla de tarifas— | Cantidad prevista— | Unidad de facturaciónpor segundo de video | Condiciones de facturaciónmodo de generación: reference; resolución: 480p | Cargo Salida · Precio del video · Estimación solo para comparar **$0.14** por segundo de video |
| ConfiguraciónPrecio del video | Tabla de tarifas— | Cantidad prevista— | Unidad de facturaciónpor segundo de video | Condiciones de facturaciónmodo de generación: reference; resolución: 768p | Cargo Salida · Precio del video · Estimación solo para comparar **$0.2** por segundo de video |
| 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ónCosto estimado de generación | Tabla de tarifas— | Cantidad previstaestimación para una generación | Unidad de facturación— | Condiciones de facturación— | Cargo Salida · Costo 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 por la generación completada. |

Ailoot reserva un monto 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-mx/billing/reserve/)

#### Detalles de la tarifa de referencia

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

Referencias de precios por configuración de video

#### 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 video | Condiciones de facturaciónresolution: 2k | Cargo Salida · Precio del video **$0.18** por segundo de video Referencia de precio publicada para la configuración mostrada. Los cargos finales corresponden a la configuración realmente facturada. |
| ConfiguraciónPrecio del video | Condiciones de facturaciónresolution: 480p | Cargo Salida · Precio del video **$0.04** por segundo de video Referencia de precio publicada para la configuración mostrada. Los cargos finales corresponden a la configuración realmente facturada. |
| ConfiguraciónPrecio del video | Condiciones de facturaciónresolution: 768p | Cargo Salida · Precio del video **$0.06** por segundo de video Referencia de precio publicada para la configuración mostrada. Los cargos finales corresponden a la configuración realmente facturada. |
| ConfiguraciónPrecio del video | Condiciones de facturaciónmodo de generación: reference; resolución: 2k | Cargo Salida · Precio del video **$0.36** por segundo de video Referencia de precio publicada para la configuración mostrada. Los cargos finales corresponden a la configuración realmente facturada. |
| ConfiguraciónPrecio del video | Condiciones de facturaciónmodo de generación: reference; resolución: 480p | Cargo Salida · Precio del video **$0.08** por segundo de video Referencia de precio publicada para la configuración mostrada. Los cargos finales corresponden a la configuración realmente facturada. |
| ConfiguraciónPrecio del video | Condiciones de facturaciónmodo de generación: reference; resolución: 768p | Cargo Salida · Precio del video **$0.12** por segundo de video Referencia de precio publicada para la configuración mostrada. Los cargos finales corresponden a la configuración realmente facturada. |

### Solicitudes de ejemplo

#### Ailoot Ultra · Video

curl · crea un video

```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 · Video

URL firmadas de contenido que te pertenece

- `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 videos completados o archivos recibidos; descarga cada URL de archivo que se haya devuelto.

Conserva cada salida real que te pertenezca y los metadatos medidos que se devuelvan con ella.

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

503 result\_pending\_check + id original + X-Should-Retry:false; nunca repitas el envío original

Campos de respuesta

| Campo | Tipo | Significado |
| --- | --- | --- |
| Campo`index` | Tipointeger | SignificadoPosición de este video en la lista de salidas, con índice que comienza en cero. |
| Campo`content_url` | Tipostring | SignificadoURL HTTPS firmada de descarga de este video completado. |
| Campo`sha256` | Tipostring \| null | SignificadoResumen SHA-256 de los bytes del video original; null si no está disponible. |
| Campo`size_bytes` | Tipointeger \| null | SignificadoTamaño del archivo de video original en bytes; null si no está disponible. |
| Campo`duration_ms` | Tipointeger \| null | SignificadoDuración medida del video en milisegundos; null si no está disponible. |
| Campo`width` | Tipointeger \| null | SignificadoAncho del video en píxeles; null si no está disponible. |
| Campo`height` | Tipointeger \| null | SignificadoAlto del video en píxeles; null si no está disponible. |
| Campo`video_codec` | Tipostring \| null | SignificadoIdentificador del códec de video; null si no se registró. |
| Campo`has_audio` | Tipoboolean \| null | SignificadoIndica si el video contiene una pista de audio; null si no se midió. |
| Campo`audio_codec` | Tipostring \| null | SignificadoIdentificador del códec de audio; null cuando no se registra ningún identificador. |

Errores y siguientes pasos

| Respuesta | Condición | Siguiente paso |
| --- | --- | --- |
| Respuesta404 · `not_found_error` | CondiciónEl acceso al video no está disponible o no se encontró este ID de video. | Siguiente pasoVerifica el acceso al video. Para un video existente, usa su ID público original y la misma clave API. |
| Respuesta401 · `authentication_error` | CondiciónLa clave API no coincide con la cuenta autenticada. | Siguiente pasoRevisa tu clave API y el acceso de tu cuenta antes de enviar. |
| Respuesta400 · `invalid_request_error` | CondiciónNo se pudo 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 cotizar la configuración de video seleccionada. | Siguiente pasoElige una configuración de video compatible y completa sus opciones obligatorias antes de enviar una solicitud corregida. |
| Respuesta422 · `invalid_request_error` | CondiciónUna entrada de video o la tarea original de continuación no es válida. | Siguiente pasoUsa entradas HTTPS válidas. Para una continuación, usa el ID público de tu video original completado con la misma clave API. |
| Respuesta402 · `billing_error` | CondiciónEl saldo disponible o los límites no permiten reservar fondos. | Siguiente pasoRevisa tu saldo disponible y tus límites antes de enviar una solicitud nueva. |
| Respuesta503 · `server_error` | CondiciónLa verificación del video, 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 video, consulta esa tarea original en lugar de crear otra generación. |
| Respuesta503 · `result_pending_check` | CondiciónEl resultado y el cargo del video original requieren verificación. | Siguiente pasoConserva el ID de video devuelto y consulta esa tarea. No envíes una solicitud de generación de reemplazo mientras se verifica. |
| Respuesta503 · `owned_result_unavailable` | CondiciónLa descarga del video existente no está disponible temporalmente. | Siguiente pasoConsulta más tarde la misma tarea de video y descarga su salida existente. Una generación nueva crea una operación independiente. |
| Respuesta409 · `video_not_ready` | CondiciónEl contenido del video no se ha publicado. | Siguiente pasoConsulta el estado de la tarea original. Descarga cuando indique completed; si indica failed, sigue su aviso de verificación del cargo. |

### Alias

#### Alias del modelo

**Ailoot Ultra** [`heygen/heygen-video-1`](https://ailoot.ai/models/es-mx/#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-mx/#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-mx/billing/subscriptions/) · [Consultar precios de modelos](https://ailoot.ai/models/es-mx/)

## 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-mx)

## 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.