업로드 토큰을 이용하여, 동영상 자막 파일의 업로드를 실행합니다.
multipart/form data를 이용한 업로드 방식입니다.
한개의 동영상에 언어 구분에 따라 여러개의 자막 업로드가 가능합니다.
언어 구분은 자막 언어 코드 조회 API 를 이용하여 ID를 조회할 수 있습니다.
자막 파일 형식은 HTML5 플레이어에서의 자막 사용을 위해 WebVTT(.vtt 확장자 파일)만 지원합니다.
WebVTT 형식의 자막을 등록 시 Mobile Player에서도 자막을 이용할 수 있습니다.
브라우저에 따라 WebVTT에서 정의된 위치 지정 또는 스타일 지정 속성 중 일부가 지원되지 않을 수 있습니다.
자막 파일 변경
자막 파일 업로드 시 access_key와 lang_id, caption_type이 동일한 기존 파일이 이미 존재하는 경우에는 신규 업로드 파일로 교체됩니다.
Request URL
{captionUploadUrl}?token={token}&access_key={access_key}&lang_id={lang_id}
Request Parameters
Parameter Name | Type | Description |
---|---|---|
token (Required) | String | 업로드 토큰 API에서 조회한 토큰 값 |
access_key (Required) | String | 자막과 매칭 할 동영상의 원본 키 (Original Key – Video Access Key_Level 1) |
captionfile (Required) | File (multipart/form) | 업로드 할 자막 파일 데이터 |
lang_id | Integer | 언어 분류 코드 ID - 미입력 시 lang_id는 10000(한국어)으로 설정 |
caption_type | String | 자막 유형 - STANDARD : 일반 자막 - SDH : 청각 장애인용 자막 e.g., 청각 장애인용 자막인 경우 &caption_type=SDH 설정 필요- 미입력 시 일반 자막으로 설정 |