xAI

Grok Imagine 1.5

grok-imagine-1.5/image-to-video

Modelo de generación de vídeo de xAI; la conversión de imagen a vídeo puede animar imágenes estáticas y generar audio sincronizado, con soporte para clips de 480p a 1080p y una duración máxima de 15 segundos

grok-imagine-1.5/image-to-video

Probar grok-imagine-1.5/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/image-to-video per second

Especificaciones	Precio unitario
480P	$0.0114
720P	$0.0214
1080P	$0.05714

Descripción general

grok-imagine-1.5/image-to-video es un modelo de imagen a vídeo lanzado por xAI, invocable a través de la interfaz unificada de HiAPI.ai. Convierte una o varias imágenes de referencia en un cortometraje de 1 a 15 segundos, puede generar en tres niveles de resolución (480p, 720p y 1080p) y permite describir el movimiento deseado mediante un prompt opcional. Cuando se introducen varias imágenes, también se puede controlar la composición de la imagen con el parámetro de relación de aspecto. Es adecuado para desarrolladores y equipos creativos que necesitan animar rápidamente imágenes de producto, fotogramas conceptuales o material de marca, tanto para previsualizar como para entregar contenido de formato corto.

Puntos clave

Composición de tomas dinámicas con múltiples imágenes de referencia: se pueden subir hasta 7 imágenes de referencia y, con varias imágenes, especificar de forma unificada el formato de salida mediante aspect_ratio.
Combinación flexible de duración y nitidez: la longitud del clip es ajustable de forma continua entre 1 y 15 segundos, y la resolución abarca 480p, 720p y 1080p, lo que permite equilibrar calidad y coste según el uso.
Control preciso del movimiento mediante prompts: admite prompts opcionales de hasta 4096 caracteres para describir el movimiento deseado de la cámara y del sujeto.

Capacidades

Generación de vídeo a partir de imágenes: basta con introducir de 1 a 7 imágenes JPEG, PNG o WebP junto con un prompt opcional para generar un clip dinámico, sin necesidad de volver a rodar el material estático.

Salida en varios niveles de resolución: se puede elegir entre 480p, 720p y 1080p; en la fase de borrador se usa una resolución baja para probar rápidamente y, en la fase de entrega, se cambia a 1080p.

Control flexible de la duración: la duración se especifica en segundos enteros, en un rango de 1 a 15 segundos; el coste aumenta con la duración de salida, lo que facilita ajustar la longitud del clip al ritmo del contenido.

Control de la relación de aspecto con varias imágenes: ofrece seis opciones de formato (auto, 1:1, 16:9, 9:16, 3:2 y 2:3), útiles para unificar la composición cuando se usan varias imágenes de referencia; con una sola imagen, la proporción se ajusta a la imagen original.

Casos de uso

Dinamización de imágenes de producto estáticas para equipos de e-commerce y producto: introducir la imagen principal del producto y una breve descripción de movimiento para producir un clip de presentación de unos segundos, destinado a páginas de detalle, materiales publicitarios o contenido de recomendación en redes sociales.
Pruebas de concepto y borradores publicitarios para equipos de marketing: generar rápidamente varias versiones de vista previa dinámica con distintas duraciones y formatos a partir de imágenes conceptuales de marca, para someterlas a revisión interna antes de pasar a la producción final.
Producción de vídeos verticales cortos para redes sociales: generar clips a partir de una única imagen creativa junto con un prompt de movimiento, para la actualización diaria de contenido en feeds y plataformas de vídeo corto.
Previsualización de storyboards para profesionales creativos: convertir ilustraciones de fotogramas clave o borradores de diseño en clips breves, que sirven como referencia dinámica intuitiva para la comunicación con clientes y la previsualización previa al rodaje.

Limitaciones y recomendaciones de selección

