Skip to main content
POST
Playground
填入你的 API Key 和提示詞,然後傳送。這裡打的是線上介面,和你程式碼裡調的是同一個, 也是夠到影片模型的唯一方式。
從這個頁面發出的請求是真實的,會計入你的 Key。 影片按秒計價:一秒的 480p 約 $0.05 到 $0.08,而十五秒的 1080p 要幾美元。 先從短的試。

參數

string
必填
用哪個模型。接受 grok-imagine-videogrok-imagine-video-1.5,精確匹配。 只有 grok-imagine-video 能編輯和延長現成片段, 只有 grok-imagine-video-1.5 能到 1080p 和用預設音色。
object
必填
生成參數。下面沒列出的鍵一律以 invalid_params 拒絕。
string
任務結束後把結果 POST 到這個地址,省掉輪詢。 影片要 20 到 50 秒,回撥值得接一下。

會返回什麼

提交立刻返回,一秒都用不到。片子不在這個響應裡——生成是在後臺進行的。

然後輪詢取結果

這個 Playground 只覆蓋建立呼叫。拿上面響應裡的 id 去讀任務, 直到 status 變成 completedfailed——按長度和解析度不同,20 到 50 秒。
完成的任務帶一個 outputs 陣列,裡面是一個 MP4:
檔案以 video/mp4 交付,可以內聯播放。時長比你要的多約 0.04 秒。
產物 URL 不鑑權,並且在任務完成 24 小時後失效。 usage.cost_in_usd_ticks原價,實際扣費是它乘以你所在分組的倍率—— 見計價

下一步

概覽

三種模式、時長與解析度檔位、參考圖、音色與計價。

非同步任務 API

輪詢閉環、回撥,以及完整錯誤表。