概述
Grok Imagine 影片是 xAI 影片生成模型的官方通道:請求經 API易 轉發到 xAI 官方 API,價格與 xAI 官網一致,按生成秒數與解析度計費。介面是 OpenAI Videos 相容的非同步任務式端點(/v1/videos),支援文生影片和圖生影片,生成的影片自帶音軌。
本通道提供三個型號:
grok-imagine-video:基礎款,480p / 720pgrok-imagine-video-1.5:新一代,480p / 720p / 1080pgrok-imagine-video-1.5-lite:1.5 輕量版,480p / 720p 單價最低
影片生成 API
Grok Imagine 官轉生圖
GrokOfficial 分組,與官網同價按檔計費的圖片生成。讓 AI Agent 幫你接入
複製這段提示詞,貼上給 Codex / Claude Code / Cursor
它會先抓本頁的純文本版(任意文件頁地址後加 .md),再按你專案的技術棧寫程式碼——非同步三步流程、預設 480p 8 秒、稽核攔截照常計費、成片立即轉存這幾個高頻坑已經寫死在要求裡。
幫我在當前專案裡接入 / 排查 Grok Imagine 影片生成(文生影片 + 圖生影片)。
先讀文件再動手:抓 https://docs.apiyi.com/api-capabilities/grok-imagine-video/overview.md 拿到本頁純文本版; …
- 模型名三選一:
grok-imagine-video、grok-imagine-video-1.5、grok-imagine-video-1.5-lite…
共 8 條接入要求,點下方按鈕複製完整版
模型與定價
價格與 xAI 官網一致,按生成影片的秒數計費,單價由模型與解析度決定:分組介紹
誰可以開通
怎麼申請
聯絡企業微信客服
GrokOfficial(Grok Imagine 官轉)。說明使用場景與內容管控措施
開通後切換令牌分組
GrokOfficial 分組。請到控制台令牌頁把呼叫本通道的令牌分組切到 GrokOfficial,計費模式選 按量優先 或 按量計費。GrokOfficial 時呼叫返回 503(當前分組無可用渠道),重試無效,需要先完成開通。令牌「計費模式」不要選 按次計費:本通道按秒計費,按次計費的令牌路由不到,同樣會返回 503。技術規格
端點一覽
完整流程(Python)
關鍵引數詳解
size(解析度與寬高比)
size 用 寬x高 的畫素寫法,閘道按短邊換算解析度檔,按寬高比取最接近的一檔:
"480p" / "720p" / "1080p",或者不用 size、改傳 xAI 原生欄位 resolution(480p / 720p / 1080p)加 aspect_ratio(如 9:16),兩者同時傳時以 resolution / aspect_ratio 為準。都不傳時按 480p 生成。
seconds(時長)
取值 1–15 的整數,字串("5")或數字(5)都可以,預設 8 秒。超出範圍返回 400:duration must be an integer between 1 and 15。費用與秒數成正比,測試階段建議用 1–2 秒。
input_reference(圖生影片)
傳一張輸入圖即可轉為圖生影片,三種寫法任選:
- 公網圖片 URL:
"input_reference": "https://example.com/first-frame.jpg" - base64 Data URI:
"input_reference": "data:image/jpeg;base64,/9j/4AAQ..." - multipart 上傳檔案:
-F "[email protected]"
prompt 用來描述動作與鏡頭(如「貓慢慢轉過頭」),輸出畫幅跟隨輸入圖。每張輸入圖另收 $0.002(grok-imagine-video)或 $0.01(1.5 / 1.5-lite)。
最佳實踐
先用 1–2 秒、480p 試提示詞
grok-imagine-video-1.5-lite 的 480p / 720p 單價最低,適合批次試錯。每次都顯式傳 size 和 seconds
輪詢間隔 5–10 秒,設總超時
處理稽核攔截
error.code:moderation_blocked 表示被攔截、沒有成片但已計費。換個表述再提交,不要原樣重試。成片立即轉存
completed 後立即用 /content 下載到自己的儲存,不要把下載連結長期儲存或直接給終端使用者。錯誤碼與重試
常見問題
呼叫一直返回 503,是渠道掛了嗎?
呼叫一直返回 503,是渠道掛了嗎?
GrokOfficial,或令牌計費模式是「按次計費」。前者按 分組介紹 申請開通;後者把計費模式改成 按量優先 或 按量計費 即可。為什麼我生成的影片是 480p、8 秒?
為什麼我生成的影片是 480p、8 秒?
size 和 seconds,就按 480p、8 秒生成並計費。請顯式傳 size(如 "1280x720")和 seconds。任務顯示 completed,但下載不到影片?
任務顯示 completed,但下載不到影片?
error.code: "moderation_blocked"。有的話說明這條影片被 xAI 的內容稽核攔截了:任務狀態仍是 completed,但沒有成片,並且照常計費(xAI 對被攔截的影片同樣收費)。請調整提示詞或輸入圖後重新提交。關掉音訊能便宜嗎?
關掉音訊能便宜嗎?
圖生影片的輸出比例為什麼和我傳的 size 不一樣?
圖生影片的輸出比例為什麼和我傳的 size 不一樣?
支援影片編輯、影片延長、多張參考圖嗎?
支援影片編輯、影片延長、多張參考圖嗎?
三個型號怎麼選?
三個型號怎麼選?
- 要 1080p →
grok-imagine-video-1.5(畫質最好)或grok-imagine-video-1.5-lite(更便宜) - 批量出 480p / 720p、控制成本 →
grok-imagine-video-1.5-lite($0.02 / $0.03 每秒) - 已在用基礎款、只需 480p / 720p →
grok-imagine-video
相關文件
- Grok Imagine 影片生成 API - 帶 Playground 的提交介面參考
- Grok Imagine 官轉生圖 - 同一分組,與官網同價按檔計費
- Grok 系列模型呼叫指南 - xAI 文本模型
- 充值加贈活動