Solo admite imagen a vídeo: es obligatorio proporcionar al menos una imagen de referencia y no se puede generar directamente a partir de texto puro. La salida es en formato de clip corto, con una duración máxima de 15 segundos, por lo que no es adecuado para narrativas de vídeo largas. 1080p solo acepta una única imagen de entrada; si se necesita componer varias imágenes, solo se puede usar 480p o 720p. Con una sola imagen, aspect_ratio no tiene efecto y el formato lo determina la imagen original. Para proyectos que requieran planos largos, sincronización labial precisa o narrativas complejas, se recomienda evaluar primero si se pueden cubrir mediante la concatenación de varios segmentos antes de decidir la elección.

Novedades

Ver el registro de cambios →

Nuevo modelo Nuevos modelos: grok-imagine-1.5-lite/text-to-video y grok-imagine-1.5-l… Oct 16, 2026

Preguntas frecuentes

Ver todas las preguntas →

¿Grok Imagine 1.5 Image to Video requiere subir una imagen?

Sí. Actualmente grok-imagine-1.5/image-to-video es una ruta de imagen a video: la imagen de entrada define el sujeto y la composición inicial, y el Prompt define el movimiento, la cámara y los cambios del entorno.
¿Qué duraciones y resoluciones admite Grok Imagine 1.5 Image to Video?

El contrato de solicitud actual de HiAPI admite 1–15s, con resoluciones de salida de 480p y 720p. Los valores disponibles están sujetos al panel de parámetros de la página y a la documentación de la API.
¿Cómo se factura Grok Imagine 1.5 Image to Video?

Las tareas se facturan según la duración de salida y el nivel seleccionado. La página muestra el precio en tiempo real siguiendo la unidad monetaria global, y el cargo final se basa en el registro de la tarea exitosa.
¿Cómo mejorar la estabilidad del sujeto en la generación de video a partir de imágenes?

Utiliza una imagen de entrada con el sujeto claro, pocas oclusiones y una composición completa; en el Prompt, describe primero la acción principal y el movimiento de cámara, y luego enumera la apariencia, los materiales y la relación con el fondo que deben conservarse. Para la primera prueba, se recomienda usar una duración más corta.

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/image-to-video

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

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

promptstringOpcionalmaxLength 4096

Texto de indicación opcional que describe el movimiento de imagen deseado; longitud máxima de 4096 caracteres, con mejores resultados en inglés.

durationintegerOpcionalPredeterminado: 8min 1max 15

Duración del vídeo generado en segundos; valor entero de 1 a 15, por defecto 8 segundos; el coste aumenta con la duración.

image_urlsarrayObligatoriominItems 1maxItems 7

Arreglo de imágenes de referencia; admite de 1 a 7 imágenes, cada una en formato JPEG, PNG o WebP, con un máximo de 20 MB por imagen; no se admite SVG; cuando resolution es 1080p solo se permite 1 imagen.

Array [ string ]

resolutionstringOpcionalPredeterminado: "480p"

Resolución del vídeo de salida; por defecto 480p; 720p tiene un coste mayor por segundo, y 1080p es la opción más costosa y solo admite una única imagen de entrada.

Opciones:480p720p1080p

aspect_ratiostringOpcionalPredeterminado: "auto"

Relación de aspecto del vídeo de salida; por defecto auto; este parámetro no surte efecto cuando solo se proporciona una imagen de entrada, ya que la salida adopta la relación de aspecto de la imagen de entrada; solo se aplica cuando se proporcionan varias imágenes de referencia.

Opciones:auto1:116:99:163:22:3

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/image-to-video",
  "input": {
    "duration": 8,
    "image_urls": "…",
    "resolution": "480p",
    "aspect_ratio": "auto"
  }
}'

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/image-to-video",
    input: {
      "duration": 8,
      "image_urls": "…",
      "resolution": "480p",
      "aspect_ratio": "auto"
    }
  }),
});
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/image-to-video",
        "input": {
          "duration": 8,
          "image_urls": "…",
          "resolution": "480p",
          "aspect_ratio": "auto"
        }
    },
)
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"
    }
  }
}