업로드 토큰을 이용하여, 동영상 자막 파일의 업로드를 실행합니다.
multipart/form data를 이용한 업로드 방식입니다. 한개의 동영상에 언어 구분에 따라 여러개의 자막 업로드가 가능합니다.
언어 구분은 자막 언어 코드 조회 API 를 이용하여 ID를 조회할 수 있습니다.
자막 파일 형식은 smi, srt, vtt를 지원하며, HTML5 플레이어 환경에서도 자막을 이용하기 위해서는 가급적 vtt 포맷의 자막 파일을 권장합니다.
자막 파일 변경
자막 파일 업로드 시 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 설정 필요- 미입력 시 일반 자막으로 설정 |