인코딩 옵션 정보 조회

인쇄
공유
PDF

기사 요약

이 요약이 도움이 되었나요?

의견을 보내 주셔서 감사합니다.

VOD Station은 인코딩 옵션의 상세 정보를 조회하기 위한 API를 제공합니다.

요청

GET https://vod-station.apigw.gov-ntruss.com/api/v2/encoding-option/{encodingOptionId}

요청 헤더

헤더명	설명
x-ncp-apigw-timestamp	1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(Millisecond)로 표현 API Gateway 서버와 시간 차가 5분 이상 나는 경우 유효하지 않은 요청으로 간주 `x-ncp-apigw-timestamp:{Timestamp}`
x-ncp-iam-access-key	네이버 클라우드 플랫폼 포털에서 발급받은 Access Key ID 값 `x-ncp-iam-access-key:{Sub Account Access Key}`
x-ncp-apigw-signature-v2	Access Key ID 값과 Secret Key로 암호화한 서명 `x-ncp-apigw-signature-v2:{API Gateway Signature}`

응답

필드명	타입	설명
error	Object	요청 실패 시 응답 오류 응답 코드 및 메시지
error.code	Integer	오류 응답 코드
error.message	String	오류 응답 메시지
content	Object	VOD Station OPEN API 응답 객체
content.disabled	Boolean	subaccount 제공 필드 해당 리소스가 subaccount에서 활성 여부
content.id	String	인코딩 옵션 ID
content.name	String	인코딩 옵션의 이름
content.format	String	변환된 미디어 파일 컨테이너 포맷
content.encodingOptionType	String	인코딩 옵션의 타입
content.audio	Object	트랜스코딩 오디오 옵션 설정 객체
content.audio.codec	String	오디오 코덱 설정
content.audio.channel	Integer	출력 오디오의 채널 설정
content.audio.bitrate	Integer	트랜스코딩할 오디오 스트림의 비트 전송률 설정 (단위 : Kbps)
content.audio.samplingRate	Integer	출력 오디오 샘플링 레이트 (단위 : Hz)
content.video	Object	트랜스코딩 비디오 옵션 설정 객체
content.video.codec	String	비디오 코덱 설정
content.video.codecOptions	Object	비디오 코덱 상세옵션 설정 객체
content.video.codecOptions.profile	String	설정된 Video Codec Profile
content.video.codecOptions.level	String	설정된 Video Codec Level
content.video.bitrate	Integer	비디오 스트림의 비트 전송률 (단위 : Kbps)
content.video.width	Integer	출력 비디오의 너비
content.video.height	Integer	출력 비디오의 높이
content.video.framerate	Double	초당 프레임 수
content.video.keyframeInterval	Integer	비디오에 키 프레임이 생성되는 간격 (단위 : 초)
content.video.rateControl	String	비트레이트 배분 방식
content.defaultSet	Boolean	시스템 제공 프리셋 여부

예시

요청 예시

GET https://vod-station.apigw.gov-ntruss.com/api/v2/encoding-option/10058

GET /api/v2/encoding-option/10058
HOST: vod-station.apigw.gov-ntruss.com
x-ncp-apigw-timestamp:1521787414578
x-ncp-iam-access-key:6uxz1nKkcYwUjWRG5Q1V7NsW0i5jErlu2NjBXXgy
x-ncp-apigw-signature-v2:iJFK773KH0WwQ79PasqJ+ZGixtpDQ/abS57WGQdld2M=

응답 예시

HTTP/1.1 200 OK
Server: nginx
Date: Wed, 12 Sep 2018 09:53:32 GMT
Content-Type: application/json;charset=utf-8
Connection: keep-alive
Access-Control-Allow-Origin: *
x-ncp-trace-id: 36c9k60om4p3238cpmc9gm4cj4

{
  "content": {
    "disabled": false,
    "id": 10058,
    "encodingOptionType": "NORMAL",
    "name": "basic-enc-option",
    "format": "MP4",
    "video": {
      "codec": "AVC",
      "codecOptions": {
        "profile": "MAIN",
        "level": "3.1"
      },
      "bitrate": 5000,
      "width": 1920,
      "height": 1080,
      "framerate": 30,
      "maxFramerate": 30,
      "keyframeInterval": 2,
      "rateControl": "ABR",
      "pass": "1-Pass"
    },
    "audio": {
      "codec": "AAC",
      "bitrate": 192,
      "channel": 2,
      "samplingRate": 44100
    }
  }
}

이 문서가 도움이 되었습니까?

What's Next

인코딩 옵션 목록 조회

요청
응답
예시