저장된 영상으로 애니메이션 내보내기 재개
POST /animations/{animation_id}/retry-export의 인증, 필드, 응답, 오류, 안전한 운영을 원본에서 생성한 레퍼런스입니다.
이 페이지의 내용
작업
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는 필요하지 않습니다. HTTP 202이면 원래 애니메이션 ID로 상태를 계속 확인하세요. 취소·환불된 작업, 삭제된 원본 영상 및 다른 오류에는 사용할 수 없습니다.
인증 및 부수 효과
서버 측 Bearer API 키를 사용하세요. 필요한 권한: animations:write
유료 생성을 시작하지 않습니다. 다른 상태 변경은 위 설명을 확인하세요.
매개변수
| 매개변수 | 위치 | 유형 | 필수 | 제약 / 기본값 | 설명 |
|---|---|---|---|---|---|
animation_id |
path |
string |
예 | format: uuid |
Owned public resource UUID; task, asset, and file IDs are not interchangeable. |
응답
| HTTP | 본문 | 설명 |
|---|---|---|
200 |
TaskResponse | Current terminal animation result; inspect status and error. |
202 |
TaskResponse | Export resumed; poll the original animation ID. No additional generation or charge. |
400 |
APIErrorEnvelope | Invalid input; correct the request before retrying. |
401 |
APIErrorEnvelope | Missing, expired, or revoked API key. |
403 |
APIErrorEnvelope | Account eligibility, account status, or key scope does not allow this operation. |
404 |
APIErrorEnvelope | Resource is unavailable, not owned, or its signature is invalid/expired. |
409 |
APIErrorEnvelope | This animation cannot resume its export. |
413 |
APIErrorEnvelope | Request or decoded image exceeds the configured limit. |
429 |
APIErrorEnvelope | Account-wide rate or queue limit; wait for Retry-After. |
500 |
APIErrorEnvelope | Internal failure; preserve the task/key and retry only when marked retryable. |
503 |
APIErrorEnvelope | Service/provider unavailable; retry only when error.retryable is true. |
응답 헤더
| HTTP | 헤더 | 유형 | 설명 |
|---|---|---|---|
200 |
Retry-After |
integer |
Suggested wait in seconds; respect the server value and an overall deadline. |
202 |
Retry-After |
integer |
Suggested wait in seconds; respect the server value and an overall deadline. |
429 |
Retry-After |
integer |
Suggested wait in seconds; respect the server value and an overall deadline. |
503 |
Retry-After |
integer |
Suggested wait in seconds; respect the server value and an overall deadline. |
응답 예제
{
"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"
}
관련 가이드
이 문서가 도움이 되었나요?
검색어, 코드 또는 자유 입력 텍스트는 수집하지 않습니다. 이 설정은 문서 상호작용 이벤트만 제어합니다. 개인정보 처리방침