xAI
Grok Imagine
grok-imagine/image-to-video
Modelo de generación creativa de xAI, compatible con edición de imagen a imagen y guía de estilo, con hasta 9 imágenes de referencia para controlar la composición y los personajes; se invoca mediante la interfaz unificada de HiAPI.ai
Probar grok-imagine/image-to-video
Entrada
Creaciones
Ver todas las creacionesSalida
videoPrecios
grok-imagine/image-to-video per second
| Especificaciones | Precio unitario |
|---|---|
| 480P | $0.0114 |
| 720P | $0.0214 |
| 1080P | $0.05714 |
Descripción general
grok-imagine/image-to-video es un modelo de imagen a vídeo de la familia grok-imagine de xAI, que se invoca a través de la interfaz unificada de HiAPI.ai. Recibe una o varias imágenes de referencia junto con un prompt de texto y convierte imágenes estáticas en tomas en movimiento, con duraciones de 6 a 30 segundos, resoluciones de 480p a 1080p y varias relaciones de aspecto. Resulta adecuado para desarrolladores y equipos creativos que necesitan animar rápidamente ilustraciones, guiones gráficos o imágenes de producto, y se usa para material para redes sociales, prototipos publicitarios y previsualización de tomas en movimiento.
Aspectos destacados
- Guiado del movimiento con múltiples imágenes de referencia: se pueden pasar hasta 7 imágenes de referencia y citarlas en el prompt mediante @image1, etc., lo que facilita un control preciso del sujeto y la composición.
- Estilo de movimiento conmutable: ofrece tres modos de generación (fun, normal y spicy), que corresponden a un movimiento más creativo, equilibrado o más dinámico, respectivamente.
- Duración y resolución ajustables según la necesidad: la duración se puede establecer entre 6 y 30 segundos, y la resolución abarca de 480p a 1080p, lo que permite sopesar la velocidad de generación y la calidad del vídeo final.
- Criterio de facturación claro: se factura por segundos de salida, y el parámetro de duración determina directamente el coste de la llamada, lo que facilita estimar el presupuesto antes de generar por lotes.
Descripción de las capacidades
Generación de vídeo guiada por imágenes de referencia: con 1 a 7 imágenes de entrada en JPEG, PNG o WEBP, el modelo genera imágenes en movimiento conservando el sujeto y la composición, lo que resulta adecuado para convertir material estático en tomas.
Control del movimiento mediante prompt de texto: opcionalmente se puede pasar un prompt de hasta 5000 caracteres que describa el movimiento deseado; describirlo en inglés da mejores resultados y ayuda al modelo a centrarse en las acciones y la evolución de la cámara indicadas.
Salida en múltiples relaciones de aspecto: admite cinco relaciones (2:3, 3:2, 1:1, 16:9 y 9:16), que se aplican en el modo de múltiples imágenes de referencia y permiten cubrir de una vez las necesidades de publicación en horizontal y en vertical.
Resolución y duración ajustables: la resolución de salida es de 480p por defecto y se puede elevar a 720p o 1080p; la duración es de 6 segundos por defecto y de hasta 30 segundos, y se factura según los segundos realmente generados.
Casos de uso
- Diseñadores que animan ilustraciones estáticas como tomas en movimiento: usar una ilustración o un fotograma de guion gráfico como entrada con un breve prompt de movimiento para producir tomas de vídeo cortas, destinadas a carteles animados, cabeceras y previsualización de guiones gráficos.
- Equipos de comercio electrónico que generan presentaciones en movimiento de imágenes de producto: subir una imagen de producto y describir el movimiento de cámara para obtener vídeos cortos en vertical o cuadrados, utilizables directamente en páginas de detalle de producto y en publicaciones en el feed de redes sociales.
- Creadores de contenido que producen material para redes sociales por lotes: generar por lotes material en movimiento con relación 9:16 y duraciones cortas para la actualización diaria de contenido y las pruebas creativas en plataformas de vídeo corto.
Limitaciones y recomendaciones de selección
Solo realiza imagen a vídeo; no acepta entrada de texto puro para generar vídeo y requiere al menos una imagen de referencia. Con una sola imagen de entrada, el parámetro de relación de aspecto no tiene efecto y la salida sigue la relación de la imagen original; la resolución 1080p solo admite una única imagen de entrada. Al usar imágenes externas, el modo de generación puede degradarse automáticamente a normal. Si se necesita generar vídeo directamente a partir de texto o se requieren tomas continuas de más de 30 segundos, conviene elegir otro modelo o generar por segmentos. El coste aumenta con la duración, por lo que antes de llamadas por lotes con duraciones largas se recomienda validar primero con una muestra pequeña.
Novedades
Ver el registro de cambios →- Nuevo modelo Nuevos modelos: grok-imagine-image-2.0/text-to-image y grok-imagine-ima…
Preguntas frecuentes
Ver todas las preguntas →-
¿Para qué es adecuado el nivel estándar de Grok Imagine?
Adecuado para la exploración creativa por lotes, material para redes sociales y escenas de paisajes y con sensación cinematográfica. 1k y 2k actualmente tienen el mismo precio, por lo que conviene elegir directamente el nivel de salida superior.
-
¿Cuál es la diferencia entre el nivel estándar y el nivel Quality?
El nivel estándar prioriza la velocidad y un precio fijo bajo; Quality es una línea de modelo independiente que presta más atención a los materiales, los detalles y la iluminación, y se factura por niveles de 1k/2k.
-
¿Qué relaciones de aspecto se admiten?
Se admiten 13 relaciones de aspecto horizontales, cuadradas y verticales, desde 2:1 y 20:9 hasta 1:2.
-
¿Esta página admite imágenes de referencia?
No. Para editar con imágenes de referencia, utiliza grok-imagine/image-to-image.
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/image-to-video
routestringOpcionalValor fijo actual: default
inputobjectObligatorio
Objeto de parámetros de negocio para grok-imagine/image-to-video y la ruta default; consulta la tabla de parámetros a continuación.
modestringOpcionalPredeterminado: "normal"Modo de generación; afecta el estilo y la intensidad del movimiento del video. Valor de tipo cadena, por defecto normal. Al proporcionar imágenes externas (image_urls), el servicio upstream puede degradarlo automáticamente a normal.
funnormalspicypromptstringOpcionalmaxLength 5000Indicación de texto que describe el movimiento deseado del video; opcional, funciona mejor en inglés, máximo 5000 caracteres.
durationintegerOpcionalPredeterminado: 6min 6max 30Duración del video en segundos; valor entero, por defecto 6. El costo se calcula por segundo.
image_urlsarrayObligatoriominItems 1maxItems 7Arreglo de imágenes de referencia; cada elemento es una URL de imagen o un ID de recurso asset://, máximo 7 imágenes; admite JPEG/PNG/WEBP, con un máximo de 10 MB por imagen. Se puede hacer referencia a imágenes concretas en el prompt con @image1, etc.
Array [ string ]
resolutionstringOpcionalPredeterminado: "480p"Resolución del video de salida; valor de tipo cadena, por defecto 480p. 1080p solo admite una única imagen de entrada.
480p720p1080paspect_ratiostringOpcionalPredeterminado: "2:3"Relación de aspecto del video de salida; valor de tipo cadena, por defecto 2:3. Solo se aplica en el modo de referencia con varias imágenes; con una sola imagen de entrada este parámetro no tiene efecto y la salida sigue la proporción de la imagen de entrada.
2:33:21:116:99: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/image-to-video",
"input": {
"mode": "normal",
"duration": 6,
"image_urls": "…",
"resolution": "480p",
"aspect_ratio": "2:3"
}
}' 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/image-to-video",
input: {
"mode": "normal",
"duration": 6,
"image_urls": "…",
"resolution": "480p",
"aspect_ratio": "2:3"
}
}),
});
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/image-to-video",
"input": {
"mode": "normal",
"duration": 6,
"image_urls": "…",
"resolution": "480p",
"aspect_ratio": "2:3"
}
},
)
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 →-
Tutorial
Cómo llamar a hailuo-2.3/text-to-video mediante la API de HiAPI: curl, Python y ejemplos de solicitud ejecutables
-
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 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
-
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
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
-
Tutorial
Cómo llamar a kling-4.0/image-to-video en HiAPI: curl, Python y sondeo
Modelos relacionados
Ver todos los modelos →Mismo tipo
-
MiniMax H3 MiniMax $0.072 /segundo -
Hailuo 2.3 MiniMax $0.270 /vídeo -
Seedance 2.0 ByteDance $0.017 /segundo -
Kandinsky 6.0 Pro $1.93 /vídeo -
Gemini Omni 1.1 Flash Google $0.450 /vídeo -
Grok Imagine 1.5 xAI $0.011 /segundo -
FLUX 3 Max Black Forest Labs $0.061 /segundo -
Kling 3.0 Kuaishou $0.100 /segundo -
Vidu Q4 Preview Vidu $0.051 /segundo -
HappyHorse 1.0 Alibaba $0.168 /segundo -
Wan 2.6 Flash Alibaba $0.043 /segundo -
Kling AI Avatar Kuaishou --


