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

문서 검색

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

검색 색인을 불러오는 중…

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

동영상 업로드 준비

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

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

작업

POST /video-uploads

operationId: create_video_upload_v1_video_uploads_post

최대 100 MiB, 30초의 비공개 MP4/MOV/WebM 업로드를 준비합니다. 바이트 전송 후 완료하세요. 깊이 처리나 생성은 시작하지 않습니다.

인증 및 부수 효과

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

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

매개변수

경로·쿼리·작업별 헤더 매개변수가 없습니다.

요청 본문 (application/json)

본문 필수: true

필드 유형 필수 기본값 제약 설명
byte_size integer 예 — maximum: 104857600; exclusiveMinimum: 0 Exact byte count, at most 100 MiB. The source must be 2–30 seconds.
filename string 예 — minLength: 1; maxLength: 240 Client filename, not a readable server path.
mime_type string 예 — enum: "video/mp4", "video/quicktime", "video/webm" Actual MP4, MOV or WebM media type.

전체 중첩 스키마: VideoUploadRequest

응답

HTTP 본문 설명
201 VideoUploadSession 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
{
  "expires_at": "2026-08-30T00:00:00Z",
  "headers": {
    "Content-Type": "video/mp4",
    "X-AnimGen-Upload-Token": "illustrative-only"
  },
  "max_bytes": 104857600,
  "method": "PUT",
  "upload_id": "00000000-0000-4000-8000-000000000001",
  "upload_url": "https://uploads.example.invalid/illustrative-video"
}

관련 가이드

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

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

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

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