查詢影片任務

輪詢單個影片（及可靈、Midjourney 生圖）任務的狀態與結果位址。

GET/v1/video/tasks/{task_id}

用提交時回傳的任務 ID 輪詢，建議每 5 秒一次；輪詢不佔並行、不計費。Seedance / Grok 回應用 task 包裝，MiniMax / 可靈是頂層欄位——不要讀錯層級。

Seedance 任務建立超過 24 小時仍未結束會被自動判為失敗（不計費），task.error.message 為 The task did not finish within 24 hours and was terminated automatically。結果位址是 api.hop-base.com 下的簽名位址，再次查詢回傳同一位址、不會續期：Seedance 與 Grok 30 天，可靈、MiniMax 6 小時，請在有效期內下載儲存。未完成的任務 24 小時（Seedance）或 2 小時（可靈、MiniMax）後判失敗。

查詢影片任務

curl https://api.hop-base.com/v1/video/tasks/vtEXAMPLE \
  -H "Authorization: Bearer $HOPBASE_API_KEY"

200application/json

{
  "task": {
    "id": "vtEXAMPLE",
    "model": "dreamina-seedance-2-5-260628",
    "status": "completed",
    "duration_seconds": 5,
    "outputs": [
      "https://api.hop-base.com/example-signed-video.mp4"
    ],
    "last_frame_url": "https://api.hop-base.com/example-signed-last-frame.jpg",
    "usage": {
      "completion_tokens": 1000,
      "total_tokens": 1000
    },
    "error": null,
    "created_at": "2026-09-23T08:00:00Z",
    "completed_at": "2026-09-23T08:03:10Z"
  },
  "usage": {
    "cost": 3.4,
    "currency": "CNY",
    "cost_cny": 3.4,
    "cost_usd": 0.5
  }
}

請求標頭

Authorization:必填string

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

路徑參數

task_id:必填string

提交回傳的任務 ID：vt…（Seedance / Grok）、mmt…（MiniMax）、kt…（可靈）

回傳

200任務物件（含失敗任務）

系列

task:選填object

任務

usage:選填object

任務結束後才有，且只對建立任務的金鑰回傳。0 表示失敗且未扣費

錯誤

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

404任務不存在或不屬於這把金鑰

請求標頭

路徑參數

回傳

錯誤

相關頁面