xAI
Grok Imagine 1.5 Lite
grok-imagine-1.5-lite/text-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
Probar grok-imagine-1.5-lite/text-to-video
Entrada
Creaciones
Ver todas las creacionesSalida
videoPrecios
grok-imagine-1.5-lite/text-to-video per second
| Especificaciones | Precio unitario |
|---|---|
| 480P | $0.029 |
| 720P | $0.043 |
| 1080P | $0.200 |
Descripción general
grok-imagine-1.5-lite/text-to-video es un modelo ligero de texto a vídeo orientado a la producción de contenido corto: genera directamente a partir de una indicación de texto fragmentos de vídeo de 1 a 15 segundos en 480p a 1080p, y admite varias relaciones de aspecto como 16:9, 1:1 y 9:16. Se centra en la velocidad de generación y la disponibilidad por lotes, por lo que resulta adecuado para desarrolladores que necesitan producir con alta frecuencia vídeos cortos para redes sociales, material en bucle y borradores de guiones gráficos creativos; puede invocarse a través de la interfaz unificada de HiAPI.ai.
Puntos clave
- De la indicación al vídeo final en un solo paso: basta con enviar una descripción de escena y movimiento de hasta 4096 caracteres para obtener el vídeo, sin necesidad de preparar imágenes de referencia.
- Relación de aspecto y duración ajustables: admite 7 relaciones de aspecto y duraciones de 1 a 15 segundos, lo que permite ajustar directamente el formato horizontal, cuadrado o vertical según el canal de publicación.
- Facturación por segundos de salida: el criterio de facturación está vinculado a la duración del vídeo, lo que hace controlable el coste tanto en la generación de vídeos cortos como en las pruebas por lotes.
Descripción de capacidades
Generación de vídeo guiada por texto: genera vídeos describiendo la escena y el movimiento en lenguaje natural; la indicación puede tener hasta 4096 caracteres, lo que facilita incluir instrucciones de guion gráfico bastante completas.
Salida en varias resoluciones: se puede elegir entre 480p, 720p y 1080p, de modo que un mismo modelo sirve desde la vista previa de borradores hasta la entrega del vídeo final.
Control flexible de la duración: la duración puede fijarse entre 1 y 15 segundos, con 6 segundos por defecto, y se adapta tanto al ritmo de vídeos cortos como al de material en bucle.
Adaptación a varias relaciones de aspecto: incluye siete proporciones (16:9, 4:3, 3:2, 1:1, 2:3, 3:4 y 9:16), con 16:9 por defecto, que se corresponden directamente con distintos espacios de visualización.
Casos de uso
- Creadores de contenido social que generan vídeos verticales cortos: introducen una descripción de la escena y eligen la relación 9:16 para producir material de vídeo corto que puede publicarse directamente en el feed.
- Equipos de diseño que elaboran borradores de guiones gráficos creativos: describen con texto el plano y el movimiento para generar vídeos de baja resolución destinados a la validación de conceptos y la discusión de propuestas.
- Profesionales de marketing que producen material por lotes: generan vídeos cortos por lotes con distintas indicaciones y relaciones de aspecto para probar y seleccionar rápidamente creatividades publicitarias.
Limitaciones y recomendaciones de selección
Como modelo de la gama Lite, su calidad de imagen y fidelidad de detalle son inferiores a las de la versión completa, y la salida en 1080p se obtiene ampliando una renderización en 720p, por lo que la nitidez real es limitada. La duración máxima por generación es de 15 segundos y no admite control de múltiples personajes de referencia ni de escenas, por lo que no es adecuado para narrativas de vídeo largo ni para proyectos que requieran una consistencia precisa de los personajes; cuando se exija alta calidad de imagen, conviene utilizar la versión completa u otros modelos de vídeo de mayores prestaciones.
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
https://api.hiapi.ai/v1/tasks Encabezados
AuthorizationstringObligatorioClave API de la cuenta. Obligatoria en cada solicitud. Ejemplo: Bearer YOUR_HIAPI_API_KEY. Obtener clave API
Content-TypestringOpcionalEl 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-KeystringOpcionalClave 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.
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
modelstringObligatorioValor fijo actual: grok-imagine-1.5-lite/text-to-video
routestringOpcionalValor fijo actual: default
inputobjectObligatorio
Objeto de parámetros de negocio para grok-imagine-1.5-lite/text-to-video y la ruta default; consulta la tabla de parámetros a continuación.
promptstringObligatoriominLength 1maxLength 4096Describe la escena de la imagen y el efecto dinámico deseado; es la entrada principal para la generación de video a partir de texto y admite hasta 4096 caracteres.
durationintegerOpcionalPredeterminado: 6min 1max 15Duración del video de salida en segundos; el rango de valores es de 1 a 15 y el valor predeterminado es 6 segundos.
resolutionstringOpcionalPredeterminado: "720p"Resolución del video de salida; controla la nitidez de la imagen generada y el valor predeterminado es 720p.
480p720p1080paspect_ratiostringOpcionalPredeterminado: "16:9"Relación de aspecto del video de salida; controla la proporción de la imagen generada y el valor predeterminado es 16:9.
16:94:33:21:12:33:49:16callbackobjectOpcional
Configuración de notificación de estado terminal. Si se omite, no hay callback: consulta la tarea por tu cuenta.
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.
urlstringObligatorioObligatorio 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.
finalstoragestringOpcionalPredeterminado: "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.
temppersistentEjemplos 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/text-to-video",
"input": {
"prompt": "…",
"duration": 6,
"resolution": "720p",
"aspect_ratio": "16:9"
}
}' 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/text-to-video",
input: {
"prompt": "…",
"duration": 6,
"resolution": "720p",
"aspect_ratio": "16:9"
}
}),
});
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/text-to-video",
"input": {
"prompt": "…",
"duration": 6,
"resolution": "720p",
"aspect_ratio": "16:9"
}
},
)
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
https://api.hiapi.ai/v1/tasks/:id Campos de respuesta
taskIdstringObligatorioID de tarea, siempre con prefijo tk-hiapi-.
modelstringObligatorioNombre 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.
routestringOpcionalSolo aparece si se usó el parámetro route explícito; repite el valor enviado.
statusstringObligatorioEstado de la tarea.
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.
creatednumberObligatorioHora de creación de la tarea (segundos Unix).
completednumberObligatorioSegundos 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
urlstringObligatorioURL del artefacto, descargable directamente.
typestringObligatorioValores posibles actuales: video, image, audio, first_frame, last_frame, thumbnail; podrían ampliarse más adelante.
expireAtnumberObligatorioSegundos Unix hasta los que el artefacto es accesible; descárgalo o transfiérelo antes.
errorobjectOpcional
Solo con status == fail.
codestringObligatorioCódigo de error de negocio.
messagestringObligatorioDescripció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"
}
}
} Artículos
Ver todos los artículos →-
Comparativa
hailuo-2.3-fast/image-to-video comparativa horizontal: cómo elegir un modelo de imagen a video y puntos clave para migrar
-
Tutorial
Uso de Kandinsky 6.0 Pro texto a video en HiAPI: tutorial con curl y Python
Demostración práctica centrada en la solicitud: construir la llamada de prompt a clip de video, enviar la solicitud, sondear el estado de finalización y descargar el resultado
-
Comparativa
Recraft v4.1 Flash comparativa horizontal de texto a imagen: guía de selección y migración para desarrolladores
Con un coste de $0.01 por imagen y capacidad pura de texto a imagen, evalúa si encaja en tu pipeline de generación de imágenes
-
Tutorial
Tutorial de kandinsky-6.0-pro/image-to-video en HiAPI: curl + Python
Realiza una solicitud de imagen a video funcional en HiAPI: desde la carga del primer fotograma hasta el sondeo asíncrono y la descarga final
-
Tutorial
Cómo usar kling-4.0/text-to-video a través de la API de HiAPI: curl, Python y un ejemplo de solicitud ejecutable
Guía práctica para desarrolladores: prompts cinematográficos, audio sincronizado, sondeo asíncrono y descarga de resultados
-
Tutorial
Cómo llamar a kling-4.0/image-to-video en HiAPI: curl, Python y sondeo
-
Tutorial
Cómo llamar a hailuo-2.3/text-to-video mediante la API de HiAPI: curl, Python y ejemplos de solicitud ejecutables
-
Tutorial
Cómo llamar a hailuo-2.3-fast/image-to-video a través de la API de HiAPI: práctica con curl y Python
La primera solicitud ejecutable del nivel rápido y de bajo coste de imagen a vídeo: del ID del modelo a la descarga del MP4
Modelos relacionados
Ver todos los modelos →Mismo tipo
-
HeyGen Avatar V HeyGen $0.150 /segundo -
Seedance 2.0 ByteDance $0.017 /segundo -
PixVerse V6 PixVerse $0.036 /segundo -
Gemini Omni Google -- -
Kandinsky 6.0 Pro $1.93 /vídeo -
HeyGen Avatar IV HeyGen $0.150 /segundo -
Kling 4.0 Kuaishou $0.330 /segundo -
Creatify Boreal Creatify $0.015 /segundo -
Gemini Omni 1.1 Flash Google $0.450 /vídeo -
Kling 3.0 Kuaishou $0.100 /segundo -
Vidu Q4 Preview Vidu $0.051 /segundo -
Veo 3.1 Fast Google $0.170 /segundo