ToAPIs
    首頁ToAPIs
    圖片生成GPT Image 2.6、Gemini 圖像…影片生成Seedance、Veo、Kling、Sora…聊天與寫作GPT-5.6、Claude、DeepSeek…語音與音樂配音、語音合成、Podcast
    新上線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. 版權所有。