본문으로 건너뛰기

AI 서비스

AI 서비스 API v3 레퍼런스 바로가기
신규 기능 안내
  • 지원 범위: AI 서비스(AI자막, AI요약·챕터, AI배속)는 v3에 신규 추가된 기능으로, v1 및 v2에서는 지원하지 않습니다.
  • 공통 인증: 모든 API는 쿼리 스트링 파라미터(?access_token=)를 통한 공통 인증 방식을 필수로 요구합니다.

AI자막 생성​

  • 지원 버전 (v3): POST /media-contents/{upload_file_key}/ai-subtitles

요청 본문​

필드데이터 타입필수 여부설명 및 허용값
language_codeString필수자막 생성 대상 영상 또는 오디오의 주요 사용 언어 (ko: 한국어, en: 영어)
kindInteger필수자막 유형 설정 (0: 메인 자막, 1: 서브 자막)
statusInteger필수자막 공개 여부 설정 (0: 비공개, 1: 공개)

응답 구조 명세​

{
  "data": {
    "task_id": "id",
    "message": "string"
  },
  "status": "ok"
}

AI요약·챕터 데이터 조회​

  • 지원 버전 (v3): GET /media-contents/{upload_file_key}/ai-outlines

요청 쿼리 파라미터​

파라미터데이터 타입필수 여부설명
language_codeString선택자막 언어 필터링 (ko: 한국어, en: 영어)

응답 구조 명세​

{
  "data": [
    {
      "language_code": "ko",
      "summary": [
        {
          "start_position": 0,
          "end_position": 120,
          "value": "string"
        }
      ],
      "chapter": [
        {
          "position": 0,
          "value": "string"
        }
      ],
      "keyword": [
        "string1", "string2"
      ]
    }
  ]
}

AI요약·챕터 데이터 생성​

  • 지원 버전 (v3): POST /media-contents/{upload_file_key}/ai-outlines

요청 본문​

필드데이터 타입필수 여부설명
language_codeString필수요약·챕터 생성 대상 영상 또는 오디오의 주요 사용 언어 (ko: 한국어, en: 영어)
ai_subtitle_kindInteger선택연계될 AI자막의 유형 설정 (0 또는 1)
ai_subtitle_statusInteger선택연계될 AI자막의 공개 여부 설정 (0 또는 1)

응답 구조 및 예외 명세​

  • 성공 시: 별도의 응답 데이터 본문 없이 HTTP 204 No Content 상태 코드를 반환합니다.
  • 예외 발생 시
    • 403 Forbidden: 권한 없음
    • 409 Conflict: 이미 요약·챕터 데이터가 존재함

콘텐츠 AI배속 전환​

  • 지원 버전 (v3): POST /media-contents/{upload_file_key}/ai-scripts

요청 본문​

이 엔드포인트는 요청 본문 없이 URL 경로(Path)에 지정된 upload_file_key만을 사용하여 작업을 식별합니다.

응답 구조 명세​

{
  "data": {
    "task_id": "id"
  },
  "status": "ok"
}