본문으로 건너뛰기
사용 문서

문서 검색

검색은 브라우저 안에서만 이루어지며 검색어를 전송하거나 저장하지 않습니다. 인증 정보를 입력하지 마세요.

검색 색인을 불러오는 중…

Tab 또는 방향키로 이동 · Enter로 열기 · Esc로 닫기
문서 탐색

동영상 업로드 완료

POST /video-uploads/{upload_id}/complete의 인증, 필드, 응답, 오류, 안전한 운영을 원본에서 생성한 레퍼런스입니다.

공개 베타API v1 · 1.5.0최종 확인
이 페이지의 내용

작업

POST /video-uploads/{upload_id}/complete

operationId: finish_video_upload_v1_video_uploads__upload_id__complete_post

업로드한 동영상을 검증하고 재사용 가능한 file_id와 길이·크기를 반환합니다. 반복 완료는 동일한 파일을 반환합니다.

인증 및 부수 효과

서버 측 Bearer API 키를 사용하세요. 필요한 권한: animations:write

유료 생성을 시작하지 않습니다. 다른 상태 변경은 위 설명을 확인하세요.

매개변수

매개변수 위치 유형 필수 제약 / 기본값 설명
upload_id path string 예 format: uuid Owned public resource UUID; task, asset, and file IDs are not interchangeable.

응답

HTTP 본문 설명
200 VideoFileResponse Successful public response. Example values are illustrative.
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 Idempotency conflict; only IDEMPOTENCY_IN_PROGRESS is retryable with the original request.
410 APIErrorEnvelope Upload session expired; prepare a new upload.
413 APIErrorEnvelope Request or decoded image exceeds the configured limit.
415 APIErrorEnvelope Use supported image media types.
422 APIErrorEnvelope Video metadata or size is invalid.
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 헤더 유형 설명
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.

응답 예제

json
{
  "byte_size": 1024,
  "duration_seconds": 5,
  "file_id": "00000000-0000-4000-8000-000000000001",
  "height": 768,
  "mime_type": "video/mp4",
  "object": "file",
  "sha256": "0000000000000000000000000000000000000000000000000000000000000000",
  "width": 768
}

관련 가이드

상태 조회 및 다운로드 · 오류 및 안전한 재시도

이 문서가 도움이 되었나요?

검색어, 코드 또는 자유 입력 텍스트는 수집하지 않습니다. 이 설정은 문서 상호작용 이벤트만 제어합니다. 개인정보 처리방침

도움이 필요하신가요? 지원팀 문의