跳至本文
使用文件

搜尋文件

搜尋僅在此瀏覽器進行,關鍵字不會傳送或儲存。請勿輸入憑證。

正在載入搜尋索引…

Tab 或方向鍵移動 · Enter 開啟 · Esc 關閉
瀏覽文件

複用影片續導動畫

從原始碼生成 POST /animations/{animation_id}/retry-export 的鑑權、欄位、響應、錯誤與安全呼叫參考。

公開測試API v1 · 1.5.0最後核實
本頁目錄

操作

POST /animations/{animation_id}/retry-export

operationId: retry_one_click_animation_export_v1_animations__animation_id__retry_export_post

續導因儲存配額阻擋、但已保留生成影片的所屬動畫。先清理空間或升級,按 error.details.recovery 提示呼叫。複用原影片和固定匯出 ID,不重新生成或扣費;重複呼叫返回同一次匯出,無需請求體或 Idempotency-Key。202 表示匯出中,繼續輪詢原動畫 ID。已取消、已退款、源影片已刪除或其他失敗不可使用。

鑑權與副作用

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

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

引數

引數 位置 型別 必填 約束 / 預設值 含義
animation_id path string 是 format: uuid 所屬公共資源 UUID;任務、資產、檔案 ID 不能互換。

響應

HTTP 正文 含義
200 TaskResponse 當前動畫終態結果,須檢查 status 和 error。
202 TaskResponse 已恢復匯出,輪詢原動畫 ID;不重新生成或扣費。
400 APIErrorEnvelope 輸入錯誤,修正請求後再嘗試。
401 APIErrorEnvelope API Key 缺失、到期或被撤銷。
403 APIErrorEnvelope 帳戶資格、帳戶狀態或 Key 權限不允許此操作。
404 APIErrorEnvelope 資源不可用、不屬於當前使用者,或簽名無效/過期。
409 APIErrorEnvelope 此動畫當前不允許續導。
413 APIErrorEnvelope 請求或解碼後的圖片超過配置限制。
429 APIErrorEnvelope 觸發帳戶級速率或佇列限制,遵循 Retry-After 等待。
500 APIErrorEnvelope 內部錯誤,保留任務 ID 和冪等鍵,僅標記可重試時重試。
503 APIErrorEnvelope 服務或供應商不可用,僅 error.retryable 為 true 時重試。

響應頭

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

響應示例

json
{
  "created_at": "2026-08-30T00:00:00Z",
  "credits": {
    "charged": 1,
    "held": 0,
    "quoted": 1
  },
  "error": null,
  "finished_at": "2026-08-30T00:00:00Z",
  "id": "00000000-0000-4000-8000-000000000002",
  "metadata": {},
  "normalized_input": {},
  "object": "animation",
  "outputs": [
    {
      "byte_size": 1024,
      "created_at": "2026-08-30T00:00:00Z",
      "download_expires_at": "2026-08-30T01:00:00Z",
      "download_url": "https://downloads.example.invalid/illustrative-asset",
      "format": "clip_video",
      "id": "00000000-0000-4000-8000-000000000003",
      "media": {
        "duration_seconds": 5.04,
        "fps": 25,
        "frame_count": 126,
        "height": 512,
        "width": 512
      },
      "mime_type": "video/mp4",
      "object": "asset"
    },
    {
      "byte_size": 1024,
      "created_at": "2026-08-30T00:00:00Z",
      "download_expires_at": "2026-08-30T01:00:00Z",
      "download_url": "https://downloads.example.invalid/illustrative-export",
      "format": "frames_zip",
      "id": "00000000-0000-4000-8000-000000000006",
      "mime_type": "application/zip",
      "object": "asset"
    }
  ],
  "progress": 1,
  "stage": "completed",
  "started_at": null,
  "status": "succeeded"
}

相關教程

輪詢與下載 · 錯誤與安全重試

這篇文件有幫助嗎?

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

需要協助?聯絡支援