grok-imagine-video-1.5-preview
Grok Imagine Video 1.5 可依文字生成 1–15 秒的短片，包含 1080p。模型本身支援圖片動畫化、視覺參考素材、關鍵影格安排，以及音軌。
關於模型
此說明介紹模型的能力。Ailoot 可用的輸入、輸出與選項，依所選方法列於下方。
建立影片場景
Grok Imagine Video 1.5 是 xAI 依文字描述及視覺素材生成短片的模型。目前的 Ailoot 方法已公開文字生成；模型本身的其他模式可將圖片動畫化、使用參考素材，以及指定場景的基準影格。
成果以非同步方式建立，提交任務後，依識別碼查詢是否完成。依 xAI 說明，過程可能需要數分鐘，取決於場景複雜度、片長及解析度。取得任務識別碼，尚不表示短片已完成。
片長、比例與解析度
生成短片的長度為 1 至 15 秒。可選 1:1、16:9、9:16、4:3、3:4、3:2 或 2:3；文字生成的預設比例為 16:9。將圖片動畫化時，預設保留原始圖片比例。
文字及起始圖片生成提供 480p、720p 與 1080p。預設使用 480p，參考素材模式則限制為 720p。不能僅因模型具備 1080p，就將此解析度套用到所有模式。
控制外觀
在參考素材模式中，xAI 最多接收 7 張圖片。圖片指定人物、物件、服裝及其他視覺特徵，不會固定起始影格。這種方式適合重複出現同一角色、產品展示，以及在不同場面安排中維持所需外觀。
第一、最後與中間影格
1.5 版本可固定精確的第一個影格、最後一個影格，或同時固定兩者。只指定最後影格時，模型自行建立開頭，並走向指定圖片。同時設定兩端時，模型產生兩者之間的動作；文字指令可進一步說明動作及攝影機運動。
影片內部分鏡最多可固定 4 個關鍵影格。每個時間點都必須嚴格位於開始之後、結束之前，並對齊 1/3 秒的時間格線。若兩個影格四捨五入後落在同一格線時間點，會被拒絕。為避免此情況，請至少保留 1/3 秒的間隔。第一與最後影格，和這四個中間影格分開設定。
基準影格可搭配視覺參考素材與預設聲音。只要固定至少一個影格，文字描述便非必填，因為圖片序列本身已設定場景。關鍵影格不能與影片編輯模式一起使用。這些 xAI 能力不表示 Ailoot 已公開的文字生成方法也能使用。
聲音與人聲
生成短片預設包含音軌，也提供無聲成果。在 xAI 的聲音參考模式中，最多可選 3 個預設聲音，並與場景中的說話者連結。
上傳自己的音訊檔案作為聲音樣本，不是此模型普遍提供的能力；xAI 另依申請提供。預設聲音與上傳音訊，是不同種類的輸入。
工作模式
文字生成建立新場景，起始圖片設定開頭，參考素材引導外觀，固定影格則設定時間中的視覺基準點。各模式有不同限制，因此不能無條件將一種方式的設定套用到另一種。
Ailoot · 影片 POST /v1/videos/generations grok-imagine-video-1.5-preview
grok-imagine-video-1.5-preview
grok-imagine-video-1.5-preview入門
Grok Imagine Video 1.5 可依文字生成 1–15 秒的短片，包含 1080p。模型本身支援圖片動畫化、視覺參考素材、關鍵影格安排，以及音軌。
- 接受的輸入
- 文字
- 結果
- 影片
Ailoot 可用 · 輸入與方法
Ailoot · 影片 POST /v1/videos/generations
- 輸入
text- 輸出
video- 輸出格式
- mp4
| 欄位 | 類型 | 要求 | 值與限制 | 預設值 |
|---|---|---|---|---|
欄位model | 類型string | 要求必填 | 值與限制 grok-imagine-video-1.5-preview | 預設值— |
欄位prompt | 類型string | 要求選填 | 值與限制 長度下限: 1 | 預設值— |
欄位duration | 類型integer | 要求選填 | 值與限制 最小值: 1 最大值: 15 條件: 切勿同時提供 duration 與 seconds 單位: 秒 | 預設值1 |
欄位seconds | 類型integer|integer_string | 要求選填 | 值與限制 最小值: 1 最大值: 15 替代選項: duration | 預設值— |
欄位resolution | 類型string | 要求選填 | 值與限制 480p, 720p, 1080p | 預設值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 方法費率
POST /v1/videos/generations- 輸入
- US$0.01 每張輸入圖片
- 輸出
- US$0.25 1080p 每秒
- 輸出
- US$0.08 480p 每秒
- 輸出
- US$0.14 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-1.5-preview", "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}/contentGET /v1/videos/generations/{request_id}/content
查看工作狀態
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"其他內容讀取方式
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-1.5-preview
方法路徑別名
請使用上方列出的 API 方法路徑。
相關呼叫用 ID
FAQ · grok-imagine-video-1.5-preview
- 可以使用哪些輸入與結果？
POST /v1/videos/generations·grok-imagine-video-1.5-preview:text→video- 請求使用哪些欄位？
POST /v1/videos/generations·grok-imagine-video-1.5-preview:model,prompt,duration,seconds,resolution,aspect_ratio,size,image- 適用哪些限制？
POST /v1/videos/generations·grok-imagine-video-1.5-preview:duration.minimum:1;duration.maximum:15;seconds.minimum:1;seconds.maximum:15