grok-imagine-video

Grok Imagine Video crea videos cortos a partir de descripciones de texto y permite elegir la duración y la relación de aspecto. El propio modelo de xAI también admite animación de imágenes y edición dirigida de video.

Ailoot · Generación de video POST /v1/videos/generations grok-imagine-video

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.

De la descripción al video

Grok Imagine Video crea videos a partir de texto. El propio modelo de xAI también dispone de modos con una imagen o un video original. En el método publicado de generación de Ailoot, la entrada es una descripción de texto y el resultado, un video.

La generación es asíncrona: primero se crea una tarea y después se obtiene su estado y el resultado terminado mediante su identificador. Según xAI, crear un video puede tardar varios minutos; el tiempo depende de la complejidad de la escena, la duración, la resolución y el modo elegido.

Duración y relación de aspecto

La creación de videos admite una duración de 1 a 15 segundos. Las relaciones de aspecto incluyen 1:1, 16:9, 9:16, 4:3, 3:4, 3:2 y 2:3; el formato predeterminado es 16:9. Esta versión dispone de 480p y 720p; 1080p corresponde a la versión 1.5.

Animación de una imagen original

En el modo de xAI con imagen, esta se convierte en el primer fotograma y las instrucciones de texto definen el movimiento. De forma predeterminada, las proporciones del video coinciden con las de la imagen original. Una relación de aspecto definida explícitamente cambia esas proporciones y puede estirar la imagen.

Edición dirigida

Al trabajar con un video terminado, el modelo aplica los cambios descritos y conserva el resto del contenido de la escena. Este modo ayuda a modificar el elemento deseado conservando la puesta en escena del video original. La duración y las proporciones se heredan del original; no se establece una duración ni una relación de aspecto nuevas.

El video original para edición está limitado a 8,7 segundos y el resultado, a una resolución máxima de 720p. El material en 1080p se reduce a 720p. Los ajustes de generación a partir de texto no se trasladan automáticamente a la edición.

Continuación de un video terminado

En un modo independiente de xAI, esta versión continúa el video original desde su último fotograma. El MP4 original debe durar entre 2 y 15 segundos; el fragmento añadido, entre 2 y 10 segundos, con 6 como valor predeterminado. El resultado une el video original y su continuación. Las proporciones y la resolución se heredan del original, con un límite de 720p; en este modo no se pueden cambiar por separado. Esta capacidad del fabricante es distinta de la generación de Ailoot a partir de texto publicada.

Referencias y límites de la versión

xAI contempla el uso de referencias visuales para orientar el aspecto de las personas, la ropa y los objetos de la escena. Una referencia define los rasgos visuales, no la imagen exacta del primer fotograma. En la versión clásica de Grok Imagine Video no se puede combinar un fotograma inicial con referencias.

Esta versión no admite fijar de forma exacta el último fotograma ni fotogramas clave intermedios. Estas capacidades pertenecen a Grok Imagine Video 1.5. La generación, la animación de una imagen original y la modificación de un video terminado son modos distintos; el método publicado de Ailoot descrito aquí corresponde a generación a partir de texto.

Ailoot · Generación de video POST /v1/videos/generations grok-imagine-video

grok-imagine-video

xAI /grok-imagine-video

Inicio

Entradas aceptadas: Texto
Resultados: Video

Disponible en Ailoot · entradas y métodos

Ailoot · Generación de video POST /v1/videos/generations

Entrada: text
Salida: video
Formato de salida: mp4

Campo	Tipo	Requisito	Valores y límites	Predeterminado
Campo`model`	Tipo`string`	RequisitoObligatorio	Valores y límites grok-imagine-video	Predeterminado—
Campo`prompt`	Tipo`string`	RequisitoOpcional	Valores y límites Longitud mínima: 1	Predeterminado—
Campo`duration`	Tipo`integer`	RequisitoOpcional	Valores y límites Mínimo: 1 Máximo: 15 Condiciones: No proporciones duration y seconds al mismo tiempo Unidad: segundos	Predeterminado1
Campo`seconds`	Tipo`integer\|integer_string`	RequisitoOpcional	Valores y límites Mínimo: 1 Máximo: 15 Alternativa: duration	Predeterminado—
Campo`resolution`	Tipo`string`	RequisitoOpcional	Valores y límites 480p, 720p	Predeterminado480p
Campo`aspect_ratio`	Tipo`string`	RequisitoOpcional	Valores y límites 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 Condiciones: Si se proporciona una imagen de entrada y se omite la relación de aspecto, el proveedor hereda la de la imagen	Predeterminado16:9
Campo`size`	Tipo`string`	RequisitoOpcional	Valores y límites 1280x720, 720x1280, 1920x1080, 1080x1920 Condiciones: Debe coincidir con resolution/aspect_ratio si se especifican ambos	Predeterminado—
Campo`image`	Tipo`object`	RequisitoOpcional	Valores y límites Condiciones: Imagen de entrada real y compatible; permite omitir la instrucción	Predeterminado—

