# 자막 관리

## AI자막 생성

 - [POST /media-contents/{upload_file_key}/ai-subtitles](https://kollus-api.redocly.app/products/vod/openapi/ai/createmediacontentaisubtitle.md): AI 기반 음성 인식(STT) 기술을 활용하여 콘텐츠의 음성 데이터를 실시간으로 분석하고, 이를 텍스트 형태의 자막 파일로 자동 변환하여 등록합니다.

## AI자막 생성

 - [POST /media-contents/{upload_file_key}/ai-subtitles](https://kollus-api.redocly.app/products/vod/openapi/%EC%9E%90%EB%A7%89-%EA%B4%80%EB%A6%AC/createmediacontentaisubtitle.md): AI 기반 음성 인식(STT) 기술을 활용하여 콘텐츠의 음성 데이터를 실시간으로 분석하고, 이를 텍스트 형태의 자막 파일로 자동 변환하여 등록합니다.

## 자막 목록 조회

 - [GET /media-contents/{upload_file_key}/subtitles](https://kollus-api.redocly.app/products/vod/openapi/%EC%9E%90%EB%A7%89-%EA%B4%80%EB%A6%AC/getmediacontentsubtitles.md): 특정 콘텐츠에 등록된 전체 자막 목록을 조회합니다. 자막 이름(name) 또는 자막 언어 코드(language_code)를 기준으로 필터링할 수 있습니다.

## 자막 등록 (텍스트 직접 입력)

 - [POST /media-contents/{upload_file_key}/subtitles](https://kollus-api.redocly.app/products/vod/openapi/%EC%9E%90%EB%A7%89-%EA%B4%80%EB%A6%AC/createmediacontentsubtitle.md): 자막 텍스트 내용을 직접 입력하여 특정 콘텐츠의 자막을 생성합니다.

## 자막 파일 신규 업로드

 - [POST /media-contents/{upload_file_key}/subtitles/upload](https://kollus-api.redocly.app/products/vod/openapi/%EC%9E%90%EB%A7%89-%EA%B4%80%EB%A6%AC/uploadmediacontentsubtitle.md): 자막 파일을 업로드하여 지정된 콘텐츠의 자막 정보를 생성합니다.

## 자막 파일 업데이트

 - [POST /media-contents/{upload_file_key}/subtitles/{subtitle_id}/upload](https://kollus-api.redocly.app/products/vod/openapi/%EC%9E%90%EB%A7%89-%EA%B4%80%EB%A6%AC/updatemediacontentsubtitlefile.md): 기존 자막 데이터를 새로운 자막 파일로 교체합니다.

## 자막 정보 조회

 - [GET /media-contents/{upload_file_key}/subtitles/{subtitle_id}](https://kollus-api.redocly.app/products/vod/openapi/%EC%9E%90%EB%A7%89-%EA%B4%80%EB%A6%AC/getmediacontentsubtitle.md): 특정 자막의 상세 정보를 조회합니다.

## 자막 정보 수정

 - [PUT /media-contents/{upload_file_key}/subtitles/{subtitle_id}](https://kollus-api.redocly.app/products/vod/openapi/%EC%9E%90%EB%A7%89-%EA%B4%80%EB%A6%AC/updatemediacontentsubtitle.md): 기존에 등록된 자막의 내용이나 언어 설정 등의 정보를 수정합니다.

## 자막 삭제

 - [DELETE /media-contents/{upload_file_key}/subtitles/{subtitle_id}](https://kollus-api.redocly.app/products/vod/openapi/%EC%9E%90%EB%A7%89-%EA%B4%80%EB%A6%AC/deletemediacontentsubtitle.md): 특정 자막을 시스템에서 영구적으로 삭제합니다.

## 자막 표시 순서 변경 (특정 위치)

 - [PUT /media-contents/{upload_file_key}/subtitles/{subtitle_id}/move](https://kollus-api.redocly.app/products/vod/openapi/%EC%9E%90%EB%A7%89-%EA%B4%80%EB%A6%AC/movemediacontentsubtitle.md): 플레이어 자막 선택 목록에서 지정된 자막의 표시 순서를 id 파라미터로 지정된 자막의 위치로 변경합니다.

## 자막 표시 순서 변경 (최상단)

 - [PUT /media-contents/{upload_file_key}/subtitles/{subtitle_id}/move-first](https://kollus-api.redocly.app/products/vod/openapi/%EC%9E%90%EB%A7%89-%EA%B4%80%EB%A6%AC/movemediacontentsubtitletofirst.md): 플레이어 자막 선택 목록에서 지정된 자막을 첫 번째 순서로 표시합니다.

## 자막 표시 순서 변경 (최하단)

 - [PUT /media-contents/{upload_file_key}/subtitles/{subtitle_id}/move-last](https://kollus-api.redocly.app/products/vod/openapi/%EC%9E%90%EB%A7%89-%EA%B4%80%EB%A6%AC/movemediacontentsubtitletolast.md): 플레이어 자막 선택 목록에서 지정된 자막을 마지막 순서로 표시합니다.