エンコードオプション作成
    • PDF

    エンコードオプション作成

    • PDF

    Article Summary

    VOD Stationは、エンコードオプションを作成するための APIを提供します。また、作成したエンコードオプションの照会のために、エンコードオプションリスト照会 APIエンコードオプション情報照会 APIを提供します。

    リクエスト

    POST https://vodstation.apigw.ntruss.com/api/v2/encoding-option
    

    リクエストヘッダ

    ヘッダ名説明
    x-ncp-region_codeNAVERクラウドプラットフォームの region code
    x-ncp_region_code:{Region Code}
    x-ncp-apigw-timestamp1970年1月1日00:00:00協定世界時(UTC)からの経過時間をミリ秒(Millisecond)で表す
    API Gatewayサーバとの時間差が5分以上の場合は、無効なリクエストとみなす
    x-ncp-apigw-timestamp:{Timestamp}
    x-ncp-iam-access-keyNAVERクラウドプラットフォームポータルで発行された Access Key ID値
    x-ncp-iam-access-key:{Sub Account Access Key}
    x-ncp-apigw-signature-v2Access Key ID値と Secret Keyで暗号化した署名
    x-ncp-apigw-signature-v2:{API Gateway Signature}
    Content-TypeRequest body content typeを application/jsonに指定
    Content-Type: application/json

    リクエストボディ

    APIリクエスト時にフィールド名の大文字・小文字の区別が必要です。

    フィールド名要否タイプ制約事項デフォルト値説明
    nameYesString3文字以上20文字以下のアルファベット、数字、コロン(:)、ハイフン(-)、アンダーバー(_)のみ入力可能作成するユーザー指定エンコードオプションの名前
    formatYesStringMP4変換されたメディアファイルコンテナのフォーマット
    encodingOptionTypeNoStringNORMAL, AUDIONORMAL- ユーザー指定のエンコードオプションのタイプ
    ビデオとオーディオを含む NORMALプリセット、またはオーディオストリームのみ含む AUDIOプリセットを選択
    audioYesObjectトランスコードオーディオオプション設定のオブジェクト
    audio.codecYesStringAACオーディオコーデック設定
    audio.channelYesStringAUTO, 1, 2- 出力オーディオのチャンネル設定
    AUTO設定時にソースオーディオチャンネルを使用참고: 인풋 미디어 파일의 오디오 채널과 다른 설정으로 인코딩 시 볼륨의 변화가 발생 할 수 있음
    audio.bitrateYesInteger16~320の範囲の整数、単位: Kbpsトランスコードするオーディオストリームのビットレート設定
    audio.samplingRateYesIntegerAUTO(-2)、22050、32000、44100、48000 単位: Hz出力オーディオサンプリングレートの設定 AUTO設定時にソースのオーディオサンプリングレートを使用
    videoYesObject- トランスコードビデオオプション設定のオブジェクト
    encodingOptionTypeが AUDIOの場合、 videoオブジェクトは省略
    video.codecYesStringAVCビデオコーデック設定
    AVC(H.264)に対応
    video.codecOptionsYesObjectビデオコーデック詳細オプション設定オブジェクト
    video.codecOptions.profileYesStringBASELINE, MAIN, HIGHVideo Codec Profileは、動画の使用用途に合わせ、 H.264コーデックの特定の技術を使用できるように、予め定義しておいた標準明細
    video.codecOptions.levelYesString1, 1b, 1.1, 1.2, 1.3, 2.1, 2.2, 3.1, 3.2, 4.1, 4.2, 5.1, 5.2Video Codec Levelは、動画を再生する端末の再生機(デコーダ)がどの程度のリソースを必要とするのかを決めておいた標準明細
    video.bitrateYesIntegerbitrate > 0 単位: Kbpsビデオストリームのビットレート設定 動画の画質を左右する非常に重要な要素として、1秒間の動画を構成するデータのサイズを設定
    video.widthYesIntegerAUTO(-2)、96~4096の範囲の整数、単位: ピクセル出力ビデオの幅 widthのみ AUTOの場合、heightは固定され、widthは当該動画の比率に合わせて変換
    video.heightYesIntegerAUTO(-2)、96~4096の範囲の整数、単位: ピクセル出力ビデオの高さ heightのみ AUTOの場合、widthは固定され、heightは当該動画の比率に合わせて変換
    video.framerateYesDoubleAUTO(-2), 10, 15, 23.97, 24, 29.97, 30, 50, 601秒当たりのフレーム数設定 出力ビデオストリームに1秒当たりに、いくつのフレームを表示するかを設定
    video.maxFramerateNoInteger10~60の間の整数Video.framerateが AUTOの場合のみ使用し、最大 framerateを設定
    video.keyframeIntervalYesInteger1~100の範囲の整数キーフレーム間隔設定 ビデオにキーフレームが作成される間隔(単位: 秒)
    video.rateControlYesStringAUTO,ABR, CRF, CBR
    video.passが2-Passの場合、 ABRのみ許可
    ABR- ビデオ変換時のビットレート配分方式
    CBR: 固定ビットレートで、全フレームに対しビットレートを同様に変換 ビットレートが固定されているために、変換後の容量を予測しやすいが、ABR、CRFに比べて品質が劣る
    CRF: 圧縮効率は高く、エンコード前のビットレートとファイルサイズを指定不可
    ABR: 可変ビットレートで、平均ビットレートを維持しながら必要なビットレートに応じて可変
    video.passYesString1-Pass, 2-Pass- ビデオ変換時に使用するエンコード方式
    2-Passは、1-Passに比べ与えられた bitrateを効率的に活用するが、エンコード時間が長い

    レスポンス

    フィールド名タイプ説明備考
    errorObjectリクエスト失敗時のレスポンス
    エラーレスポンスコードとメッセージ
    error.codeIntegerエラーレスポンスコード
    error.messageStringエラーレスポンスメッセージ
    contentObjectVOD Station OPEN APIレスポンスオブジェクト
    content.disabledBooleanSub Accountで提供されるフィールド
    当該リソースの subaccountでの有効有無
    content.idStringエンコードオプション ID
    content.nameStringエンコードオプション名
    content.formatString変換されたメディアファイルコンテナのフォーマット
    content.encodingOptionTypeStringエンコードオプションのタイプ
    content.audioObjectトランスコードオーディオオプション設定のオブジェクト
    content.audio.codecStringオーディオコーデック設定
    content.audio.channelInteger出力オーディオのチャンネル設定
    content.audio.bitrateIntegerトランスコードするオーディオストリームのビットレート設定(単位: Kbps)
    content.audio.samplingRateInteger出力オーディオサンプリングレート(単位: Hz)
    content.videoObjectトランスコードビデオオプション設定のオブジェクト
    content.video.codecStringビデオコーデック設定
    content.video.codecOptionsObjectビデオコーデック詳細オプション設定のオブジェクト
    content.video.codecOptions.profileString設定された Video Codec Profile
    content.video.codecOptions.levelString設定された Video Codec Level
    content.video.bitrateIntegerビデオストリームのビットレート(単位: Kbps)
    content.video.widthInteger出力ビデオの幅
    content.video.heightInteger出力ビデオの高さ
    content.video.framerateDouble1秒当たりのフレーム数
    content.video.keyframeIntervalIntegerビデオにキーフレームが作成される間隔(単位: 秒)
    content.video.rateControlStringビットレートの配分方式
    content.defaultSetBooleanシステム提供プリセットかどうか

    リクエスト例

    POST https://vodstation.apigw.ntruss.com/api/v2/encoding-option
    
    POST /api/v2/encoding-option
    HOST: vodstation.apigw.ntruss.com
    Content-Type: application/json
    x-ncp-region_code:KR
    x-ncp-apigw-timestamp:1521787414578
    x-ncp-iam-access-key:6uxz1nKkcYwUjWRG5Q1V7NsW0i5jErlu2NjBXXgy
    x-ncp-apigw-signature-v2:iJFK773KH0WwQ79PasqJ+ZGixtpDQ/abS57WGQdld2M=
    
    Reqeust body
    {
      "audio": {
        "bitrate": 192,
        "channel": 2,
        "codec": "AAC",
        "samplingRate": 44100
      },
      "encodingOptionType": "NORMAL",
      "format": "MP4",
      "name": "basic-enc-option",
      "video": {
        "bitrate": 5000,
        "codec": "AVC",
        "codecOptions": {
          "level": "3.1",
          "profile": "MAIN"
        },
        "framerate": 30.0,
        "height": 1080,
        "keyframeInterval": 2,
        "pass": "1-Pass",
        "rateControl": "ABR",
        "maxFramerate": 30,
        "width": 1920
      }
    }
    

    レスポンス例

    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
        }
      }
    }
    

    この記事は役に立ちましたか?

    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.