xAI

Grok Imagine 1.5 Lite

grok-imagine-1.5-lite/image-to-video

Nivel de generación de vídeo ligero y de bajo coste, compatible con texto a vídeo e imagen a vídeo, con generación conjunta de efectos de sonido y diálogos, ideal para la producción masiva y frecuente de clips cortos

grok-imagine-1.5-lite/image-to-video grok-imagine-1.5-lite/text-to-video

Probar grok-imagine-1.5-lite/image-to-video

Entrada

Creaciones

Ver todas las creaciones

Salida

video

Rellena los parámetros y genera: los resultados aparecerán aquí.

Precios

grok-imagine-1.5-lite/image-to-video per second

Especificaciones	Precio unitario
480P	$0.029
720P	$0.043
1080P	$0.200

Descripción general

grok-imagine-1.5-lite/image-to-video es un modelo de generación de videos cortos que parte de una imagen estática y se invoca a través de la interfaz unificada de HiAPI.ai. A partir de un prompt, añade movimiento y cambios a una sola imagen y produce videos de 1 a 15 segundos en 480p a 720p/1080p, manteniendo la relación de aspecto de la imagen original. Es adecuado para la producción de contenido social que requiere iteración frecuente de materiales, para cortos en bucle y para la validación de conceptos creativos, así como para usarse como solución de borrador de primera ronda de bajo costo en flujos de producción por lotes.

Características principales

Impulsado por una sola imagen y con duración ajustable con precisión: solo se necesita una imagen accesible públicamente y una descripción de movimiento; la duración se puede configurar segundo a segundo entre 1 y 15 segundos, lo que facilita alinear el ritmo de los feeds y los espacios publicitarios.
La salida hereda automáticamente la proporción de la imagen de entrada: la relación de aspecto del video final sigue a la imagen de entrada, lo que evita recortes adicionales y se adapta directamente a ubicaciones verticales u horizontales.
Tres opciones de resolución: salidas en 480p, 720p y 1080p, lo que permite asignar especificaciones según el uso, ya sea para vista previa de borradores o para entrega final.
Perfil ligero, ideal para pruebas masivas: la familia ofrece una versión Lite más ligera, que facilita asumir la generación de primera ronda y el filtrado rápido en la producción de materiales por lotes.

Descripción de capacidades

Imagen a video: toma una sola imagen como fotograma inicial y genera un video corto según el movimiento o los cambios descritos en el prompt; el prompt admite hasta 4096 caracteres, suficiente para detallar el movimiento de cámara y las acciones del sujeto.

Control de duración y resolución: la duración se configura en segundos enteros de 1 a 15 segundos, con 6 segundos por defecto; la resolución puede ser 480p, 720p o 1080p, con 720p por defecto, lo que facilita alternar entre vista previa y entrega.

Herencia de la relación de aspecto: la salida mantiene la relación de aspecto de la imagen de entrada, por lo que los desarrolladores no necesitan preparar varios conjuntos de parámetros de recorte para distintas ubicaciones.

Invocación mediante interfaz unificada: basta con enviar el prompt y la URL de la imagen a través de la interfaz unificada de HiAPI.ai para obtener el video resultante; la facturación se calcula según los segundos de salida.

Casos de uso

Equipos de operación en redes sociales convierten imágenes de producto en clips dinámicos: introducen una imagen fija del producto y una breve descripción de movimiento para obtener un clip vertical de 6 a 15 segundos, destinado a la distribución de materiales en feeds y plataformas de video corto.
Equipos de diseño validan conceptos creativos: usan la opción de baja resolución para animar rápidamente fotogramas fijos del guion gráfico, generar borradores para revisión y, tras confirmar la dirección, volver a generar con mayor resolución.
Equipos de contenido producen cortos en bucle: generan fragmentos breves a partir de una sola imagen de ambiente para usarlos como fondo web, reproducción en bucle en stands o material repetido en feeds.

Limitaciones y recomendaciones de selección

Como versión ligera, el detalle visual y la fidelidad son inferiores a los de la versión completa Grok Imagine 1.5, por lo que no conviene usarla como entrega final cuando se requiere mayor calidad de imagen. Solo acepta una imagen de entrada por vez y la duración máxima es de 15 segundos, por lo que no es adecuada para videos largos o narrativas continuas; si se necesita controlar la consistencia de múltiples personajes y escenas de referencia, debe usarse un modelo con capacidades de control más completas. Antes de generar, asegúrese de que la imagen de entrada sea una URL pública de acceso directo.

Preguntas frecuentes

Ver todas las preguntas →

¿Todos los videos tienen sonido?

Sí. El sonido se genera junto con la imagen y no se puede desactivar. Puedes describir en el prompt los sonidos ambientales, la música o los diálogos que desees.
¿Qué duraciones, resoluciones y relaciones de aspecto se admiten?

Duración: entero de 1 a 15 segundos (predeterminado: 6 segundos); resolución: 480p, 720p, 1080p (predeterminado: 720p); relación de aspecto: 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16 (predeterminado: 16:9).
¿Cuál es la longitud máxima del prompt?

Máximo 4096 caracteres. Una descripción centrada en el sujeto, la acción, la cámara y el sonido suele dar mejores resultados que una larga cadena de palabras clave.
¿Se puede usar este modelo para animar mis imágenes?

No, esta ruta solo acepta texto. Si necesitas partir de tus imágenes, utiliza grok-imagine-1.5-lite/image-to-video.

Crear una tarea de generación

POST https://api.hiapi.ai/v1/tasks

Encabezados

AuthorizationstringObligatorio

