grok-imagine-video-1.5-preview
Grok Imagine Video 1.5 crea vídeos a partir de texto de entre 1 y 15 segundos, también en 1080p. El propio modelo admite animación de imágenes, referencias visuales, definición de fotogramas clave y pista de audio.
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.
Creación de una escena de vídeo
Grok Imagine Video 1.5 es un modelo de xAI para generar vídeos a partir de descripciones de texto y material visual. El método actual publicado de Ailoot ofrece generación a partir de texto; los modos adicionales del propio modelo permiten animar una imagen, utilizar referencias y definir fotogramas de referencia para la escena.
El resultado se crea de forma asíncrona: una vez enviada la tarea, se comprueba si está lista mediante su identificador. Según xAI, el proceso puede tardar varios minutos, dependiendo de la complejidad de la escena, la duración y la resolución. Recibir un identificador de tarea no significa que el vídeo ya esté terminado.
Duración, proporciones y resolución
El vídeo generado dura entre 1 y 15 segundos. Se puede elegir 1:1, 16:9, 9:16, 4:3, 3:4, 3:2 o 2:3; para texto, el formato predeterminado es 16:9. Al animar una imagen, se conservan sus proporciones de forma predeterminada.
La generación a partir de texto y de una imagen inicial admite 480p, 720p y 1080p. 480p se utiliza de forma predeterminada; el modo con referencias está limitado a 720p. No se puede trasladar la resolución 1080p a todos los modos por el mero hecho de que el modelo disponga de ella.
Control del aspecto
En el modo de referencias, xAI acepta hasta 7 imágenes. Estas definen personas, objetos, ropa y otros rasgos visuales sin fijar el primer fotograma. Este modo está pensado para escenas con un personaje recurrente, demostraciones de productos y conservación del aspecto deseado entre escenas.
Primer y último fotograma y fotogramas intermedios
La versión 1.5 permite fijar un primer fotograma exacto, un último fotograma exacto o ambos a la vez. Si solo se define el último, el modelo crea el inicio por sí mismo y llega a la imagen indicada. Si se definen los dos extremos, crea el movimiento entre ellos; las instrucciones de texto pueden precisar el movimiento y el trabajo de cámara.
Para definir la secuencia dentro del vídeo se pueden fijar hasta 4 fotogramas clave. El tiempo de cada uno debe ser estrictamente posterior al inicio y anterior al final; se ajusta a una cuadrícula de 1/3 de segundo. Se rechazan dos fotogramas que, al redondearse, coincidan en la misma marca de la cuadrícula. Para evitarlo, deja al menos 1/3 de segundo entre ellos. El primer y el último fotograma se definen por separado de estos cuatro intermedios.
Los fotogramas fijados pueden combinarse con referencias visuales y voces predefinidas. Si se fija al menos un fotograma, la descripción de texto es opcional: la propia secuencia de imágenes define la escena. Los fotogramas clave no se pueden utilizar junto con el modo de edición de vídeo. Estas capacidades de xAI no implican que estén disponibles en la generación publicada de Ailoot a partir de texto.
Sonido y voces
El vídeo generado contiene una pista de audio de forma predeterminada; también se contempla un resultado sin sonido. En el modo de xAI con referencias de voz, se pueden elegir hasta 3 voces predefinidas y asociarlas a los participantes de la escena que hablan.
Enviar un archivo de audio propio como muestra de voz no es una capacidad general de este modelo: xAI la proporciona por separado previa solicitud. Una voz predefinida y un audio subido son tipos de entrada distintos.
Modos de trabajo
La generación a partir de texto crea una escena nueva; una imagen inicial define su comienzo; las referencias orientan el aspecto; y los fotogramas fijados establecen puntos visuales en el tiempo. Cada modo tiene sus propias restricciones, por lo que los ajustes de uno no se pueden trasladar incondicionalmente a otro.
Ailoot · Vídeo POST /v1/videos/generations grok-imagine-video-1.5-preview
grok-imagine-video-1.5-preview
grok-imagine-video-1.5-previewPrimeros pasos
Grok Imagine Video 1.5 crea vídeos a partir de texto de entre 1 y 15 segundos, también en 1080p. El propio modelo admite animación de imágenes, referencias visuales, definición de fotogramas clave y pista de audio.
- 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-1.5-preview | 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, 1080p | 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,01 US$ por imagen de entrada
- Salida
- 0,25 US$ por segundo a 1080p
- Salida
- 0,08 US$ por segundo a 480p
- Salida
- 0,14 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-1.5-preview", "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-1.5-preview
Alias de rutas de métodos
Usa las rutas de método indicadas arriba.
ID de modelo relacionados
FAQ · grok-imagine-video-1.5-preview
- ¿Qué entradas y resultados están disponibles?
POST /v1/videos/generations·grok-imagine-video-1.5-preview:text→video- ¿Qué campos utiliza la solicitud?
POST /v1/videos/generations·grok-imagine-video-1.5-preview:model,prompt,duration,seconds,resolution,aspect_ratio,size,image- ¿Qué límites se aplican?
POST /v1/videos/generations·grok-imagine-video-1.5-preview:duration.minimum:1;duration.maximum:15;seconds.minimum:1;seconds.maximum:15