Saltar al contenido principal

grok-imagine-video-1.5 — Guía de integración

Usa el ID exacto de esta página en model. Solo las interfaces de la tabla forman parte de la integración documentada para este modelo.

model: grok-imagine-video-1.5

Modelos e interfaces​

Interfaces compatiblesHTTP
videos.generationsPOST /v1/videos/generations

Preparación y autenticación​

Los ejemplos leen ZAI_API_KEY del entorno. Python usa solo la biblioteca estándar, sin SDK. Guarda la clave en el servidor, nunca en código del navegador. Las solicitudes pueden generar cargos; los ejemplos producen resultados pequeños.

export ZAI_API_KEY="<your-api-key>"

Parámetros y límites​

Estas configuraciones son solicitudes mínimas para esta plataforma, no una lista exhaustiva ni límites máximos. Los parámetros avanzados omitidos no se han verificado aquí. No copies los límites de otro proveedor o modelo.

Configuración verificada: duration=6 segundos, resolution=480p, aspect_ratio=16:9 y prompt de texto. duration es entero. Los fotogramas inicial/final, reference_images, reference_audios, generate_audio, seed y watermark no están verificados aquí. No deduzcas compatibilidad de otros modelos. Ambos modelos de vídeo Grok siguen este flujo, con ID y precios independientes.

Ejemplo completo​

import json
import os
import urllib.error
import urllib.request

BASE = "https://api.ourzai.com/v1"
KEY = os.environ["ZAI_API_KEY"]


def call(path, body=None, timeout=180):
    headers = {"Authorization": f"Bearer {KEY}"}
    data = None
    if body is not None:
        headers["Content-Type"] = "application/json"
        data = json.dumps(body).encode("utf-8")
    request = urllib.request.Request(BASE + path, data=data, headers=headers)
    try:
        with urllib.request.urlopen(request, timeout=timeout) as response:
            return response.read()
    except urllib.error.HTTPError as error:
        raise RuntimeError(f"HTTP {error.code}: {error.read().decode(errors='replace')}") from error


import time
from pathlib import Path
from urllib.parse import quote

created = json.loads(
    call(
        "/videos/generations",
        {
            "model": "grok-imagine-video-1.5",
            "prompt": "A red mug on a table, slow camera movement",
            "duration": 6,
            "resolution": "480p",
            "aspect_ratio": "16:9",
        },
    )
)
task_id = created.get("request_id") or created.get("id")
if not task_id:
    raise RuntimeError(created)
print("task_id:", task_id, flush=True)
path = "/videos/" + quote(task_id, safe="")
deadline = time.monotonic() + 600
while time.monotonic() < deadline:
    status = json.loads(call(path))
    if status.get("status") == "done":
        Path("result.mp4").write_bytes(call(path + "/content"))
        break
    if status.get("status") in ("failed", "expired"):
        raise RuntimeError(status)
    time.sleep(5)
else:
    raise TimeoutError(f"Keep task ID {task_id} and query its status later")

Resultados y errores​

Enviar correctamente no significa que el vídeo esté listo. El ejemplo acepta request_id/id, consulta pending → done y descarga /content con la misma clave; video.url puede ser relativo. failed/expired son estados finales; 409 significa que aún no está listo. No envíes la clave a otros dominios. Si se agota el tiempo, consulta la tarea existente antes de reenviar para evitar cargos duplicados.

Este catálogo describe la integración, no la disponibilidad en tiempo real. GET /v1/models muestra los modelos accesibles con tu clave; consulta precios en la consola. Un modelo listado puede devolver 502/503 durante fallos o periodos de espera. Reintenta con espera progresiva.