자막 파일 업로드

업로드 토큰을 이용하여, 동영상 자막 파일의 업로드를 실행합니다.

multipart/form data를 이용한 업로드 방식입니다.

한개의 동영상에 언어 구분에 따라 여러개의 자막 업로드가 가능합니다.
언어 구분은 자막 언어 코드 조회 API 를 이용하여 ID를 조회할 수 있습니다.

자막 파일 형식은 HTML5 플레이어에서의 자막 사용을 위해 WebVTT(.vtt 확장자 파일)만 지원합니다.
WebVTT 형식의 자막을 등록 시 Mobile Player에서도 자막을 이용할 수 있습니다.

브라우저에 따라 WebVTT에서 정의된 위치 지정 또는 스타일 지정 속성 중 일부가 지원되지 않을 수 있습니다.

자막 파일 변경

자막 파일 업로드 시 access_keylang_id, caption_type이 동일한 기존 파일이 이미 존재하는 경우에는 신규 업로드 파일로 교체됩니다.

Request URL

{captionUploadUrl}?token={token}&access_key={access_key}&lang_id={lang_id}

Request Parameters

Parameter NameTypeDescription
token (Required)String업로드 토큰 API에서 조회한 토큰 값
access_key (Required)String자막과 매칭 할 동영상의 원본 키 (Original Key – Video Access Key_Level 1)
captionfile (Required)File
(multipart/form)
업로드 할 자막 파일 데이터
lang_idInteger언어 분류 코드 ID

- 미입력 시 lang_id는 10000(한국어)으로 설정
caption_typeString자막 유형

- STANDARD : 일반 자막
- SDH : 청각 장애인용 자막
e.g., 청각 장애인용 자막인 경우 &caption_type=SDH 설정 필요
- 미입력 시 일반 자막으로 설정