跳到主要內容

API 文件 · 可靠性

結果保留

簽章網址有效期限與結果保留期限。

  • result.video_url 是短期有效的簽章網址(最長 1 小時,且不晚於 retained_until),於 url_expires_at 失效。過期後重新查詢任務即可取得新網址。
  • 帳號設定為回傳上游原始連結時,video_url 是上游網址,於生成完成 24 小時後失效,之後查詢會改為回傳平台網址。
  • 結果檔案保留至 retained_until(預設為生成後 7 天)。過期後 result_expired 為 true,將無法再下載,請及時轉存到你自己的儲存空間。
  • 上傳的素材會長期保存,直到你刪除為止;刪除後無法復原。
  • 任務紀錄與額度明細會長期保留,供對帳使用;呼叫記錄保留 90 天。
任務結果
{
  "id": "task_xxx",
  "status": "succeeded",
  "result": {
    "video_url": "https://<cdn>/results/...?sig=...",
    "url_expires_at": "2026-10-30T05:00:00Z",
    "retained_until": "2026-11-06T03:10:00Z",
    "last_frame_url": null
  },
  "result_expired": false
}