grok-imagine-video

Grok Imagine Video 可依文字描述生成短片，並選擇片長及畫面比例。xAI 的模型本身也支援將圖片動畫化，以及依指示編輯影片。

Ailoot · 影片 POST /v1/videos/generations grok-imagine-video

關於模型

此說明介紹模型的能力。Ailoot 可用的輸入、輸出與選項，依所選方法列於下方。

從描述到短片

Grok Imagine Video 可依文字生成影片。xAI 的模型本身也有使用原始圖片及影片的模式。Ailoot 已公開的生成方法以文字描述作為輸入，成果為短片。

生成採非同步方式：先建立任務，再依識別碼取得狀態及完成成果。依 xAI 說明，製作短片可能需要數分鐘，時間取決於場景複雜度、片長、解析度及所選模式。

片長與畫面

生成短片的片長可選 1 至 15 秒。畫面比例包括 1:1、16:9、9:16、4:3、3:4、3:2 及 2:3，預設為 16:9。此版本提供 480p 與 720p，1080p 則屬於 1.5 版本。

將原始圖片動畫化

在 xAI 的圖片模式中，圖片成為起始影格，文字指令指定動作。預設會沿用原始圖片的比例。若明確指定長寬比，會改變影片形狀，並可能拉伸圖片。

依指示編輯

處理現成影片時，模型套用描述的修改，並保留場景其餘內容。這種模式可改變特定元素，同時維持原始短片的場面安排。片長及比例沿用原片，不可另行指定新片長或畫面形狀。

供編輯的原始短片上限為 8.7 秒，成果解析度不得高於 720p。1080p 素材會縮小為 720p。文字生成的設定不會自動適用於編輯。

延續現成短片

在 xAI 的獨立模式中，此版本可從原始短片的最後一個影格繼續。原始 MP4 須長 2 至 15 秒，追加部分為 2 至 10 秒，預設為 6。成果合併原始影片與延續片段，比例與解析度沿用原始素材，解析度上限為 720p；此模式不可分別變更。這項製造商能力，與 Ailoot 已公開的文字生成方式不同。

參考素材與版本限制

xAI 提供視覺參考素材，可引導場景中人物、服裝與物件的外觀。參考素材設定視覺特徵，而非精確指定第一個影格。原版 Grok Imagine Video 不能同時使用起始影格與參考素材。

此版本不接受精確固定的最後影格或中間關鍵影格，這些能力屬於 Grok Imagine Video 1.5。生成、原始圖片動畫化，以及現成影片修改，是不同模式；此處的 Ailoot 已公開方法描述文字生成。

Ailoot · 影片 POST /v1/videos/generations grok-imagine-video

grok-imagine-video

xAI /grok-imagine-video

入門

Grok Imagine Video 可依文字描述生成短片，並選擇片長及畫面比例。xAI 的模型本身也支援將圖片動畫化，以及依指示編輯影片。

接受的輸入: 文字
結果: 影片

Ailoot 可用 · 輸入與方法

Ailoot · 影片 POST /v1/videos/generations

輸入: text
輸出: video
輸出格式: mp4

欄位	類型	要求	值與限制	預設值
欄位`model`	類型`string`	要求必填	值與限制 grok-imagine-video	預設值—
欄位`prompt`	類型`string`	要求選填	值與限制長度下限: 1	預設值—
欄位`duration`	類型`integer`	要求選填	值與限制最小值: 1 最大值: 15 條件: 切勿同時提供 duration 與 seconds 單位: 秒	預設值1
欄位`seconds`	類型`integer\|integer_string`	要求選填	值與限制最小值: 1 最大值: 15 替代選項: duration	預設值—
欄位`resolution`	類型`string`	要求選填	值與限制 480p, 720p	預設值480p
欄位`aspect_ratio`	類型`string`	要求選填	值與限制 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 條件: 若提供圖片輸入且省略長寬比，供應商會沿用圖片的長寬比	預設值16:9
欄位`size`	類型`string`	要求選填	值與限制 1280x720, 720x1280, 1920x1080, 1080x1920 條件: 若同時指定 resolution/aspect_ratio，必須與其一致	預設值—
欄位`image`	類型`object`	要求選填	值與限制條件: 實際且受支援的輸入圖片；可省略提示詞	預設值—

輸入素材組合

文字生成影片 · 必填： prompt

圖片生成影片 · 必填： image

方法參數與生命週期

參數	規格
參數`material_types`	規格text
參數`required`	規格null
參數`optional_controls`	規格null

生命週期： submit_once_poll_original

GET /v1/videos/{request_id}

GET /v1/videos/generations/{request_id}

GET /v1/videos/{request_id}/content

GET /v1/videos/generations/{request_id}/content

方法結構與 ID 均為精確值；供應商能力與准入狀態分開。

方案

Ailoot 方法費率

Ailoot 影片POST /v1/videos/generations

輸入: US$0.002 每張輸入圖片
輸入: US$0.01 每秒輸入影片
輸出: US$0.05 480p 每秒
輸出: US$0.07 720p 每秒

Ailoot 會在請求前預留估算金額。取得結果後，依實測用量結算最終費用。串流結算採用最終用量紀錄。預留金額與結算的運作方式 →

請求範例

Ailoot · 影片

影片範例

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl https://api.ailoot.ai/v1/videos/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "grok-imagine-video", "prompt": "A person walks slowly through a quiet garden as the camera tracks from the side."}'

接收並儲存結果

Ailoot · 影片

mp4

GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content

查看工作狀態

GET · 取得狀態

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_VIDEO_ID
video_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1
curl "https://api.ailoot.ai/v1/videos/generations/$video_id" \
  -H "Authorization: Bearer $AILOOT_API_KEY"

其他內容讀取方式

GET · 取得內容

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_VIDEO_ID
video_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1
curl "https://api.ailoot.ai/v1/videos/generations/$video_id/content" \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  --output video.mp4

保留所有已完成的結果

請儲存每部已完成的影片或傳回的檔案，並從實際傳回的每個素材 URL 取得素材。

請保留完整的狀態 JSON 與實際 request_id。status=done 的已完成回應會包含 video.url，其中是自有內容 URL。請保留回報的長度與每個回傳的結果欄位。

需要檢查原始回應時

請讀取現有的原始作業；切勿重新提交傳送結果不明的請求。

回應欄位

欄位	類型
欄位`request_id`	類型string
欄位`id`	類型string
欄位`status`	類型string
欄位`video.url`	類型owned signed content URL
欄位`video.duration`	類型number
欄位`video.respect_moderation`	類型boolean

錯誤與後續步驟

回應	條件	下一步
回應400 · `invalid_request_error`	條件必要欄位、素材表示方式或參數值無效	下一步提出新的建立請求前，先修正指定欄位。
回應409 · `video_not_ready`	條件原始結果內容尚無法取得	下一步請輪詢原始回傳的 ID，並遵守 Retry-After。
回應`server_error`	條件回傳的回應表示該作業或結果需要檢查	下一步保留原始回傳的作業／任務 ID、請求標頭與回應；繼續以支援的方式讀取該原始作業。請勿重新提交建立請求。

別名

模型別名

Ailoot grok-imagine-video

方法路徑別名

請使用上方列出的 API 方法路徑。

grok-imagine-video