Skip to main content
POST
  • Grok Video 視頻生成模型
  • 通過 model 參數選擇 grok-video-1.0 模型
  • 支持文本到視頻、圖生視頻
  • 異步任務管理,通過任務 ID 查詢結果
重要變更:爲了更好的性能和成本控制,我們不再支持在 reference_images 中直接傳入 base64 圖片數據。請先使用 上傳圖片接口 上傳圖片,獲取 URL 後再調用本接口。

Authorizations

string
必填
所有接口均需要使用 Bearer Token 進行認證獲取 API Key:訪問 API Key 管理頁面 獲取您的 API Key使用時在請求頭中添加:

Body

string
預設值:"grok-video-1.0"
必填
視頻生成模型名稱支持的模型:
  • grok-video-1.0 - Grok 視頻生成模型
示例:"grok-video-1.0"
string
必填
視頻生成的文本描述
integer
預設值:"8"
視頻時長(秒)支持範圍:115
string
預設值:"720p"
視頻分辨率支持的值:480p720p
string
視頻寬高比支持的格式:
  • 16:9 (橫屏)
  • 9:16 (豎屏)
  • 3:2 (橫屏)
  • 2:3 (豎屏)
  • 1:1 (方形)
string
可選主圖 URL。僅支持公開的 http://https:// 地址。
string[]
用於圖生視頻的參考圖像 URL 數組⚠️ 僅支持 URL 格式(不再支持 base64)
  • 公開可訪問的圖像 URL(http:// 或 https://)
  • imagereference_images 合計最多 8 張
  • 可使用 上傳圖片接口 上傳本地圖片獲取 URL

Response

string
任務唯一標識符,用於查詢任務狀態
string
對象類型,固定爲 generation.task
string
使用的模型名稱
string
任務狀態
  • queued - 排隊等待處理
  • in_progress - 處理中
  • completed - 成功完成
  • failed - 失敗
integer
任務創建時間戳(Unix 時間戳)
integer
任務進度,提交成功時通常爲 0
object
任務元數據