grok-imagine-video
Grok Imagine Video crea vídeos 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 vídeo.
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 vídeo
Grok Imagine Video crea vídeos a partir de texto. El propio modelo de xAI también dispone de modos con una imagen o un vídeo original. En el método publicado de generación de Ailoot, la entrada es una descripción de texto y el resultado, un vídeo.
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 vídeo 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 vídeos 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 vídeo 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 vídeo 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 vídeo 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 vídeo 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 vídeo terminado
En un modo independiente de xAI, esta versión continúa el vídeo 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 vídeo 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 vídeo terminado son modos distintos; el método publicado de Ailoot descrito aquí corresponde a generación a partir de texto.
Ailoot · Vídeo POST /v1/videos/generations grok-imagine-video
grok-imagine-videoPrimeros pasos
Grok Imagine Video crea vídeos 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 vídeo.
- Entradas aceptadas
- Texto
- Resultados
- Vídeo
Disponible en Ailoot · entradas y métodos
Ailoot · Vídeo POST /v1/videos/generations
- Tipos de entrada
text- Tipos de salida
video- Formato de salida
- mp4
| Campo | Tipo | Requisito | Valores y límites | Predeterminado |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObligatorio | Valores y límites grok-imagine-video | Predeterminado— |
Campoprompt | Tipostring | RequisitoOpcional | Valores y límites Longitud mínima: 1 | Predeterminado— |
Campoduration | Tipointeger | RequisitoOpcional | Valores y límites Mínimo: 1 Máximo: 15 Condiciones: No proporciones duration y seconds a la vez Unidad: segundos | Predeterminado1 |
Camposeconds | Tipointeger|integer_string | RequisitoOpcional | Valores y límites Mínimo: 1 Máximo: 15 Alternativa: duration | Predeterminado— |
Camporesolution | Tipostring | RequisitoOpcional | Valores y límites 480p, 720p | Predeterminado480p |
Campoaspect_ratio | Tipostring | 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 |
Camposize | Tipostring | RequisitoOpcional | Valores y límites 1280x720, 720x1280, 1920x1080, 1080x1920 Condiciones: Debe coincidir con resolution/aspect_ratio si se especifican ambos | Predeterminado— |
Campoimage | Tipoobject | RequisitoOpcional | Valores y límites Condiciones: Imagen de entrada real y compatible; permite omitir la instrucción de texto | Predeterminado— |
Combinaciones de materiales de entrada
Texto a vídeo · Obligatorio: prompt
Imagen a vídeo · Obligatorio: image
Parámetros del método y ciclo de vida
| Parámetro | Contrato |
|---|---|
Parámetromaterial_types | Contratotext |
Parámetrorequired | Contratonull |
Parámetrooptional_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.
Planes
Tarifas de métodos Ailoot
POST /v1/videos/generations- Entrada
- 0,002 US$ por imagen de entrada
- Entrada
- 0,01 US$ por segundo de vídeo de entrada
- Salida
- 0,05 US$ por segundo a 480p
- Salida
- 0,07 US$ por segundo a 720p
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 →
Solicitudes de ejemplo
Ailoot · Vídeo
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 · Vídeo
mp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Consultar el estado de la tarea
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
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.mp4Conserva todos los resultados completados
Guarda todos los vídeos completados o archivos recibidos; descarga cada URL de archivo que se haya devuelto.
Conserva el JSON completo del estado y el request_id real. Una respuesta completada con status=done contiene video.url con una URL de contenido bajo tu titularidad. Conserva la duración indicada y todos los campos de resultado devueltos.
Si es necesario revisar la respuesta original
Consulta el trabajo original existente; no vuelvas a enviar nunca un envío de resultado desconocido.
Campos de respuesta
| Campo | Tipo |
|---|---|
Camporequest_id | Tipostring |
Campoid | Tipostring |
Campostatus | Tipostring |
Campovideo.url | Tipoowned signed content URL |
Campovideo.duration | Tiponumber |
Campovideo.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 aún no está disponible | Siguiente pasoConsulta periódicamente el ID original devuelto y respeta Retry-After. |
Respuestaserver_error | CondiciónLa respuesta devuelta indica que la operación o el resultado requiere una comprobación | Siguiente pasoConserva el ID original de operación o tarea devuelto, las cabeceras de la solicitud y la respuesta; continúa con las lecturas 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
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