Skip to main content
Grok Tasks API 的主要功能是通過輸入 Grok Videos Generation API 生成的任務 ID 來查詢該任務的執行情況。 本文檔將詳細介紹 Grok Tasks API 的對接說明，幫助您輕鬆集成並查詢 Grok Videos Generation API 的任務執行情況。

​
申請流程

要使用 Grok Videos Generation API，首先到 Ace Data Cloud 控制台 獲取您的 API Token，留作備用。 如果你尚未登錄或註冊，會自動跳轉到登錄頁面邀請你註冊和登錄，完成後會自動返回當前頁面。 一個 API Token 即可調用平台所有服務，無需為每個服務單獨申請。 首次申請會贈送免費額度，可免費體驗；額度不足時可在 控制台 充值通用餘額。
📘 完整文檔：Grok Videos Generation API →

​
請求示例

Grok Tasks API 可以用於查詢 Grok Videos Generation API 的結果。

​
設置請求頭和請求體

Request Headers 包括：
  • accept：指定接收 JSON 格式的響應結果，這裡填寫為 application/json。
  • authorization：調用 API 的密鑰，申請之後可以直接下拉選擇。
Request Body 包括：
  • id：要查詢的任務 ID。
  • action：對任務的操作方式，單個查詢填寫 retrieve。

​
CURL 代碼示例

​
響應示例

請求成功後，API 將返回此處任務的詳細信息。其中 request 字段是發起任務時的 request body，response 字段是任務完成後返回的 response body，例如：
字段介紹如下：
  • id：生成任務的 ID，用於唯一標識此次生成任務。
  • request：查詢任務中的請求信息。
  • response：查詢任務中的返回信息。
  • created_at：任務創建時間，Unix 時間戳（秒，浮點）。
  • started_at：任務開始執行時間，Unix 時間戳（秒，浮點）。
  • finished_at：任務完成時間，Unix 時間戳（秒，浮點）。任務未完成時不返回該字段。
  • elapsed：任務執行耗時，單位為秒（浮點，保留 3 位小數）。任務未完成時不返回該字段。

​
批量查詢操作

針對多個任務 ID 查詢任務詳細時，將 action 設置為 retrieve_batch，並通過 ids 傳入任務 ID 陣列： Request Body 包括：
  • ids：要查詢的任務 ID 陣列。
  • action：對任務的操作方式，批量查詢填寫 retrieve_batch。