숏클립 생성

Prev Next

Classic/VPC 환경에서 이용 가능합니다.

송출 중인 라이브 채널의 숏클립을 스냅샷으로 생성합니다. 채널이 READY 또는 PUBLISHING 상태일 때만 숏클립을 생성할 수 있습니다. 생성된 숏클립을 이용하여 빠르게 VOD를 서비스할 수 있으며, 숏폼 콘텐츠로도 활용이 가능합니다. 숏클립 생성 시 다음 내용을 참고해 주십시오.

  • 최소 100ms, 최대 4시간 분량으로 생성할 수 있습니다.
  • 채널에 설정된 타임머신을 사용하여 원하는 시점의 숏클립을 생성할 수 있습니다.
  • 생성된 숏클립은 네이버 클라우드 플랫폼의 Object Storage 버킷에 mp4 파일로 자동 업로드됩니다.

요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

메서드 URI
POST /api/v2/channels/{channelId}/{snapshotId}

요청 헤더

Live Station API에서 공통으로 사용하는 헤더에 대한 정보는 Live Station 요청 헤더를 참조해 주십시오.

요청 경로 파라미터

요청 경로 파라미터에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
channelId String Required 채널 아이디
snapshotId String Required 스냅샷 아이디

요청 바디

요청 바디에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
startTime Integer Required 숏클립 시작 지점(밀리초)
  • 스냅샷 재생 시간 기준의 시작 지점
  • 0부터 입력 가능
endTime Integer Required 숏클립 종료 지점(밀리초)
  • 스냅샷 재생 시간 기준의 종료 지점
  • startTime의 100ms 이후부터 입력 가능
shortclip Object Required 숏클립 저장 설정
shortclip.output Object Required 저장 정보
shortclip.output.accessControl String Required 공개 범위
  • PRIVATE (기본값) | PUBLIC_READ
    • PRIVATE: 비공개
    • PUBLIC_READ: 공개
shortclip.output.bucketName String Required Object Storage 버킷 이름
shortclip.output.filePath String Required 저장 상세 경로
  • / 로 시작
참고

요청 바디 입력 시 다음 내용을 참고해 주십시오.

  • startTime , endTime은 스냅샷의 상대적인 재생 시간으로 입력해 주십시오.
    <예시> startTime=0, endTime=1500으로 요청 시 스냅샷의 0~1.5초 구간(00:00:000 ~ 00:00:015)으로 숏클립 생성
  • endTime - startTime 값은 스냅샷 재생 시간을 초과할 수 없습니다.

요청 예시

요청 예시는 다음과 같습니다.

curl --location --request POST 'https://livestation.apigw.ntruss.com/api/v2/channels/ls-20250814******-zTwK2/7548' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'x-ncp-region_code: KR' \
--header 'Content-Type: application/json' \
--data '{
    "startTime": 0,
    "endTime": 60000,
    "shortclip": {
        "output": {
            "accessControl": "PRIVATE",
            "bucketName": "mybucket",
            "filePath": "/shortclip"
        }
    }
}'

응답

응답 형식을 설명합니다.

응답 바디

응답 바디에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
content Object - 응답 결과
content.channelId String - 채널 아이디
content.snapshotId String - 스냅샷 아이디
content.shortclip Object - 숏클립 저장 설정
content.shortclip.id Integer - 숏클립 아이디
content.shortclip.status String - 숏클립 상태
  • CREATING | COMPLETED | PROCESSING_FAIL | UPLOAD_FAIL
    • CREATING: 생성 중
    • COMPLETED: 완료
    • PROCESSING_FAIL: 생성 실패
    • UPLOAD_FAIL: 업로드 실패
content.shortclip.createdTime Integer - 숏클립 생성 일시(밀리초)
  • Unix Timestamp 형식
content.shortclip.updatedTime Integer - 숏클립 업데이트 일시(밀리초)
  • Unix Timestamp 형식
content.shortclip.output Object - 숏클립 저장 정보
content.shortclip.output.accessControl String - 숏클립 파일 저장 버킷 공개 범위
  • PRIVATE | PUBLIC_READ
    • PRIVATE: 비공개
    • PUBLIC_READ: 공개
content.shortclip.output.bucketName String - 숏클립 파일 저장 버킷 이름
content.shortclip.output.filePath String - 저장 상세 경로
content.shortclip.output.fileName String - 숏클립 파일 이름

응답 상태 코드

Live Station API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Live Station 응답 상태 코드를 참조해 주십시오.

응답 예시

응답 예시는 다음과 같습니다.

{
    "content": {
        "channelId": "ls-20250814******-zTwK2",
        "snapshotId": 7548,
        "shortclip": {
            "id": 1403,
            "status": "CREATING",
            "createdTime": 1755566018278,
            "updatedTime": 1755566018277,
            "output": {
                "accessControl": "PRIVATE",
                "bucketName": "mybucket",
                "filePath": "/shortclip",
                "fileName": "1403-1755566018278.mp4"
            }
        }
    }
}