跳轉到主要內容
POST
/
grok
/
v1
/
videos
/
generations
curl --request POST \
  --url https://api.cometapi.com/grok/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "A candle flickers on a wooden table."
}
'
{
  "request_id": "4b2cd27e-0b0d-3dec-c31c-7572daf74bb3"
}
使用這個端點可以從文字，或從文字加上一張來源圖片，啟動一個 Grok 影片任務。它會立即回傳 request_id，因此請將它視為非同步工作流程的第一步。

​
先從小型請求開始

  • 使用 model: grok-imagine-video
  • 若要做基本測試，請將 duration 保持為 1，並將 resolution 設為 480p
  • 只有在你想要進行圖片轉影片時才加入 image.url
  • 如果你傳送 base64，請將文件與 OpenAPI 範例格式保持為 data:image/png;base64,<BASE64_IMAGE_DATA>

​
任務流程

1

建立任務

傳送 prompt，並儲存回傳的 request_id。
2

輪詢完成狀態

呼叫 取得影片生成結果，直到巢狀 provider 狀態變為 done。
3

保存輸出

如果你需要在 provider 的暫時交付期限之後繼續使用最終結果，請將最終的 video.url 複製到你自己的儲存空間中。

​
CometAPI 上有哪些變化

xAI 將影片生成文件描述為兩步驟的啟動 -> 輪詢流程。CometAPI 保留相同的請求格式與相同的核心 model id，但你會使用 CometAPI key 進行驗證，並停留在 CometAPI 的 base URL 上。一個實際的 1 秒 480p 請求已於 2026-03-12 成功完成，並回傳了真實的結果 URL。

授權

​
Authorization
string
header
必填

Bearer token authentication. Use your CometAPI key.

主體

application/json
​
prompt
string
必填

Prompt for the video job.

範例:

"A candle flickers on a wooden table."

​
aspect_ratio
enum<string>

Output aspect ratio.

可用選項:
1:1,
16:9,
9:16,
4:3,
3:4,
3:2,
2:3
​
duration
integer
預設值:1

Output duration in seconds. xAI documents a range of 1 to 15 seconds.

​
image
object

Optional source image for image-to-video.

​
model
string
預設值:grok-imagine-video

xAI video model id.

範例:

"grok-imagine-video"

​
output
object
​
resolution
enum<string>

Output resolution.

可用選項:
480p,
720p
​
size
string

Deprecated size field. Prefer aspect_ratio and resolution.

​
user
string

Optional end-user identifier.

回應

200 - application/json

Request accepted.

​
request_id
string
必填

Deferred request id used for polling.