ToAPIs
    首页ToAPIs
    图片生成GPT Image 2.6、Gemini 图像…视频生成Seedance、Veo、Kling、Sora…聊天与写作GPT-5.6、Claude、DeepSeek…语音与音乐配音、语音合成、播客
    新上线Seedance 2.5
    价格API 文档MCP
    博客竞品替代
    登录免费试用
    全部模型价格API 文档MCP博客竞品替代
    登录免费试用

    语言

    Esc
    • Seedance 2.5视频生成
    • GPT Image 2图片生成
    • GPT Image 2.6图片生成
    • GPT Image 2.5图片生成
    • Veo 3.1 Fast视频生成
    • Kling 3.0 Turbo视频生成
    • Kling V4 Flash视频生成
    • Grok Video 1.5视频生成
    • Nano Banana 2图片生成
    • Seedream 5.5图片生成
    • FLUX图片生成
    • Sora 2视频生成
    • 全部图片模型用途
    • 全部视频模型用途
    • GPT-5.6 Sol聊天与写作
    • Claude Opus 4.8聊天与编程
    • Claude Opus 4.7聊天与编程
    • DeepSeek V4 ProDeepSeek · 文字
    • Gemini Omni 1.1 FlashGoogle · 多模态
    1. 首页
    2. 博客
    3. 开发教程
    4. 如何通过 OpenAI 兼容接口调用 Grok Video 3 API
    返回全部文章
    tutorial2026-11-175 分钟阅读

    如何通过 OpenAI 兼容接口调用 Grok Video 3 API

    把 OpenAI 兼容客户端指向 ToAPIs,调用当前 Grok Video 目录型号:共享 Bearer 鉴权与 /v1 源站,视频任务走 POST /v1/videos/generations,而不是未公布的 grok-video-3 路径。

    ToAPIs Engineering & Evaluation Team
    Grok VideoOpenAI CompatibleVideo APIAPI GatewayTutorial
    TL;DR - 核心要点
    • ToAPIs 文档提供统一的 OpenAI 兼容 /v1 源站和 Bearer API Key。当前在 openai-video 端点列出的 Grok Video 型号是 grok-video-1.0 与 grok-video-1.5,而不是 grok-video-3。
    • 使用 GET /v1/models?type=video 列出视频型号。默认模型列表只返回文本型号;省略 type 会看不到 Grok Video ID。
    • 通过 POST /v1/videos/generations 创建任务,并用 GET /v1/videos/generations/{id} 轮询。这是已文档化的视频约定。除非账户文档另有说明,否则不要假定 ToAPIs 提供 client.videos.create 这类 OpenAI Videos SDK 方法。
    • 聊天、上传和视频请求共用同一个 Authorization 头。本地素材请先通过 POST /v1/uploads/images 上传,再传入返回的公开 URL。
    • 请在账户中确认精确型号字符串和实时费率。兼容的源站并不会凭空产生未公布的型号或固定单价。

    如何通过 OpenAI 兼容接口调用 Grok Video 3 API

    目标型号:grok-video-1.5、grok-video-1.0
    推理接口:https://api.toapis.com/v1/videos/generations
    相关阅读:Grok Video 实操指南 · Grok Imagine 官方渠道 API · Chatbox OpenAI 兼容配置 · 列出模型


    1. 核心摘要与性能速览 (TL;DR)

    • 这里的“OpenAI 兼容”指什么:ToAPIs 文档提供统一的 /v1 源站、Bearer 鉴权,以及 OpenAI 风格的模型列表和聊天补全接口。公共 Grok Video 型号登记在目录的 openai-video 端点家族中。这并不表示未公布的 grok-video-3 可以使用,也不等于已经文档化了 OpenAI Videos SDK 方法。
    • 型号:在 GET /v1/models?type=video 确认你的密钥可见后,使用 grok-video-1.5 或 grok-video-1.0。日期为 2026-11-10 的公共目录快照未列出 grok-video-3。
    • 视频路径:用 POST /v1/videos/generations 创建,用 GET /v1/videos/generations/{id} 轮询。官方示例使用 https://toapis.com(中国大陆使用 https://toapis.cn)。本系列也使用 https://api.toapis.com。
    • 共享鉴权:在 Authorization: Bearer 中使用同一把 API Key。这些视频调用没有单独的公开 OAuth 范围文档。
    • 客户端选择:可以把 OpenAI SDK 的 base_url="https://api.toapis.com/v1" 用于聊天,以及熟悉的密钥/源站配置。对于 Grok Video,本指南使用已文档化的 REST JSON 请求体,以便显式保留 video_generation_mode 和图片 URL 字段。

    2. 兼容源站、模型列表与视频路径

    请把源站、/v1 前缀和密钥放在一起使用。把 ToAPIs 密钥配到 https://api.openai.com/v1,或把 ToAPIs 源站配到供应商原生 Grok 路径,都属于另一套——而且未经文档化的——做法。

    步骤文档化路径说明
    列出模型GET /v1/models?type=video默认 GET /v1/models 只返回文本型号。请使用 type=video 或 type=all
    上传本地图片POST /v1/uploads/images(multipart file)读取 data.url。不要在生成请求中发送 base64
    创建 Grok Video 任务POST /v1/videos/generations请求体包含 model、prompt 以及 1.5 的模式/媒体字段
    轮询状态GET /v1/videos/generations/{id}终态为 completed 和 failed
    聊天(不是视频)POST /v1/chat/completions仅共享源站和密钥

    在 grok-video-1.5 上,将 video_generation_mode 设为 text_to_video、first_frame_image_to_video 或 reference_images_to_video,使 JSON 与实际发送的媒体一致。字段级约定见 Grok Video 实操指南 和 Grok Video 1.5 API 参考。

    兼容客户端面板经六边形网关连接到提交与轮询路径

    图 1:把客户端指向 ToAPIs 的 /v1 源站,用模型列表发现 grok-video-1.5 或 grok-video-1.0,然后在 /v1/videos/generations 上提交并轮询——不要走 chat/completions。

    若你配置的是桌面客户端而不是应用代码,Chatbox 配置指南 介绍了聊天场景下的 Host 字段写法。不要指望同一条聊天路径会返回视频文件。


    3. 生产级实现:cURL 与 Python

    本系列面向国际环境的示例使用 https://api.toapis.com。官方文档要求中国大陆用户使用 https://toapis.cn。每个环境只保留一个源站。

    步骤 1:先发现型号,再用 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"
      }'
    

    硬编码之前,先检查模型列表中的精确 id 字符串。如果没有 grok-video-3,就不要发送它。

    步骤 2:Python — 共享源站,REST 调用视频接口

    这里的 OpenAI SDK 仅用于共享 base_url 和 API Key。视频的创建与轮询仍走已文档化的 generations 路径,以免 1.5 的请求体字段在非官方客户端映射中丢失。

    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))
    

    如果列表接口的响应结构与预期不符,请记录原始 JSON,并对照你账户的 列出模型 页面调整解析逻辑。当 ID 不存在时,不要发明一个回退逻辑去发送 grok-video-3。


    4. 错误处理与状态码对照

    下表是排查起点,并不保证与 ToAPIs 错误码完全一致。即便查询接口返回 HTTP 成功,也必须读取任务的 status。详见 错误参考。

    HTTP 或任务状态常见类别建议操作
    400未知型号、模式与媒体不匹配,或把视频请求体发到了聊天路径用 GET /v1/models?type=video 确认型号,确认发布到 /v1/videos/generations,并且 1.5 任务设置了匹配的 video_generation_mode
    401缺少或无效的 API Key使用 ToAPIs 密钥,而不是 OpenAI 平台密钥,并确认 Bearer 请求头
    404源站错误、缺少 /v1,或使用了 /videos/tasks/{id} 这类自造路径在提交时使用的同一源站上改为 GET /v1/videos/generations/{id}
    429速率或并发限制若存在 Retry-After 则遵守,并加入抖动后退避
    5xx 或客户端超时网关或上游临时问题重新提交前先查询已有任务 id
    status: failed生成未成功读取 error.code 和 error.message。不要原样重试已被策略拒绝的请求体

    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. 定价与 FinOps ROI

    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

    • 兼容性不会改变计费 SKU。 计费依据是你发送的目录型号(grok-video-1.5 或 grok-video-1.0),而不是“使用了 OpenAI SDK”。
    • 不要沿用规划稿里的单价。 Grok Video 1.5 参考并不保证固定的每秒价格。ToAPIs 定价页上的官方厂商参考行仅供展示,未必等于账户扣费。
    • 发现型号成本低,重复生成成本高。 可以短时缓存模型列表,但客户端超时后务必先查任务状态,再创建新任务。
    • ToAPIs 计费通常是按量付费——请确认账户上的现行条款。

    6. 常见问题

    详见 frontmatter 中的 FAQ。摘要:兼容源站并不会解锁 grok-video-3;/v1 只加一次;轮询 /v1/videos/generations/{id};不要假定存在 SDK 的 videos.create 助手;聊天补全不会返回 MP4。


    7. 行动清单

    • 在 ToAPIs 开发者门户 创建密钥。
    • 把客户端指向 https://api.toapis.com/v1(中国大陆使用 https://toapis.cn/v1),并带上 Authorization: Bearer。
    • 调用 GET /v1/models?type=video,记录该密钥可见的精确 Grok Video 型号。
    • 用 grok-video-1.5 和 video_generation_mode: "text_to_video" 冒烟测试 POST /v1/videos/generations,然后轮询同一个 id。
    • 下一步:字段与模式细节见 Grok Video 实操指南,目录现状见 Grok Video 1.5 型号指南。

    本文提到的模型与接口

    xAIVIDEO

    grok-video-1.0

    当前费率:2 credits /second
    模型解析页在线试跑获取 API Key
    xAIVIDEO

    Grok Video 1.5

    当前费率:3.824 credits /second
    模型解析页在线试跑获取 API Key

    相关技术文章

    tutorial2026-11-17T10:00:00+08:006 分钟阅读

    上手 Grok-Video-3 API:关于 xAI 视频引擎,你需要先弄清的当前约定

    在 ToAPIs 上调用 xAI Grok Video 的实操指南:当前公共目录列出的是 grok-video-1.0 与 grok-video-1.5,而不是 grok-video-3;本文说明现有 generations 约定、生成模式与轮询路径。

    TO
    ToAPIs Engineering & Evaluation Team
    #Grok Video
    tutorial2026-11-20T10:00:00+08:008 分钟阅读

    阿里 Wan 3.0 视频 API 入门:下一代视频生成快速上手

    在 ToAPIs 上调用 wan3.0-video 与 wan3.0-video-prime 的生产入门:同一套 All-in-One 接口、首尾帧与参考素材的互斥规则、文件或网页引用、视频编辑约束,以及已文档化的轮询路径。

    TO
    ToAPIs Engineering & Evaluation Team
    #Wan 3.0
    tutorial2026-11-18T10:00:00+08:007 分钟阅读

    Kling 3.0 Turbo API:高并发短视频自动化架构

    在 ToAPIs 上把 kling-3.0-turbo 接入生产的指南:已文档化的时长与分辨率范围、仅支持首帧的图片输入、有上限的轮询循环,以及不引用未核实规划稿价格的高频短视频自动化。

    TO
    ToAPIs Engineering & Evaluation Team
    #Kling Turbo
    ToAPIs
    首页ToAPIs
    企业级 AI API 网关,通过统一接口接入 GPT-5、Claude、Gemini 等 200+ 模型。

    热门模型

    • Seedance 2.5 API
    • Seedance 2.0 API
    • Veo 3.1 Fast API
    • Kling 3.0 Turbo API
    展开更多收起
    • GPT Image 2 API
    • Claude Opus 4.8 API
    • Nano Banana 2 API
    • Seedance 2 Mini API
    • 所有模型

    API 品类

    • AI 图像生成 API
    • AI 视频生成 API
    • 文生视频 API
    • 图生视频 API
    展开更多收起
    • AI 图像编辑 API
    • 语言与推理模型 API
    • 全部 API 工具 →

    替代方案

    替代方案
    • Kie.ai 替代方案
    • Fal.ai 替代方案
    • OpenRouter 替代方案
    • Replicate 替代方案
    • Wavespeed AI 替代方案
    • 全部竞品对比 →

    精选技术指南

    精选技术指南
    • Seedance 2.0 与 2.5 价格对比
    • 低成本 Seedance API 接入指南
    • MiniMax H3 接入指南
    • Seedance 2 免费测试 Key
    • Seedance 2 API 快速开始
    • 全部技术文章 →

    开发者与平台

    开发者与平台
    • API 开发文档
    • MCP
    • 定价
    • 在线模型测试台
    • LLMs.txt
    • 联系支持
    • 模型指南索引
    运营主体:
    鯨樞智能科技有限公司
    JINGSHU INTELLIGENT LIMITED
    注册地址:
    ROOM 5042, 5/F, YAU LEE CENTRE, NO.45, HOI YUEN ROAD, KWUN TONG, KOWLOON, HONG KONG
    隐私政策服务条款使用政策数据删除政策数据留存政策子处理方与数据区域计费与退款说明Cookie 政策网站地图关于我们

    © 2026 ToAPIs. 版权所有。