文件Grok Video
模型

grok-video

可做文字轉影片與圖片轉影片,且價格會依時長與解析度動態變化。

模型補充文件,搭配 /unified-video/quote 與 /unified-video/generate 使用權限: 依後端實際 API key scope 設定而定

適合情境

想提供動態價格模型的團隊。

文字轉影片
外部圖片或 Grok 參考任務的圖片轉影片
動態時長定價

這隻模型可以丟什麼

  • 必填:model。文字轉影片時 prompt 必填,圖片轉影片時 prompt 為選填。
  • 選填:images(0-7)、referenceTaskId、referenceIndex、aspectRatio、duration、resolution、mode、nsfwChecker、projectId
  • images 與 referenceTaskId 互斥,只能擇一。

主要參數是做什麼的

model

固定填 grok-video。

prompt

描述你想生成的影片內容。

images

外部圖片 URL,最多 7 張。不能跟 referenceTaskId 同時使用。使用外部圖片時不能用 spicy 模式。

referenceTaskId

指向之前 Grok text-to-image 任務的 id。不能跟 images 同時使用。

referenceIndex

選填整數 0..5,從 referenceTaskId 任務的 6 張圖中挑一張。預設 0。

aspectRatio

支援 1:1、16:9、2:3、3:2、9:16。預設 2:3。

duration

整數 6..30。T2V 以數字傳送,I2V 以字串傳送。

resolution

支援 480p、720p。

mode

fun、normal 或 spicy。預設 normal。使用外部圖片時不允許 spicy。

nsfwChecker

是否啟用內容檢查。

projectId

內部追蹤用途。

欄位規則

duration

支援整數 6..30。

resolution

支援 480p、720p。

mode

預設 normal。

images / referenceTaskId

互斥,只能擇一。

referenceIndex

0..5,僅在使用 referenceTaskId 時有效。

價格公式

解析度
公式
480p
9 + (duration - 6) * 2
720p
17 + (duration - 6) * 2

前端補充說明

  • 只有使用 Grok 參考任務時才顯示 referenceTaskId 與 referenceIndex。
  • 使用 referenceTaskId 時不要顯示外部圖片選擇器,反之亦然。
  • 使用外部圖片時要隱藏 spicy 選項。
  • 時長可用任意整數 6 到 30。
  • 完成通知以 callback 為主。

想直接開始測試?

先到 Settings 建立 general API key,再回到這裡直接複製請求範例。

打開 API 金鑰