ToAPIs
    InicioToAPIs
    Generación de imágenesGPT Image 2.6, Gemini, FLUX…Generación de videoSeedance, Veo, Kling, Sora…Chat y redacciónGPT-5.6, Claude, DeepSeek…Voz y músicaLocuciones, TTS, audio
    NovedadSeedance 2.5
    PreciosDocumentación de APIMCP
    BlogAlternativas
    Iniciar sesiónEmpieza gratis
    Todos los modelosPreciosDocumentación de APIMCPBlogAlternativas
    Iniciar sesiónEmpieza gratis

    Idioma

    Esc
    • Seedance 2.5Generación de video
    • GPT Image 2Generación de imágenes
    • GPT Image 2.6Generación de imágenes
    • GPT Image 2.5Generación de imágenes
    • Veo 3.1 FastGeneración de video
    • Kling 3.0 TurboGeneración de video
    • Kling V4 FlashGeneración de video
    • Grok Video 1.5Generación de video
    • Nano Banana 2Generación de imágenes
    • Seedream 5.5Generación de imágenes
    • FLUXGeneración de imágenes
    • Sora 2Generación de video
    • Todos los modelos de imagenCategoría
    • Todos los modelos de videoCategoría
    • GPT-5.6 SolChat y código
    • Claude Opus 4.8Chat y código
    • Claude Opus 4.7Chat y código
    • DeepSeek V4 ProDeepSeek · Texto
    • Gemini Omni 1.1 FlashGoogle · Multimodal
    1. Inicio
    2. Blog
    3. Tutorial
    4. API de generación de vídeo Grok Imagine 1.0: endpoints, ámbitos de autenticación y gestión de errores
    Volver a todos los artículos
    tutorial2026-11-177 min de lectura

    API de generación de vídeo Grok Imagine 1.0: endpoints, ámbitos de autenticación y gestión de errores

    El contrato actual de Grok Imagine en ToAPIs usa grok-imagine-video-official y grok-imagine-video-1.5-official: autenticación con clave API Bearer, endpoints de generaciones y extend, y la gestión documentada de errores y estados. No existe un ID grok-imagine-1.0 ni una matriz de ámbitos OAuth.

    ToAPIs Engineering & Evaluation Team
    Grok ImagineVideo APIAuthenticationError HandlingTutorial
    TL;DR - Puntos clave
    • No existe ningún ID público de catálogo llamado grok-imagine-1.0. Los ID documentados del canal oficial son grok-imagine-video-official (texto, imagen y multi-referencia, más extend) y grok-imagine-video-1.5-official (solo imagen a vídeo con primer fotograma, hasta 1080p, sin extend).
    • La autenticación documentada es una clave API Bearer en la cabecera Authorization. Este artículo no encontró ninguna matriz pública de ámbitos OAuth (por ejemplo videos:write) para estos endpoints.
    • Crea trabajos con POST /v1/videos/generations y consulta GET /v1/videos/generations/{id}. Extiende clips del canal oficial con POST /v1/videos/{video_id}/extend o POST /v1/videos/extend más video_urls, para 2 a 10 segundos adicionales.
    • Sube imágenes locales con POST /v1/uploads/images y envía solo URL públicas. official permite hasta 7 imágenes entre image y reference_images; 1.5-official exige exactamente una imagen de primer fotograma y no documenta extensión de vídeo.
    • La salida se factura por segundo según el nivel de resolución; las imágenes de entrada se facturan por imagen; extend también factura la duración del vídeo de origen. Confirma las tarifas vigentes de tu cuenta: no reutilices precios unitarios de borradores.

    API de generación de vídeo Grok Imagine 1.0: endpoints, ámbitos de autenticación y gestión de errores

    Modelos objetivo: grok-imagine-video-official, grok-imagine-video-1.5-official
    Endpoint de inferencia: https://api.toapis.com/v1/videos/generations
    Relacionado: Guía práctica de Grok Video · Acceso compatible con OpenAI · Generación oficial de Imagine · Extend oficial de Imagine


    1. Resumen y panorama del rendimiento

    • ID: las solicitudes tituladas en torno a «Grok Imagine 1.0» necesitan las cadenas que ToAPIs publica realmente. La instantánea pública del catálogo fechada 2026-11-10 lista grok-imagine-video-official y grok-imagine-video-1.5-official (esas dos también aparecen bajo generación de imágenes y bajo openai-video). Una comprobación del 2026-11-17 de una ruta de documentación grok-imagine-1.0 devolvió HTTP 404.
    • Autenticación: envía Authorization: Bearer $TOAPIS_API_KEY. Las páginas oficiales no documentan ámbitos OAuth, nombres de permisos granulares ni ningún endpoint de descubrimiento de ámbitos para estas llamadas.
    • Endpoints: crea con POST /v1/videos/generations. Consulta con GET /v1/videos/generations/{id}. Extiende la salida del canal oficial con POST /v1/videos/{video_id}/extend, o con POST /v1/videos/extend más video_urls cuando solo tienes una URL pública del vídeo. Sube imágenes fijas con POST /v1/uploads/images.
    • Capacidades: grok-imagine-video-official cubre texto a vídeo, imagen a vídeo y generación con múltiples referencias en 480p o 720p, duración de 1–15 segundos, y extend de 2–10 segundos. grok-imagine-video-1.5-official es solo imagen a vídeo con primer fotograma, requiere exactamente una image, permite 1080p y no admite extend.
    • Forma del precio (no hay precio unitario fijo en las páginas de referencia): la salida se factura por segundo según la resolución; cada imagen de entrada se factura por imagen; extend también factura la duración del vídeo de origen. Confirma las tarifas vigentes de la cuenta.

    2. Endpoints, autenticación y contratos de modelo

    La documentación oficial usa https://toapis.com (y https://toapis.cn para China continental). Otras guías de esta serie usan https://api.toapis.com. Elige un origen y mantenlo coherente. Todas las rutas de abajo usan la misma cabecera Bearer.

    AcciónMétodo y rutaNotas del modelo
    Subir una imagen fijaPOST /v1/uploads/imagesfile multipart. JPEG, PNG, WebP o GIF, máximo 30 MB. Lee data.url
    Crear un vídeoPOST /v1/videos/generationsAmbos ID oficiales de Imagine
    Consultar estadoGET /v1/videos/generations/{id}Misma ruta para tareas de generación y de extend
    Extender desde una tarea previaPOST /v1/videos/{video_id}/extendSolo grok-imagine-video-official. video_id es el id de la tarea de generación anterior
    Extender desde una URL públicaPOST /v1/videos/extendMismo ID oficial; video_urls es obligatorio cuando no hay id en la ruta
    ID de catálogoTrabajos documentadosDuraciónResoluciónImágenesExtend
    grok-imagine-video-officialTexto a vídeo, primer fotograma y múltiples referencias1–15 segundos (predeterminado 8)480p, 720pimage opcional más reference_images; hasta 7 en total2–10 segundos (duration predeterminada 6)
    grok-imagine-video-1.5-officialSolo imagen a vídeo con primer fotograma1–15 segundos (predeterminado 8)480p, 720p, 1080pimage es obligatoria (exactamente un primer fotograma). Los reference_images adicionales siguen contando para el total de 7 imágenesNo admitido

    Los valores de relación de aspecto de las referencias oficiales de Imagine incluyen 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 y 1:1. Envía un valor que hayas confirmado para ese ID y ese canal.

    No existe ninguna cadena de ámbito pública documentada para solicitar «generar», «extender» o «subir» por separado. El acceso es lo que la clave API, el grupo de usuarios y la configuración del canal ya permiten. Si una llamada falla por permisos o disponibilidad, revisa la lista de modelos de la clave y la referencia de errores en lugar de añadir un parámetro de consulta scope inventado.

    Un nodo de credenciales que atraviesa una pasarela hexagonal hacia tres mosaicos de endpoints

    Figura 1: una única clave API Bearer autoriza la carga, la generación o extend y la consulta de estado; el ID oficial 1.5 no añade una rama de extend.

    Para la familia Grok Video no oficial (grok-video-1.0 / grok-video-1.5), consulta la guía práctica de Grok Video. Esos ID son otro contrato y no heredan esta ruta de extend.


    3. Implementación en producción: cURL y Python

    Paso 1: cURL, texto a vídeo en el canal oficial

    bash
    curl -X POST "https://api.toapis.com/v1/videos/generations" \
      -H "Authorization: Bearer $TOAPIS_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "grok-imagine-video-official",
        "prompt": "A golden retriever running on a green field in sunny weather",
        "duration": 10,
        "resolution": "720p",
        "aspect_ratio": "16:9"
      }'
    

    Un trabajo con primer fotograma en grok-imagine-video-1.5-official usa la misma ruta, exige "image": "https://example.com/portrait.jpg" y puede fijar "resolution": "1080p". Sustituye la URL de ejemplo por una dirección pública; sube el archivo primero si es local:

    bash
    curl -X POST "https://api.toapis.com/v1/uploads/images" \
      -H "Authorization: Bearer $TOAPIS_API_KEY" \
      -F "file=@/path/to/first-frame.jpg"
    

    Paso 2: Python, generar, consultar y extend opcional

    python
    import os
    import time
    import requests
    
    API_KEY = os.environ["TOAPIS_API_KEY"]
    BASE = "https://api.toapis.com"
    HEADERS = {
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json",
    }
    
    
    def dispatch_imagine(
        prompt: str,
        *,
        model: str = "grok-imagine-video-official",
        duration: int = 10,
        resolution: str = "720p",
        aspect_ratio: str = "16:9",
        image_url: str | None = None,
        reference_images: list[str] | None = None,
    ) -> str:
        if model == "grok-imagine-video-1.5-official" and not image_url:
            raise ValueError("grok-imagine-video-1.5-official requires exactly one first-frame image")
        payload = {
            "model": model,
            "prompt": prompt,
            "duration": duration,
            "resolution": resolution,
            "aspect_ratio": aspect_ratio,
        }
        if image_url:
            payload["image"] = image_url
        if reference_images:
            payload["reference_images"] = reference_images
        res = requests.post(
            f"{BASE}/v1/videos/generations",
            headers=HEADERS,
            json=payload,
            timeout=30,
        )
        res.raise_for_status()
        data = res.json()
        task_id = data.get("id") or data.get("task_id")
        if not task_id:
            raise RuntimeError(f"Unexpected submission envelope: {data}")
        return task_id
    
    
    def poll_task(task_id: str, deadline_s: int = 600) -> dict:
        poll_url = f"{BASE}/v1/videos/generations/{task_id}"
        interval = 10.0
        start = time.time()
        time.sleep(5)
        while time.time() - start < deadline_s:
            poll = requests.get(poll_url, headers={"Authorization": f"Bearer {API_KEY}"}, timeout=15)
            if poll.status_code == 429:
                retry_after = poll.headers.get("Retry-After")
                time.sleep(float(retry_after) if retry_after else min(interval * 2, 120))
                continue
            poll.raise_for_status()
            data = poll.json()
            status = data.get("status")
            if status == "completed":
                return data
            if status == "failed":
                raise RuntimeError(f"Generation failed: {data.get('error')}")
            time.sleep(interval)
            interval = min(interval * 1.5, 30.0)
        raise TimeoutError(f"Task {task_id} exceeded {deadline_s}s; check status before retrying")
    
    
    def extend_official(source_task_id: str, prompt: str, duration: int = 6) -> str:
        if not (2 <= duration <= 10):
            raise ValueError("official extend duration is documented as 2-10 seconds")
        res = requests.post(
            f"{BASE}/v1/videos/{source_task_id}/extend",
            headers=HEADERS,
            json={
                "model": "grok-imagine-video-official",
                "prompt": prompt,
                "duration": duration,
            },
            timeout=30,
        )
        res.raise_for_status()
        data = res.json()
        task_id = data.get("id") or data.get("task_id")
        if not task_id:
            raise RuntimeError(f"Unexpected extend envelope: {data}")
        return task_id
    
    
    if __name__ == "__main__":
        task_id = dispatch_imagine(
            "A golden retriever running on a green field in sunny weather",
            duration=10,
            resolution="720p",
        )
        print("Task:", task_id)
        result = poll_task(task_id)
        print("Video:", result["result"]["data"][0]["url"])
    

    Para extender desde un MP4 público en lugar de un id de tarea, usa POST /v1/videos/extend con el mismo modelo oficial, prompt, duration y una lista video_urls. No llames a extend con grok-imagine-video-1.5-official.


    4. Gestión de errores y matriz de estados

    Las categorías de abajo son puntos de partida para el diagnóstico, no una garantía de los códigos de error exactos de ToAPIs. Una consulta HTTP correcta sigue exigiendo leer el status de la tarea. La referencia de errores distingue errores de solicitud, valores de error.reason de tareas fallidas y payloads de webhook.

    Estado HTTP o de tareaCategoría habitualAcción recomendada
    400Campo inválido, image obligatoria ausente en 1.5-official, desbordamiento del recuento de imágenes o extend enviado a un modelo que no lo admiteRevisa el ID oficial exacto, la duración (1–15 al generar, 2–10 al extender), la resolución (1080p solo en 1.5-official) y que todos los valores de medios sean URL públicas
    401Clave de API ausente o inválidaRota la clave y confirma Authorization: Bearer. No añadas un parámetro scope no documentado como solución
    429Límite de frecuencia o de concurrenciaRespeta Retry-After cuando esté presente; retrocede con fluctuación aleatoria
    5xx o tiempo de espera agotado del clienteProblema temporal de la pasarela o del upstreamConsulta el id de tarea existente antes de reenviar
    status: queued o in_progressNo es un errorEspera y consulta de nuevo
    status: failed con content_policy_rejectedRevisión de seguridad o de derechos de autorRevisa el prompt y cada recurso de referencia; una entrada conforme puede aun así producir una salida rechazada
    status: failed con insufficient_user_balance o token_quota_exceededSaldo o cuota de tokensRevisa tanto el saldo como los límites periódicos
    status: failed con generation_timeout, model_unavailable o service_busyTiempo de espera agotado o disponibilidad del upstreamRevisa primero el id existente; después reintenta con retroceso solo si la tarea es final

    WaitTime=min⁡(MaxWait,BaseInterval×2attempt)+Uniform(0,1)\text{WaitTime} = \min(\text{MaxWait}, \text{BaseInterval} \times 2^{\text{attempt}}) + \text{Uniform}(0, 1)WaitTime=min(MaxWait,BaseInterval×2attempt)+Uniform(0,1)


    5. Precios y retorno de FinOps

    Las páginas oficiales de generación y de extend de Imagine describen una forma de facturación, no un precio unitario público fijo:

    Estimated cost=(output seconds×resolution rate)+(input images×per-image rate)+(extend source seconds×per-second rate)\text{Estimated cost} = (\text{output seconds} \times \text{resolution rate}) + (\text{input images} \times \text{per-image rate}) + (\text{extend source seconds} \times \text{per-second rate})Estimated cost=(output seconds×resolution rate)+(input images×per-image rate)+(extend source seconds×per-second rate)

    Usa las tarifas que se devuelven para tu cuenta y SKU, no números de borrador.

    • grok-imagine-video-1.5-official siempre incluye un cargo por imagen de entrada, porque la imagen de primer fotograma es obligatoria.
    • Extend no es una continuación gratuita. La facturación oficial de extend incluye los segundos de extensión generados y la duración del vídeo de origen. Por eso los extend encadenados vuelven a cobrar la longitud creciente de origen: confirma ese comportamiento con una cotización vigente antes de montar un bucle.
    • No reutilices precios unitarios ni cifras de SLA de borradores de planificación. Las filas de referencia oficiales del proveedor en la página de precios de ToAPIs son solo informativas y pueden no coincidir con la facturación de la cuenta.
    • Haz borradores en 720p con una duración intermedia, cambia una variable cada vez y nunca reenvíes tras un tiempo de espera agotado del cliente hasta comprobar el estado de la tarea.

    6. Preguntas frecuentes

    Consulta el bloque de preguntas frecuentes del frontmatter. En resumen: envía grok-imagine-video-official o grok-imagine-video-1.5-official, no grok-imagine-1.0; la autenticación es una clave API Bearer sin matriz pública de ámbitos OAuth; 1.5-official es solo primer fotograma y no puede extender; la duración de extend es de 2 a 10 segundos y factura también la longitud de origen; distingue siempre los errores HTTP de los status: failed.


    7. Lista de acciones

    • Crea una clave en el Portal de desarrolladores de ToAPIs.
    • Confirma que grok-imagine-video-official o grok-imagine-video-1.5-official aparece para tu clave mediante GET /v1/models?type=video.
    • Haz una prueba rápida de una generación oficial en 720p, consulta GET /v1/videos/generations/{id} y descarga el archivo antes de expires_at.
    • Si necesitas una continuación, extiende solo con grok-imagine-video-official y una duration de 2 a 10 segundos, y luego confirma que la cotización incluye la facturación de la duración de origen.
    • Siguiente paso: la guía oficial del modelo Imagine y la guía oficial del modelo Imagine 1.5 para el estado del catálogo en vivo, y la guía práctica de Grok Video si te referías a la familia no oficial grok-video-*.

    Explora los modelos mencionados en este artículo

    xAIVIDEO

    grok-imagine-video-official

    Tarifa actual: 11.2 credits /second
    Guía del modeloProbar en la consolaObtener clave de API
    xAIVIDEO

    grok-imagine-video-1.5-official

    Tarifa actual: 22.4 credits /second
    Guía del modeloProbar en la consolaObtener clave de API

    Artículos relacionados

    tutorial2026-11-20T10:00:00+08:008 min de lectura

    Alibaba Wan 3.0 Video API: Getting Started with Next-Gen Video Generation

    A production quickstart for wan3.0-video and wan3.0-video-prime on ToAPIs: one All-in-One endpoint, first and last frames versus reference media, file or link references, video editing constraints, and the documented polling path.

    TO
    ToAPIs Engineering & Evaluation Team
    #Wan 3.0
    tutorial2026-11-18T10:00:00+08:007 min de lectura

    Kling 3.0 Turbo API: Architecting High-Volume Short-Form Video Automation

    A production guide to kling-3.0-turbo on ToAPIs: documented duration and resolution ranges, first-frame-only image input, a bounded poll loop, and high-volume short-form automation without unverified draft prices.

    TO
    ToAPIs Engineering & Evaluation Team
    #Kling Turbo
    tutorial2026-11-18T10:00:00+08:008 min de lectura

    Kling 3.0 Omni API Deep Dive: Multi-Shot Video Generation and Physics Coherence

    A hands-on guide to kling-v3-omni on ToAPIs: official Omni placeholders, image_list, video_list, and element_list, first and end frames, and the documented polling path — without an undocumented shots array.

    TO
    ToAPIs Engineering & Evaluation Team
    #Kling Omni
    ToAPIs
    InicioToAPIs
    Pasarela empresarial de API de IA. Accede a GPT-5, Claude, Gemini y más de 200 modelos mediante una única API unificada.

    Modelos populares

    • Seedance 2.5 API
    • Seedance 2.0 API
    • Veo 3.1 Fast API
    • Kling 3.0 Turbo API
    Mostrar másMostrar menos
    • GPT Image 2 API
    • Claude Opus 4.8 API
    • Nano Banana 2 API
    • Seedance 2 Mini API
    • Todos los modelos

    Categorías de API

    • API de imagen con IA
    • API de vídeo con IA
    • API texto a vídeo
    • API imagen a vídeo
    Mostrar másMostrar menos
    • API de edición de imágenes con IA
    • API de LLM y razonamiento
    • Todas las herramientas API →

    Alternativas

    Alternativas
    • Alternativa a Kie.ai
    • Alternativa a Fal.ai
    • Alternativa a OpenRouter
    • Alternativa a Replicate
    • Alternativa a Wavespeed AI
    • Todas las comparativas →

    Guías destacadas

    Guías destacadas
    • Precios de Seedance 2.0 y 2.5
    • Guía de la API Seedance más económica
    • Guía de integración de MiniMax H3
    • Clave de API gratuita de Seedance 2
    • Inicio rápido de la API Seedance 2
    • Todos los artículos técnicos →

    Desarrolladores y plataforma

    Desarrolladores y plataforma
    • Documentación de API
    • MCP
    • Precios
    • Área de pruebas de modelos
    • LLMs.txt
    • Contactar con soporte
    • Directorio de guías de modelos
    Entidad operadora:
    鯨樞智能科技有限公司
    JINGSHU INTELLIGENT LIMITED
    Domicilio social:
    ROOM 5042, 5/F, YAU LEE CENTRE, NO.45, HOI YUEN ROAD, KWUN TONG, KOWLOON, HONG KONG
    PrivacidadTérminosUso aceptableEliminación de datosConservación de datosSubencargados y regionesFacturación y reembolsosPolítica de cookiesMapa del sitioAcerca de

    © 2026 ToAPIs. Todos los derechos reservados.