列出影片任務

GET/v1/video/tasks

分頁列出透過 API 提交的任務（不含主控台工作坊提交的任務）。每個元素直接是任務物件，形狀與查詢影片任務相同。萬相 / 快樂馬沒有列表介面。

列出影片任務

curl "https://api.hop-base.com/v1/video/tasks?page=1&limit=20" \
  -H "Authorization: Bearer $HOPBASE_API_KEY"

200application/json

{
  "tasks": [
    {
      "id": "vtEXAMPLE",
      "model": "dreamina-seedance-2-5-260628",
      "status": "completed",
      "outputs": [
        "https://api.hop-base.com/example-signed-video.mp4"
      ],
      "created_at": "2026-09-23T08:00:00Z",
      "completed_at": "2026-09-23T08:03:10Z"
    }
  ],
  "total": 1,
  "totalPages": 1
}

請求標頭

Authorization:必填string

Bearer sk-…：主控台「API 金鑰」中建立的金鑰，所屬分組須包含請求的模型

查詢參數

page:選填integer

頁碼，從 1 開始

範圍≥ 1預設1

limit:選填integer

每頁條數

範圍1–100預設20

回傳

200任務列表

tasks:選填array of object

任務物件

total:選填integer

任務總數

totalPages:選填integer

總頁數

錯誤

401沒帶金鑰、金鑰無效或已過期（missing_api_key / invalid_api_key / api_key_expired）

請求標頭

查詢參數

回傳

錯誤

相關頁面