列出影片生成任務

從原始碼生成 GET /video-generations 的鑑權、欄位、響應、錯誤與安全呼叫參考。

公開測試API v1 · 1.4.0最後核實 2026-09-15

本頁目錄

操作

GET /video-generations

operationId: list_video_generations_v1_video_generations_get

列出當前帳戶所屬任務。將 next_cursor 原樣傳回獲取下一頁，null 表示結束。併發及限流預算按帳戶共享，不按 Key 獨立計算。

鑑權與副作用

使用可信環境中的 Bearer API Key。所需權限：animations:read

此操作不啟動付費生成，其他狀態變化見上文說明。

引數

引數	位置	型別	必填	約束 / 預設值	含義
`limit`	`query`	`integer`	否	`minimum`: `1`; `maximum`: `100`; default: `20`	本頁最多記錄數，不是帳戶併發上限。
`cursor`	`query`	`string` / `null`	否	—	上一頁返回的不透明 next_cursor，原樣傳回。

響應

HTTP	正文	含義
`200`	TaskListResponse	成功的公開響應，示例數值僅用於說明。
`400`	APIErrorEnvelope	輸入錯誤，修正請求後再嘗試。
`401`	APIErrorEnvelope	API Key 缺失、到期或被撤銷。
`403`	APIErrorEnvelope	帳戶資格、帳戶狀態或 Key 權限不允許此操作。
`404`	APIErrorEnvelope	資源不可用、不屬於當前使用者，或簽名無效/過期。
`429`	APIErrorEnvelope	觸發帳戶級速率或佇列限制，遵循 Retry-After 等待。
`500`	APIErrorEnvelope	內部錯誤，保留任務 ID 和冪等鍵，僅標記可重試時重試。
`503`	APIErrorEnvelope	服務或供應商不可用，僅 error.retryable 為 true 時重試。

響應頭

HTTP	響應頭	型別	含義
`429`	`Retry-After`	`integer`	建議等待秒數，遵循服務值並設定總體截止時間。
`503`	`Retry-After`	`integer`	建議等待秒數，遵循服務值並設定總體截止時間。

響應示例

json

{
  "data": [
    {
      "created_at": "2026-08-30T00:00:00Z",
      "credits": {
        "charged": 0,
        "held": 1,
        "quoted": 1
      },
      "error": null,
      "finished_at": null,
      "id": "00000000-0000-4000-8000-000000000002",
      "metadata": {},
      "normalized_input": {},
      "object": "video_generation",
      "outputs": [],
      "progress": 0,
      "stage": "queued",
      "started_at": null,
      "status": "queued"
    }
  ],
  "next_cursor": null,
  "object": "list"
}

這篇文件有幫助嗎？

允許文件互動分析

不收集搜尋字詞、程式碼或自由文字。此開關僅控制文件互動事件。隱私權政策

需要協助？聯絡支援

搜尋文件

列出影片生成任務

操作

鑑權與副作用

引數

響應

響應頭

響應示例

相關教程

這篇文件有幫助嗎？