스냅샷 생성

Prev Next

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

송출 중인 라이브 채널의 숏클립을 생성하기 위해 스냅샷을 생성합니다. 채널이 녹화 중일 때만 스냅샷을 생성할 수 있습니다. 스냅샷 생성 시 다음 내용을 참고해 주십시오.

  • 녹화 시간이 100ms 이상 누적된 이후부터 생성할 수 있습니다.
  • 녹화 시작부터 종료까지 최대 4시간 분량으로 생성할 수 있습니다.
    • 녹화 시간이 4시간을 초과하는 경우, 마지막 4시간 분량을 지원합니다.
  • 녹화 재시작 시 기존 스냅샷 시점도 초기화됩니다.
  • 요청 시점에 따라 여러 개의 스냅샷을 생성할 수 있습니다.

요청

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

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

요청 헤더

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

요청 경로 파라미터

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

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

요청 쿼리 파라미터

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

필드 타입 필수 여부 설명
limitedDuration Integer Optional 스냅샷 생성 시간(분)
  • 1~240
  • 현재 시점을 기준으로 역산하여 저장할 재생 시간
  • 미입력 시 방송 시작 시점부터 현재까지 전체 시간 저장(최대 4시간)
  • <예시> 방송 01:00:00 시점에 limitedDuration=1 요청 시 00:59:00~01:00:00 구간 스냅샷 생성

요청 예시

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

curl --location --request POST 'https://livestation.apigw.ntruss.com/api/v2/channels/ls-20250814******-zTwK2/snapshot?limitedDuration=8' \
--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'

응답

응답 형식을 설명합니다.

응답 바디

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

필드 타입 필수 여부 설명
content Object - 응답 결과
content.channelId String - 채널 아이디
content.channelStatus String - 채널 상태
  • CREATING | READY | PUBLISHING | DELETED | BLOCK | FORCE_BLOCK | FORCE_DELETED
    • CREATING: 생성 중
    • READY: 준비
    • PUBLISHING: 송출 중
    • DELETED: 삭제
    • BLOCK: 정지
    • FORCE_BLOCK: 강제 정지
    • FORCE_DELETED: 사용 불가
content.snapshot Object - 스냅샷 정보
content.snapshot.snapshotId Integer - 스냅샷 아이디
  • 추후 스냅샷 조회 시 필요
content.snapshot.snapshotUrl String - 스냅샷 재생 URL
  • 생성 시점부터 1시간 동안 유효 (만료 후 조회 불가능)
content.snapshot.createdTime Integer - 스냅샷 생성 일시(밀리초)
  • Unix Timestamp 형식
content.snapshot.expireTime Integer - 스냅샷 만료 일시(밀리초)
  • Unix Timestamp 형식
content.snapshot.duration Integer - 스냅샷 요청 시간(분)
  • limitedDuration이 설정된 경우, 표시

응답 상태 코드

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

응답 예시

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

{
    "content": {
        "channelId": "ls-20250814******-zTwK2",
        "channelStatus": "PUBLISHING",
        "snapshot": {
            "snapshotId": 7526,
            "snapshotUrl": "https://*************.edge.naverncp.com/dvr/snapshot/1755508932161/als-nmssenc02/l6f07uzuaex2hriziguozw291avx4xqfrf6k/480p-16-9/7526-1755505332161.m3u8",
            "createdTime": 1755505332161,
            "expireTime": 1755508932161,
            "duration": 8
        }
    }
}