查詢影片

提交生成請求後，儲存回傳的任務 ID，並使用同一站點的 API Key 查詢。停止輪詢不會取消上游生成任務。

GET/v1/video/generations/{task_id}

使用平台建立API 回傳的任務 ID 查詢目前使用者的任務。停止用戶端輪詢不會取消生成任務。

授權

bearerAuth

授權Bearer <token>

使用平台 API Key：Authorization: Bearer your-api-key。

傳遞位置: header

路徑參數

task_id*string

建立API 回傳的系統任務 ID。新任務 ID 為字串，不能轉換為數字以免丟失精度。

長度1 <= length

回應主體

`application/json`

curl -X GET "https://api.agtcloud.cn/v1/video/generations/TASK_ID" \
  -H "Authorization: Bearer your-api-key"

{
  "code": "success",
  "message": "",
  "data": {
    "error": null,
    "format": "mp4",
    "metadata": null,
    "status": "processing",
    "task_id": "123456789012345678",
    "url": ""
  }
}

如何讀取查詢結果

平台查詢回傳 code/message/data 包裝，data 是單個任務物件。code: "success" 表示本次查詢成功，仍需檢視 data.status 判斷影片是否生成完成。

情況	回應含義與處理
HTTP 200，`data.status: "processing"`	任務仍在處理，`data.url` 可為空字串，可稍後繼續查詢
HTTP 200，`data.status: "succeeded"`	影片已生成，從 `data.url` 讀取網址並儘快儲存
HTTP 400，`code: "task_not_exist"`	未找到任務，檢查任務 ID、API Key 和所屬站點
HTTP 401，`Invalid token`	檢查 Bearer 驗證格式及 API Key 是否屬於請求站點；缺少和無效 Key 可能回傳相同錯誤

data.error 和 data.metadata 可能為 null。平台包裝不等同於原生查詢的 data[]；原生欄位與刊例價結構請參閱原生查詢API。

HTTP 400/401 是本次查詢請求的錯誤，不等同於任務生成失敗。錯誤回應可能沒有正常的任務物件；先處理錯誤，不要繼續讀取影片網址或持續輪詢。

授權

路徑參數

回應主體

200application/json

400application/json

401application/json

如何讀取查詢結果

`application/json`

`application/json`

`application/json`