Clave API de la cuenta. Obligatoria en cada solicitud. Ejemplo: Bearer YOUR_HIAPI_API_KEY. Obtener clave API

Content-TypestringOpcional

El cuerpo de la solicitud siempre se analiza como JSON; si se envía, solo se acepta application/json (charset opcional) — cualquier otro valor devuelve 415. Ejemplo: application/json.

Idempotency-KeystringOpcional

Clave de idempotencia, hasta 255 bytes. Los reintentos con la misma clave de la misma cuenta crean la tarea una sola vez; las repeticiones devuelven el taskId original.

Clave de idempotencia

Ante timeouts de red o reintentos automáticos del cliente, la misma clave crea la tarea una sola vez, sin doble cobro (alcance = la cuenta de la clave API). Usa un identificador de negocio único (p. ej. "order-42"); las repeticiones devuelven el taskId original y las claves caducan 24 h después de la primera solicitud. La matriz completa de escenarios está en la introducción de la API asíncrona unificada.

Cuerpo

modelstringObligatorio

Valor fijo actual: grok-imagine-1.5-lite/image-to-video

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

Objeto de parámetros de negocio para grok-imagine-1.5-lite/image-to-video y la ruta default; consulta la tabla de parámetros a continuación.

promptstringObligatoriominLength 1maxLength 4096

Describe el movimiento o los cambios de imagen deseados, es decir, el prompt de texto para la generación de video a partir de una imagen; longitud máxima de 4096 caracteres.

durationintegerOpcionalPredeterminado: 6min 1max 15

Duración del video generado, en segundos; rango de valores de 1 a 15; valor predeterminado de 6 segundos.

image_urlstringObligatoriominLength 1pattern ^https?://

URL de acceso público de la imagen de entrada que se va a animar; solo se admite una imagen. El video de salida conservará la relación de aspecto de dicha imagen.

resolutionstringOpcionalPredeterminado: "720p"

Resolución del video de salida; valor predeterminado de 720p.

Opciones:480p720p1080p

callbackobjectOpcional

Configuración de notificación de estado terminal. Si se omite, no hay callback: consulta la tarea por tu cuenta.

Callbacks (Webhook)

Indica callback.url al crear y HiAPI hará POST a tu servicio en el estado terminal, sin necesidad de sondeo. El cuerpo del callback replica la estructura del detalle de la tarea; firma, reintentos e idempotencia se detallan en la introducción de la API asíncrona unificada.

urlstringObligatorio

Obligatorio si se incluye callback. Al estado terminal se envía un POST a esta URL; debe ser una URL http(s) válida.

whenstringOpcionalPredeterminado: "final"

Actualmente solo se admite final: notifica tanto en success como en fail.

Opciones:final

storagestringOpcionalPredeterminado: "temp"

Nivel de almacenamiento de artefactos: temp (por defecto, ~7 días) o persistent (largo plazo, facturado por tamaño). Saldo insuficiente o exceso de límite ⇒ degradación silenciosa a temp; el nivel efectivo se muestra en la respuesta del detalle.

Opciones:temppersistent

Ejemplos de solicitud

# Envía una tarea asíncrona; devuelve un taskId de inmediato (sin esperar la generación)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "grok-imagine-1.5-lite/image-to-video",
  "input": {
    "prompt": "…",
    "duration": 6,
    "image_url": "…",
    "resolution": "720p"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "grok-imagine-1.5-lite/image-to-video",
    input: {
      "prompt": "…",
      "duration": 6,
      "image_url": "…",
      "resolution": "720p"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "grok-imagine-1.5-lite/image-to-video",
        "input": {
          "prompt": "…",
          "duration": 6,
          "image_url": "…",
          "resolution": "720p"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Obtener el detalle de la tarea

GET https://api.hiapi.ai/v1/tasks/:id

Campos de respuesta

taskIdstringObligatorio

ID de tarea, siempre con prefijo tk-hiapi-.

modelstringObligatorio

Nombre completo resuelto del modelo. Las tareas enviadas con el parámetro route devuelven base@route (p. ej. gpt-image-2/text-to-image@ext); si no, coincide con el nombre enviado.

routestringOpcional

Solo aparece si se usó el parámetro route explícito; repite el valor enviado.

statusstringObligatorio

Estado de la tarea.

Valores de estado

queued En cola, sin iniciar. handling Procesando. archiving Proceso terminado, preparando artefactos. success Terminal: completado, artefactos disponibles (se devuelve output). fail Terminal: error (se devuelve error). Tras el envío, guíate por status: success y fail son terminales; el resto, no. Sondea cada 1–3 s hasta el estado terminal. Con éxito, descarga los artefactos desde output[].url y transfiérelos antes de expireAt; para retención larga usa storage: "persistent" al crear.

creatednumberObligatorio

Hora de creación de la tarea (segundos Unix).

completednumberObligatorio

Segundos Unix al alcanzar estado terminal; 0 mientras no sea terminal.

outputarrayOpcional

Solo con status == success. Lista de artefactos — siempre un array; una tarea puede devolver varios types a la vez (p. ej. video + first_frame).

Array [ object ]

Elementos del array

urlstringObligatorio

URL del artefacto, descargable directamente.

typestringObligatorio

Valores posibles actuales: video, image, audio, first_frame, last_frame, thumbnail; podrían ampliarse más adelante.

expireAtnumberObligatorio

Segundos Unix hasta los que el artefacto es accesible; descárgalo o transfiérelo antes.

errorobjectOpcional

Solo con status == fail.

codestringObligatorio

Código de error de negocio.

messagestringObligatorio

Descripción del error.

Ejemplos de respuesta

Éxito

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

En proceso (no terminal)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Fallido

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}