跳轉到主要內容

概述

Grok Imagine 影片是 xAI 影片生成模型的官方通道:請求經 API易 轉發到 xAI 官方 API,價格與 xAI 官網一致,按生成秒數與解析度計費。介面是 OpenAI Videos 相容的非同步任務式端點(/v1/videos),支援文生影片和圖生影片,生成的影片自帶音軌。 本通道提供三個型號:
  • grok-imagine-video:基礎款,480p / 720p
  • grok-imagine-video-1.5:新一代,480p / 720p / 1080p
  • grok-imagine-video-1.5-lite:1.5 輕量版,480p / 720p 單價最低
🔒 本通道需申請開通 GrokOfficial 分組Grok Imagine 影片不在 Default 預設分組。該系列的內容安全策略與平臺其它模型差異較大,為避免合規風險我們採取定向開放:
  • 累計消費滿 $1,000 的存量客戶:聯絡客服說明用途,核驗後開通
  • 其他客戶:通過企業微信客服提交申請,說明使用場景與內容管控措施,稽核通過後為你單獨開通
令牌分組不含 GrokOfficial 時呼叫會返回 503,這是權限問題、不是服務故障。詳見下方 分組介紹。
⚠️ 不傳 size 預設是 480p、8 秒提交時如果不指定解析度和時長,會按 480p、8 秒生成並計費。需要 720p / 1080p 或更短的片子,請顯式傳 size(如 "1280x720")和 seconds。

影片生成 API

文生影片 / 圖生影片提交介面,帶互動式 Playground。

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 拿到本頁純文本版; …

  1. 模型名三選一:grok-imagine-video、grok-imagine-video-1.5、grok-imagine-video-1.5-lite …

共 8 條接入要求,點下方按鈕複製完整版

模型與定價

價格與 xAI 官網一致,按生成影片的秒數計費,單價由模型與解析度決定:
模型價格與官網對齊,且可能隨官網調整;上表僅供參考,具體以頂部導航「模型價格」欄目為準:模型價格。
計費說明與算例
  • 費用 = 秒數 × 解析度單價 + 輸入圖張數 × 輸入圖單價。例:grok-imagine-video 480p 生成 1 秒圖生影片 = 1 × $0.05 + 1 × $0.002 = $0.052(實測賬單一致)。
  • 預設值也計費:不傳 size / seconds 時按 480p、8 秒生成,grok-imagine-video 即 $0.40 一條。
  • 音訊不單獨計費:成片預設帶音軌,關閉音訊不降價。
  • 稽核攔截照常計費:被 xAI 內容稽核攔截的影片,xAI 照樣收費,我們按同樣口徑計費,詳見 常見問題。
  • 可疊加 充值階梯加贈;用量較大的企業客戶可聯絡商務溝通專屬價格。

分組介紹

Grok Imagine 影片不在 Default 預設分組。 本通道放在 GrokOfficial 專屬分組(與官網同價,即上方定價表),與 Grok Imagine 官轉生圖 共用一個分組,需申請開通後才能呼叫。

誰可以開通

怎麼申請

1

聯絡企業微信客服

通過企業微信客服提交申請,也可發郵件到 [email protected]。註明申請的是 GrokOfficial(Grok Imagine 官轉)。
2

說明使用場景與內容管控措施

請寫清楚三件事:影片用於什麼業務、面向什麼終端使用者、你這一側有哪些內容稽核與人工複核措施。資訊越具體,稽核越快。
3

開通後切換令牌分組

稽核通過後我們為你的賬號開通 GrokOfficial 分組。請到控制台令牌頁把呼叫本通道的令牌分組切到 GrokOfficial,計費模式選 按量優先 或 按量計費。
未開通時的表現:令牌分組不含 GrokOfficial 時呼叫返回 503(當前分組無可用渠道),重試無效,需要先完成開通。令牌「計費模式」不要選 按次計費:本通道按秒計費,按次計費的令牌路由不到,同樣會返回 503。
合規提醒:開通後生成內容的合規責任在呼叫方。請遵守當地法律法規,不得用於生成違法內容、侵犯他人肖像權與智慧財產權的內容,或面向未成年人的不當內容;面向 C 端分發的場景建議在你這一側再加一層稽核。相關背景見 國內產品呼叫海外模型的合規要點。發現濫用我們會收回該分組權限。

技術規格

端點一覽

主域名 https://api.apiyi.com,備用域名 https://b.apiyi.com。完整程式碼示例見 影片生成 API。

完整流程(Python)

關鍵引數詳解

size(解析度與寬高比)

size 用 寬x高 的畫素寫法,閘道按短邊換算解析度檔,按寬高比取最接近的一檔: 也可以直接傳 "480p" / "720p" / "1080p",或者不用 size、改傳 xAI 原生欄位 resolution(480p / 720p / 1080p)加 aspect_ratio(如 9:16),兩者同時傳時以 resolution / aspect_ratio 為準。都不傳時按 480p 生成。
grok-imagine-video 只支援 480p / 720p,傳 1080p 級別的 size 會返回 400:grok-imagine-video resolution must be one of 480p, 720p。

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

先用 1–2 秒、480p 試提示詞

費用按秒計,先用短時長低解析度確認畫面方向,再出 720p / 1080p 的正式長度。grok-imagine-video-1.5-lite 的 480p / 720p 單價最低,適合批次試錯。
2

每次都顯式傳 size 和 seconds

不傳會按 480p、8 秒生成並計費,最常見的「怎麼這麼貴」「怎麼這麼糊」都來自漏傳。
3

輪詢間隔 5–10 秒,設總超時

任務一般在 20 秒到 2 分鐘內完成。輪詢過密沒有收益,建議總時長上限 10 分鐘,超時後記錄任務 ID 便於排查。
4

處理稽核攔截

檢查查詢結果裡的 error.code:moderation_blocked 表示被攔截、沒有成片但已計費。換個表述再提交,不要原樣重試。
5

成片立即轉存

completed 後立即用 /content 下載到自己的儲存,不要把下載連結長期儲存或直接給終端使用者。

錯誤碼與重試

常見問題

基本是權限問題:令牌分組不含 GrokOfficial,或令牌計費模式是「按次計費」。前者按 分組介紹 申請開通;後者把計費模式改成 按量優先 或 按量計費 即可。
這是預設值:提交時沒有傳 size 和 seconds,就按 480p、8 秒生成並計費。請顯式傳 size(如 "1280x720")和 seconds。
先看查詢結果裡有沒有 error.code: "moderation_blocked"。有的話說明這條影片被 xAI 的內容稽核攔截了:任務狀態仍是 completed,但沒有成片,並且照常計費(xAI 對被攔截的影片同樣收費)。請調整提示詞或輸入圖後重新提交。
不能。成片預設帶音軌,按 xAI 官方口徑,關閉音訊不降價。
圖生影片的輸出畫幅跟隨輸入圖。需要特定比例,請先把輸入圖裁成目標比例再提交。
本通道當前對外開放的是文生影片與單張輸入圖的圖生影片。影片編輯、影片延長等能力暫未開放,開放後會在本頁更新。
  • 要 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

相關文件