列出動畫匯出任務
從原始碼生成 GET /animation-exports 的鑑權、欄位、響應、錯誤與安全呼叫參考。
本頁目錄
操作
GET /animation-exports
operationId: list_animation_exports_v1_animation_exports_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 |
建議等待秒數,遵循服務值並設定總體截止時間。 |
響應示例
{
"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": "animation_export",
"outputs": [],
"progress": 0,
"stage": "queued",
"started_at": null,
"status": "queued"
}
],
"next_cursor": null,
"object": "list"
}
相關教程
這篇文件有幫助嗎?
不收集搜尋字詞、程式碼或自由文字。此開關僅控制文件互動事件。 隱私權政策