화질 생성
    • PDF

    화질 생성

    • PDF

    기사 요약

    Live Station 에서 사용할 화질을 생성하는 API 입니다. 생성한 화질 조회를 위해 화질 목록 조회 API화질 정보 조회 API를 제공합니다.

    요청

    POST https://livestation.apigw.ntruss.com/api/fin-v2/qualityProfiles
    

    요청 헤더

    헤더명필수 여부설명
    x-ncp-apigw-timestampYES1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(Millisecond)로 나타내며 API Gateway 서버와 시간 차가 5분 이상 나는 경우 유효하지 않은 요청으로 간주
    x-ncp-apigw-timestamp:{Timestamp}
    x-ncp-iam-access-keyYES네이버 클라우드 플랫폼 포털에서 발급받은 Access Key ID 값
    x-ncp-iam-access-key:{Sub Account Access Key}
    x-ncp-apigw-signature-v2YESAccess Key ID 값과 Secret Key로 암호화한 서명
    x-ncp-apigw-signature-v2:{API Gateway Signature}
    Content-TypeYESRequest body content type을 application/json으로 지정
    Content-Type: application/json
    x-ncp-region_codeYES리전 코드 (FKR)

    요청 바디

    필드명필수 여부타입제약 사항설명
    nameYesString화질명은 숫자,영문으로 최소 3글자 이상 최대 20자까지 입력 가능합니다.특수 문자“-” 허용
    typeYesStringNORMAL, AUDIO
    videoYesObject
    video.codecYesStringH264
    video.profileYesStringBASELINE, MAIN, HIGH
    if user’s frame size (width x height) is bigger than 921600,
    All options are available
    if user’s frame size (width x height) smaller than 921600 (1280*720),
    High, Main Profile option should be disabled.
    video.levelYesInteger-1 로만 설정 가능AUTO: -1
    video.widthYesInteger16 ~ 4096
    Even integer value between 128 and 1920
    video.heightYesInteger16 ~ 4096
    Even integer value between 96 and 1920
    video.fpsYesDecimal1 ~ 60 fps
    video.bitrateYesInteger1 ~ 204800000 bps단위: bps
    video.videoH264ParamRefFramesNoInteger1
    video.rateControlNoStringVBR, CBRdefaut : VBR
    video.bframesNoInteger0 ~ 4 사이 정수
    validation check by resolution
    if user’s frame size (width x height) is 921600 ~ 2073600 (19201080),
    all options are available (0,1,2,3,4)
    if user’s frame size (width x height) smaller than 921600 (1280
    720),
    3,4 option should be disabled
    if user’s frame size (width x height) smaller than 409920 (854*480),
    1 ,2,3,4 option should be disabled.
    default : 0
    video.bypassNoBooleantrue, falsedefault : false
    audioYesObject
    audio.codecYesStringAAC , MP3
    audio.profileYesStringLCAAC-LC (Profile only when AAC)
    audio.samplerateYesInteger오디오 samplerate 값 (in Hz.)
    AAC : [8000, 11025, 12000, 16000, 22050, 24000, 32000, 44100, 48000, 64000, 88200, 96000]
    MP3 : [8000, 11025, 12000, 16000, 22050, 24000, 32000, 44100, 48000]
    44100
    audio.channelsYesIntegerAAC : 0 ~ 8
    MP3 : 0 ~ 2
    0
    audio.bitrateYesInteger16 ~ 320 kbps단위: kbps
    audio.bypassYesBooleantrue, falseBypass 설정, audio stream을 Bypass mode로 동작할지 여부
    default: false

    응답

    필드명타입설명비고
    idIntegerQuality ID
    statusStringCREATED
    createdTimeInteger
    genTypeStringCUSTOM
    nameString
    typeStringNORMAL, AUDIO
    videoObject
    video.fpsFloat
    video.bitrateInteger
    video.bframesInteger
    video.levelInteger
    video.widthInteger
    video.heightInteger
    video.codecStringH264
    video.profileStringBASELINE, MAIN, HIGH
    video.rateControlStringCBR, VBR
    audioObject
    audio.codecStringAAC, MP3
    audio.profileStringLC
    audio.samplerateInteger
    audio.channelsInteger
    audio.bitrateInteger
    audio.bypassBoolean

    예시

    요청 예시

    POST /api/fin-v2/qualityProfiles
    HOST: livestation.apigw.ntruss.com
    Content-Type: application/json
    x-ncp-apigw-timestamp:1521787414578
    x-ncp-iam-access-key:6uxz1nKkcYwUjWRG5Q1V7NsW0i5jErlu2NjBXXgy
    x-ncp-apigw-signature-v2:iJFK773KH0WwQ79PasqJ+ZGixtpDQ/abS57WGQdld2M=
    x-ncp-region_code:FKR
    
    {
       "name": "testquality",
       "type" : "NORMAL",
       "video" : {
          "codec" : "H264",
          "profile" : "MAIN",
          "level" : -1,
          "width" : 1920,
          "height" : 1080,
          "fps" : 30,
          "bitrate" : 2000000,
          "rateControl" : "CBR",
          "videoH264ParamRefFrames": 1,
          "bframes" : 0,
          "bypass" : false
       },
       "audio" : {
          "codec" : "AAC",
          "profile" : "LC",
          "channels" : 0,
          "samplerate" : 44100,
          "bitrate" : 192,
          "bypass" : false
       }
    }
    

    응답 예시

    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" : {
          "id" : 57,
          "status" : "CREATED",
          "createdTime" : 1585554546811,
          "genType" : "CUSTOM",
          "name" : "testquality",
          "type" : "NORMAL",
          "video" : {
             "fps" : 30.0,
             "bitrate" : 2000000,
             "bframes" : 0,
             "level" : -1,
             "width" : 1920,
             "height" : 1080,
             "codec" : "H264",
             "profile" : "MAIN",
             "rateControl" : "CBR"
          },
          "audio" : {
             "codec" : "AAC",
             "profile" : "LC",
             "samplerate" : 44100,
             "channels" : 0,
             "bitrate" : 192,
             "bypass" : false
          }
      }
    }
    

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

    What's Next
    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.