Source: https://ailoot.ai/models/zh-hant-tw/grok-imagine-video/ Canonical: https://ailoot.ai/models/zh-hant-tw/grok-imagine-video/ Language: zh-hant-tw # grok-imagine-video [Markdown](https://ailoot.ai/models/zh-hant-tw/grok-imagine-video/index.md) · [JSON](https://ailoot.ai/models/zh-hant-tw/grok-imagine-video/facts.json) ## [grok-imagine-video](https://ailoot.ai/models/zh-hant-tw/grok-imagine-video/) Grok Imagine Video 可依文字描述生成短片，並選擇片長及畫面比例。xAI 的模型本身也支援將圖片動畫化，以及依指示編輯影片。 - [**Ailoot · 影片** `POST /v1/videos/generations` `grok-imagine-video`](https://ailoot.ai/models/zh-hant-tw/grok-imagine-video/#method-0) 關於模型 此說明介紹模型的能力。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`](https://ailoot.ai/models/zh-hant-tw/#m=grok-imagine-video&route=Core&caller=grok-imagine-video&fmt=videos) 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 方法費率 輸入 US$0.002 *每張輸入圖片* 輸入 US$0.01 *每秒輸入影片* 輸出 US$0.05 *480p 每秒* 輸出 US$0.07 *720p 每秒* Ailoot 會在請求前預留估算金額。取得結果後，依實測用量結算最終費用。串流結算採用最終用量紀錄。[預留金額與結算的運作方式 →](https://ailoot.ai/docs/zh-hant-tw/billing/reserve/) ### 請求範例 #### Ailoot · 影片 影片範例 ```bash 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 · 取得狀態 ```bash 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 · 取得內容 ```bash 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`](https://ailoot.ai/models/zh-hant-tw/#m=grok-imagine-video&route=Core&caller=grok-imagine-video&fmt=videos) #### 方法路徑別名 請使用上方列出的 API 方法路徑。 #### 相關呼叫用 ID [`grok-imagine-video`](https://ailoot.ai/models/zh-hant-tw/#m=grok-imagine-video&route=Core&caller=grok-imagine-video&fmt=videos) FAQ · grok-imagine-video 可以使用哪些輸入與結果？ `POST /v1/videos/generations` · `grok-imagine-video`: `text` → `video` 請求使用哪些欄位？ `POST /v1/videos/generations` · `grok-imagine-video`: `model`, `prompt`, `duration`, `seconds`, `resolution`, `aspect_ratio`, `size`, `image` 適用哪些限制？ `POST /v1/videos/generations` · `grok-imagine-video`: `duration.minimum`: `1`; `duration.maximum`: `15`; `seconds.minimum`: `1`; `seconds.maximum`: `15` 將 Ailoot 串接 Claude Code、OpenCode、Hermes 或自己的應用程式。 ## 公司及其專案組合 公司及其專案組合：數百萬客戶，每月銷售額達數十億。 ## 優惠購買 token。 訂閱優惠適合持續工作，折扣碼購買 token 最高可折 50%。 訂閱 為定期請求選擇優惠方案。 最高 50% 折扣碼 購買時輸入代碼，價格依活動重算。 歷史中的費用 每次請求保存模型、token 與金額。 [選擇訂閱](https://ailoot.ai/docs/zh-hant-tw/billing/subscriptions/) · [查看模型價格](https://ailoot.ai/models/zh-hant-tw/) ## 將 API 加入 你銷售的產品。 依 Ailoot 正式服務條款與授權合約串接 SaaS、應用程式與機器人；轉售請申請經銷授權。 商用應用程式 在付費功能加入文字、圖片、影片與聲音生成。 經銷授權 提供專案說明與存取方式，要求書面使用和轉售條件。 網站文件 串接前可閱讀正式服務條款、授權合約與資料處理政策。 [申請經銷授權](mailto:support@ailoot.ai) · [正式服務條款與授權合約](https://ailoot.ai/legal/offer?lang=zh-hant-tw) ## Ailoot · 公司及其專案組合 Ailoot以累積的營運經驗、廣大的客戶群、穩定的服務及持續的KPI管理為基礎。 公司及其專案組合：數百萬客戶，每月銷售額達數十億。 Ailoot將這些營運經驗用於API存取，讓客戶的產品、代理、應用程式及自動化流程使用AI功能。