Video de Grok Imagine

grok-imagine-video-1.5 genera video a partir de texto, con imágenes de referencia opcionales: envíe la tarea, consulte su ID y descargue el clip terminado.

Las imágenes de Grok Imagine usan los endpoints síncronos de OpenAI Images y sus parámetros no sirven en video; consulte Imágenes con Grok Imagine.

Modelos disponibles

grok-imagine-video-1.5 es texto a video con imágenes de referencia opcionales: no admite primer ni último fotograma, ni video ni audio de referencia.

La imagen y el chat los sirve el grupo Grok gama completa; el video lo sirve el grupo Grok Video. Son dos grupos distintos: una clave solo llega al modelo de video si incluye Grok Video, y una misma clave puede incluir ambos grupos. Confírmelo con GET /v1/models usando la clave que realmente vaya a utilizar.

Los precios oficiales de cada nivel de resolución y de las imágenes de referencia están en la ficha del modelo: grok-imagine-video-1.5. Todos los campos de video figuran en la referencia de la API, en Enviar una tarea de video.

Parámetros de la solicitud

• model debe coincidir exactamente.
• content es un arreglo de elementos text con texto no vacío; no acepta elementos de imagen, video ni audio.
• resolution se factura por segundo en su nivel; con reference_images, solo 480p / 720p.
• Los valores predeterminados de duration y aspect_ratio los completa el servicio, y la facturación sigue el duration_seconds final.
• Use aspect_ratio para el encuadre; ratio se rechaza.
• reference_images es un arreglo de nivel superior, solo HTTP(S) público, sin Data URL ni asset://; cada imagen de referencia se factura aparte.

Se rechazan ratio, frames, seed, camera_fixed, draft, draft_task, service_tier, generate_audio, watermark y return_last_frame. Los demás campos no enumerados (como un image de nivel superior) no se comprueban y no actúan como referencias.

Respuesta

El video usa el mismo objeto task que Seedance; no lea un id en el nivel superior como en Kling.

Respuesta del envío

Un envío correcto devuelve 200 con el ID de tarea en task.id (con forma vt…):

{
  "task": {
    "id": "vtEXAMPLE",
    "model": "grok-imagine-video-1.5",
    "status": "pending",
    "outputs": []
  }
}

Campos de la consulta

Consulte GET /v1/video/tasks/{task_id} con task.id.

Solo completed y failed son terminales, así que trate cualquier otro valor como aún en curso.

En curso

{
  "task": {
    "id": "vtEXAMPLE",
    "model": "grok-imagine-video-1.5",
    "status": "processing",
    "outputs": [],
    "error": null
  }
}

Completada

Una tarea completada incluye duration_seconds y las URL del video en outputs:

{
  "task": {
    "id": "vtEXAMPLE",
    "model": "grok-imagine-video-1.5",
    "status": "completed",
    "duration_seconds": 5,
    "outputs": [
      "https://api.hop-base.com/example-signed-video.mp4"
    ],
    "error": null
  },
  "usage": { "cost": 1.02, "cost_usd": 0.15, "currency": "CNY" }
}

Fallida

Los fallos de ejecución también se consultan con HTTP 200; revise task.status y task.error.message:

{
  "task": {
    "id": "vtEXAMPLE",
    "model": "grok-imagine-video-1.5",
    "status": "failed",
    "outputs": [],
    "error": { "message": "<English failure reason>" }
  }
}

Ejemplo mínimo

# 1. Enviar
curl https://api.hop-base.com/v1/video/generate \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video-1.5",
    "prompt": "Un gato naranja corre por la hierba soleada mientras la cámara lo sigue",
    "resolution": "720p",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

# 2. Consultar con el task.id devuelto
curl https://api.hop-base.com/v1/video/tasks/vt-su-id-de-tarea \
  -H "Authorization: Bearer sk-your-key"

Notas

• outputs es válido durante 24 horas desde que termina la tarea; volver a consultar no lo prolonga y una URL caducada devuelve 410. Descargue y guarde los resultados cuanto antes.
• Un prompt moderado hace fallar la tarea con content-moderated en error.message.
• Con reference_images, la resolución solo puede ser 480p / 720p.
• Las imágenes de referencia deben ser URL HTTP(S) públicas, y la cantidad máxima no está verificada.
• El video está en un grupo distinto del de imagen y chat; añada el grupo Grok Video a su clave para llamarlo.

Errores comunes y soluciones

Los errores de envío son 400 solo con error.message (sin code).

Texto completo de los errores:

grok-imagine-video-1.5 requires resolution: 480p / 720p / 1080p
model grok-imagine-video-1.5 does not support resolution 4k
grok-imagine-video-1.5 duration must be an integer in 1-15, got 20
grok-imagine-video-1.5 uses aspect_ratio for the frame ratio and does not support ratio
aspect_ratio must be one of 1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3, got 21:9
grok-imagine-video-1.5 does not support parameter generate_audio
grok-imagine-video-1.5 only supports text segments in content; use reference_images for reference images
reference_images[0] must be a {"url": "..."} object
reference_images[0].url must be a publicly reachable http(s) address
grok-imagine-video-1.5 reference-to-video supports up to 720p; remove the reference images or choose 480p/720p
priority must be within 0-9, got 12
execution_expires_after must be within 3600-259200 seconds
callback_url must be a valid http(s) URL
safety_identifier must be an ASCII string of 1-64 characters

Facturación

Se factura por segundo de metraje terminado, con precio según el nivel de resolution; cada imagen de referencia se factura aparte. Las tareas fallidas no se facturan.

Cuando la tarea termina, el objeto usage de la raíz de la consulta también incluye cost_usd —el importe en USD realmente descontado de su saldo por esta tarea, 0 si falló sin cargo—, cost (el mismo cargo en CNY) y currency (siempre CNY). La comprobación de saldo al enviar (402 si no alcanza) y las demás reglas comunes a todas las tareas de video están en Resumen de video.

Los precios de lista oficiales están en la página de precios. Su tarifa es la que aparece en la Plaza de modelos con la sesión iniciada, y el cargo real de cada solicitud está en la página Consumo de la consola.

Próximos pasos

• Imágenes con Grok Imagine: genere y edite imágenes
• Resumen de video: compare las familias de video y el flujo de tareas común
• Grok: modelos de chat y razonamiento de Grok, incluidos el precio de contexto largo, la facturación de tokens de razonamiento y el cargo por herramientas del servidor
• Códigos de error y reintentos: qué significa cada código de error y si conviene reintentar