API 문서 · 안정성

결과 보관

서명 URL 유효 기간과 결과 보관 기간.

result.video_url은 유효 기간이 짧은 서명 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
}