取得影片生成結果

使用 GET /grok/v1/videos/ 輪詢 xAI 影片生成狀態，並在處理完成後取得最終影片 URL。

GET /grok/v1/videos/{request_id}

Query an xAI video job

cURL

curl --request GET \
  --url https://api.cometapi.com/grok/v1/videos/{request_id} \
  --header 'Authorization: Bearer <token>'

200

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "4b2cd27e-0b0d-3dec-c31c-7572daf74bb3",
    "action": "VIDEO_GENERATION",
    "status": "SUCCESS",
    "fail_reason": "https://vidgen.x.ai/xai-vidgen-bucket/xai-video-72924fdc-e6d7-4885-b318-8a367aaa9a02.mp4",
    "submit_time": 1773297002,
    "start_time": 0,
    "finish_time": 1773297014,
    "progress": "100%",
    "data": {
      "model": "grok-imagine-video",
      "usage": {
        "cost_in_usd_ticks": 500000000
      },
      "video": {
        "url": "https://vidgen.x.ai/xai-vidgen-bucket/xai-video-72924fdc-e6d7-4885-b318-8a367aaa9a02.mp4",
        "duration": 1,
        "respect_moderation": true
      },
      "status": "done"
    }
  }
}

在你已經擁有 request_id 之後，請使用這個端點。它會告訴你 xAI 工作是否仍在執行，並在就緒時回傳最終影片中繼資料。

​

先檢查這些欄位

• 外層包裝的 code 與 message，用於頂層錯誤
• data.status，用於 CometAPI 任務狀態
• data.data.status，用於巢狀供應商狀態
• 當渲染完成時，檢查 data.data.video.url

​

輪詢迴圈

1. 先建立或編輯影片

   先從 影片生成 或 影片編輯 開始，然後複製回傳的 request_id。

2. 持續輪詢，直到巢狀狀態顯示完成

   同時檢查外層包裝與巢狀供應商欄位，這樣你就能區分外層失敗與供應商層級失敗。

3. 保存完成的檔案

   請儘快下載或複製最終的 video.url，因為 xAI 文件指出生成的 URL 為暫時性。

​

在 CometAPI 上可以預期什麼

這仍然是 xAI 在其官方流程中描述的相同輪詢步驟。CometAPI 會在供應商 payload 外層加上一層包裝，讓你能在不同供應商之間更一致地處理非同步工作。

授權

Authorization · string · header · 必填

Bearer token authentication. Use your CometAPI key.

路徑參數

request_id · string · 必填

Deferred request id returned by the create or edit endpoint.

回應

200 - application/json

Current task state.

code · string · 必填

message · string · 必填

data · object · 必填

Show child attributes