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. Cómo acceder a la API de Grok Video 3 mediante endpoints compatibles con OpenAI
    Volver a todos los artículos
    tutorial2026-11-176 min de lectura

    Cómo acceder a la API de Grok Video 3 mediante endpoints compatibles con OpenAI

    Apunta un cliente compatible con OpenAI a ToAPIs para llamar a los ID actuales del catálogo de Grok Video: autenticación Bearer compartida y URL base /v1, con trabajos de vídeo en POST /v1/videos/generations en lugar de una ruta grok-video-3 no publicada.

    ToAPIs Engineering & Evaluation Team
    Grok VideoOpenAI CompatibleVideo APIAPI GatewayTutorial
    TL;DR - Puntos clave
    • ToAPIs documenta una URL base /v1 unificada compatible con OpenAI y una clave API Bearer. Los ID de Grok Video que hoy aparecen para ese endpoint openai-video son grok-video-1.0 y grok-video-1.5, no grok-video-3.
    • Lista los modelos de vídeo con GET /v1/models?type=video. La lista de modelos predeterminada devuelve solo modelos de texto; omitir type oculta los ID de Grok Video.
    • Crea y consulta trabajos de vídeo con POST /v1/videos/generations y GET /v1/videos/generations/{id}. Este es el contrato de vídeo documentado. No des por hecho que existe en ToAPIs un método del SDK de OpenAI Videos como client.videos.create, salvo que la documentación de tu cuenta lo indique.
    • Mantén la misma cabecera Authorization en chat, cargas y vídeo. Para recursos locales, sube con POST /v1/uploads/images y pasa la URL pública devuelta.
    • Confirma la cadena de modelo exacta y la tarifa vigente en tu cuenta. Una URL base compatible no inventa un ID de modelo no publicado ni un precio unitario fijo.

    Cómo acceder a la API de Grok Video 3 mediante endpoints compatibles con OpenAI

    Modelos objetivo: grok-video-1.5, grok-video-1.0
    Endpoint de inferencia: https://api.toapis.com/v1/videos/generations
    Relacionado: Guía práctica de Grok Video · API del canal oficial de Grok Imagine · Configuración compatible con OpenAI en Chatbox · Listar modelos


    1. Resumen y panorama del rendimiento

    • Qué significa «compatible con OpenAI» aquí: ToAPIs documenta un único origen /v1, autenticación Bearer y una lista de modelos y una API de finalizaciones de chat al estilo OpenAI. Los ID públicos de Grok Video están registrados en la familia de endpoints openai-video del catálogo. Eso no significa que funcione un ID grok-video-3 no publicado, y por sí solo no documenta un método del SDK de OpenAI Videos.
    • ID: usa grok-video-1.5 o grok-video-1.0 después de que aparezcan para tu clave en GET /v1/models?type=video. La instantánea pública del catálogo fechada el 2026-11-10 no lista grok-video-3.
    • Ruta de vídeo: crea con POST /v1/videos/generations. Consulta con GET /v1/videos/generations/{id}. Los ejemplos oficiales usan https://toapis.com (y https://toapis.cn para China continental). Esta serie también usa https://api.toapis.com.
    • Autenticación compartida: una clave API en Authorization: Bearer. No existe un documento público separado de ámbitos OAuth para estas llamadas de vídeo.
    • Elección de cliente: usa el SDK de OpenAI contra base_url="https://api.toapis.com/v1" para trabajo de tipo chat y para una configuración familiar de clave y origen. Para Grok Video, esta guía usa el cuerpo JSON REST documentado, para que video_generation_mode y los campos de URL de imagen queden explícitos.

    2. Origen compatible, lista de modelos y rutas de vídeo

    Mantén juntos el origen, el prefijo /v1 y la clave. Mezclar una clave de ToAPIs con https://api.openai.com/v1, o un origen de ToAPIs con una ruta nativa de Grok del proveedor, es una configuración distinta y no documentada.

    PasoRuta documentadaNotas
    Listar modelosGET /v1/models?type=videoGET /v1/models predeterminado devuelve solo modelos de texto. Usa type=video o type=all
    Subir una imagen localPOST /v1/uploads/images (file multipart)Lee data.url. No envíes base64 en la llamada de generación
    Crear un trabajo de Grok VideoPOST /v1/videos/generationsEl cuerpo incluye model, prompt y los campos de modo y medios de 1.5
    Consultar estadoGET /v1/videos/generations/{id}Los estados finales son completed y failed
    Chat (no vídeo)POST /v1/chat/completionsComparte solo el origen y la clave

    En grok-video-1.5, ajusta video_generation_mode a text_to_video, first_frame_image_to_video o reference_images_to_video para que el JSON coincida con los medios que envías. El contrato por campo está en la guía práctica de Grok Video y en la referencia de la API de Grok Video 1.5.

    Un panel de cliente compatible que se conecta por una pasarela hexagonal a las rutas de envío y de consulta

    Figura 1: apunta el cliente a un origen /v1 de ToAPIs, descubre grok-video-1.5 o grok-video-1.0 con la lista de modelos y luego envía y consulta en /v1/videos/generations, no en chat/completions.

    Si estás configurando un cliente de escritorio en lugar de código de aplicación, la guía de configuración de Chatbox cubre el patrón del campo de host para chat. No esperes que esa misma ruta de chat devuelva un archivo de vídeo.


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

    Los ejemplos internacionales de esta serie usan https://api.toapis.com. La documentación oficial indica a los usuarios de China continental que usen https://toapis.cn. Mantén un solo origen por entorno.

    Paso 1: descubre el ID y luego envía con cURL

    bash
    curl -sS "https://api.toapis.com/v1/models?type=video" \
      -H "Authorization: Bearer $TOAPIS_API_KEY"
    
    curl -X POST "https://api.toapis.com/v1/videos/generations" \
      -H "Authorization: Bearer $TOAPIS_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "grok-video-1.5",
        "prompt": "A cinematic product shot with a slow camera push-in",
        "video_generation_mode": "text_to_video",
        "duration": 8,
        "resolution": "720p",
        "aspect_ratio": "16:9"
      }'
    

    Revisa la lista de modelos para ver la cadena id exacta antes de fijarla por código. Si grok-video-3 no aparece, no lo envíes.

    Paso 2: Python, origen compartido y llamadas de vídeo REST

    El SDK de OpenAI se muestra solo para la base_url y la clave API compartidas. La creación y la consulta de vídeo se mantienen en las rutas de generaciones documentadas, para que los campos del cuerpo de 1.5 no se pierdan en un mapeo de cliente no oficial.

    python
    import os
    import time
    import requests
    from openai import OpenAI
    
    API_KEY = os.environ["TOAPIS_API_KEY"]
    BASE = "https://api.toapis.com"
    HEADERS = {
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json",
    }
    
    # Shared origin and key. Use this client for chat completions; do not assume
    # a videos.create mapping unless your account docs define one.
    client = OpenAI(base_url=f"{BASE}/v1", api_key=API_KEY)
    
    
    def list_video_model_ids() -> list[str]:
        res = requests.get(
            f"{BASE}/v1/models",
            headers=HEADERS,
            params={"type": "video"},
            timeout=30,
        )
        res.raise_for_status()
        data = res.json()
        items = data.get("data") or data.get("models") or []
        return [item.get("id") or item.get("name") for item in items if item]
    
    
    def dispatch_grok_video(prompt: str, model: str = "grok-video-1.5") -> str:
        available = set(list_video_model_ids())
        if available and model not in available:
            raise ValueError(f"{model} is not in this key's video model list")
        res = requests.post(
            f"{BASE}/v1/videos/generations",
            headers=HEADERS,
            json={
                "model": model,
                "prompt": prompt,
                "video_generation_mode": "text_to_video",
                "duration": 8,
                "resolution": "720p",
                "aspect_ratio": "16:9",
            },
            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) -> str:
        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=HEADERS, 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["result"]["data"][0]["url"]
            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")
    
    
    if __name__ == "__main__":
        print("Video models (excerpt):", list_video_model_ids()[:20])
        task_id = dispatch_grok_video("A cinematic product shot with a slow camera push-in")
        print("Task:", task_id)
        print("Video:", poll_task(task_id))
    

    Si la llamada de lista devuelve un formato inesperado, registra el JSON sin procesar y ajusta el lector a la página de Listar modelos de tu cuenta. No inventes un respaldo que envíe grok-video-3 cuando el ID falta.


    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. Consulta la referencia de errores.

    Estado HTTP o de tareaCategoría habitualAcción recomendada
    400ID de modelo desconocido, desajuste entre modo y medios, o un cuerpo de vídeo enviado a una ruta de chatConfirma el ID en GET /v1/models?type=video, que enviaste a /v1/videos/generations y que los trabajos de 1.5 definen un video_generation_mode coherente
    401Clave de API ausente o inválidaUsa una clave de ToAPIs, no una clave de la plataforma OpenAI, y confirma la cabecera Bearer
    404Origen equivocado, falta /v1 o una ruta inventada como /videos/tasks/{id}Cambia a GET /v1/videos/generations/{id} en el origen que usaste para enviar
    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: failedLa generación no tuvo éxitoLee error.code y error.message. No repitas un payload rechazado por política sin cambios

    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

    Estimated cost=successful billable jobs×current account rate for that model, duration, and resolution\text{Estimated cost} = \text{successful billable jobs} \times \text{current account rate for that model, duration, and resolution}Estimated cost=successful billable jobs×current account rate for that model, duration, and resolution

    • La compatibilidad no cambia la SKU facturable. Se te factura por el ID de modelo del catálogo que envías (grok-video-1.5 o grok-video-1.0), no por «usar el SDK de OpenAI».
    • No reutilices precios unitarios de borradores de planificación. La referencia de Grok Video 1.5 no garantiza un precio fijo por segundo. 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.
    • Un descubrimiento fallido es barato; una generación duplicada no. Cachea la lista de modelos durante un periodo corto, pero comprueba siempre el estado de la tarea tras un tiempo de espera agotado del cliente antes de crear otro trabajo.
    • La facturación de ToAPIs suele ser pago por uso: confirma las condiciones activas de tu cuenta.

    6. Preguntas frecuentes

    Consulta el bloque de preguntas frecuentes del frontmatter. En resumen: una URL base compatible no desbloquea grok-video-3; incluye /v1 una vez; consulta /v1/videos/generations/{id}; no des por hecho que existe un helper videos.create del SDK; las finalizaciones de chat no devolverán un MP4.


    7. Lista de acciones

    • Crea una clave en el Portal de desarrolladores de ToAPIs.
    • Apunta tu cliente a https://api.toapis.com/v1 (o https://toapis.cn/v1 en China continental) con Authorization: Bearer.
    • Llama a GET /v1/models?type=video y registra los ID exactos de Grok Video que ve tu clave.
    • Haz una prueba rápida de POST /v1/videos/generations con grok-video-1.5 y video_generation_mode: "text_to_video", y luego consulta el mismo id.
    • Siguiente paso: la guía práctica de Grok Video para los detalles de modo y de campos de imagen, y la guía del modelo Grok Video 1.5 para el estado del catálogo en vivo.

    Explora los modelos mencionados en este artículo

    xAIVIDEO

    grok-video-1.0

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

    Grok Video 1.5

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

    Artículos relacionados

    tutorial2026-11-17T10:00:00+08:007 min de lectura

    Práctica con la API de Grok-Video-3: todo lo que necesitas saber sobre el motor de vídeo de xAI

    Guía práctica para llamar hoy a xAI Grok Video en ToAPIs: el catálogo público sigue listando grok-video-1.0 y grok-video-1.5, no grok-video-3, con el contrato actual de generaciones, los modos y la ruta de sondeo.

    TO
    ToAPIs Engineering & Evaluation Team
    #Grok Video
    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
    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.