Combinaciones de materiales de entrada

Texto a video · Obligatorio: prompt

Imagen a video · Obligatorio: image

Parámetros del método y ciclo de vida

Parámetro	Contrato
Parámetro`material_types`	Contratotext
Parámetro`required`	Contratonull
Parámetro`optional_controls`	Contratonull

Ciclo de vida: submit_once_poll_original

GET /v1/videos/{request_id}

GET /v1/videos/generations/{request_id}

GET /v1/videos/{request_id}/content

GET /v1/videos/generations/{request_id}/content

Las estructuras e ID de los métodos son exactos; la capacidad del proveedor y la admisión son conceptos distintos.

Tarifas

Tarifas de métodos Ailoot

Ailoot Generación de videoPOST /v1/videos/generations

Entrada: USD 0.002 por imagen de entrada
Entrada: USD 0.01 por segundo de video de entrada
Salida: USD 0.05 por segundo a 480p
Salida: USD 0.07 por segundo a 720p

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 →

Solicitudes de ejemplo

Ailoot · Generación de video

Ejemplo de video

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl https://api.ailoot.ai/v1/videos/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "grok-imagine-video", "prompt": "A person walks slowly through a quiet garden as the camera tracks from the side."}'

Recibir y guardar resultados

Ailoot · Generación de video

mp4

GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content

Consultar el estado de la tarea

Obtener estado con GET

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_VIDEO_ID
video_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1
curl "https://api.ailoot.ai/v1/videos/generations/$video_id" \
  -H "Authorization: Bearer $AILOOT_API_KEY"

Otras consultas de contenido

Obtener contenido con GET

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_VIDEO_ID
video_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1
curl "https://api.ailoot.ai/v1/videos/generations/$video_id/content" \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  --output video.mp4

Conserva todos los resultados completados

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

Conserva el JSON de estado completo y el request_id real. Una respuesta completada con status=done contiene video.url con una URL de contenido que te pertenece. Conserva la duración indicada y todos los campos devueltos del resultado.

Si es necesario revisar la respuesta original

Consulta el trabajo original existente; nunca repitas un envío de resultado desconocido.

Campos de respuesta

Campo	Tipo
Campo`request_id`	Tipostring
Campo`id`	Tipostring
Campo`status`	Tipostring
Campo`video.url`	Tipoowned signed content URL
Campo`video.duration`	Tiponumber
Campo`video.respect_moderation`	Tipoboolean

Errores y siguientes pasos

Respuesta	Condición	Siguiente paso
Respuesta400 · `invalid_request_error`	CondiciónCampos obligatorios, representación del material o valor del parámetro no válidos	Siguiente pasoCorrige los campos indicados antes de una nueva solicitud de creación.
Respuesta409 · `video_not_ready`	CondiciónEl contenido del resultado original todavía no está disponible	Siguiente pasoConsulta periódicamente el ID original devuelto y respeta Retry-After.
Respuesta`server_error`	CondiciónLa respuesta devuelta indica que la operación o el resultado requiere una revisión	Siguiente pasoConserva el ID original de operación o tarea devuelto, los encabezados de la solicitud y la respuesta; continúa con las consultas admitidas de esa operación original. No vuelvas a enviar la solicitud de creación.

Alias

Alias del modelo

Ailoot grok-imagine-video

Alias de rutas de métodos

Usa las rutas de método indicadas arriba.

ID de modelo relacionados

grok-imagine-video

FAQ · grok-imagine-video

¿Qué entradas y resultados están disponibles?: POST /v1/videos/generations · grok-imagine-video: text → video
¿Qué campos utiliza la solicitud?: POST /v1/videos/generations · grok-imagine-video: model, prompt, duration, seconds, resolution, aspect_ratio, size, image
¿Qué límites se aplican?: POST /v1/videos/generations · grok-imagine-video: duration.minimum: 1; duration.maximum: 15; seconds.minimum: 1; seconds.maximum: 15

grok-imagine-video