エンコードオプション作成
- 印刷する
- PDF
エンコードオプション作成
- 印刷する
- PDF
記事の要約
この要約は役に立ちましたか?
ご意見ありがとうございます
VOD Stationは、エンコードオプションを作成するための APIを提供します。また、作成したエンコードオプションの照会のために、エンコードオプションリスト照会 APIとエンコードオプション情報照会 APIを提供します。
リクエスト
POST https://vodstation.apigw.ntruss.com/api/v2/encoding-option
リクエストヘッダ
ヘッダ名 | 説明 |
---|---|
x-ncp-region_code | NAVERクラウドプラットフォームの region codex-ncp_region_code:{Region Code} |
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 | NAVERクラウドプラットフォームポータルで発行された 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} |
Content-Type | Request body content typeを application/jsonに指定Content-Type: application/json |
リクエストボディ
APIリクエスト時にフィールド名の大文字・小文字の区別が必要です。
フィールド名 | 要否 | タイプ | 制約事項 | デフォルト値 | 説明 |
---|---|---|---|---|---|
name | Yes | String | 3文字以上20文字以下のアルファベット、数字、コロン(:)、ハイフン(-)、アンダーバー(_)のみ入力可能 | 作成するユーザー指定エンコードオプションの名前 | |
format | Yes | String | MP4 | 変換されたメディアファイルコンテナのフォーマット | |
encodingOptionType | No | String | NORMAL, AUDIO | NORMAL | - ユーザー指定のエンコードオプションのタイプ ビデオとオーディオを含む NORMALプリセット、またはオーディオストリームのみ含む AUDIOプリセットを選択 |
audio | Yes | Object | トランスコードオーディオオプション設定のオブジェクト | ||
audio.codec | Yes | String | AAC | オーディオコーデック設定 | |
audio.channel | Yes | String | AUTO, 1, 2 | - 出力オーディオのチャンネル設定 AUTO設定時にソースオーディオチャンネルを使用 참고: 인풋 미디어 파일의 오디오 채널과 다른 설정으로 인코딩 시 볼륨의 변화가 발생 할 수 있음 | |
audio.bitrate | Yes | Integer | 16~320の範囲の整数、単位: Kbps | トランスコードするオーディオストリームのビットレート設定 | |
audio.samplingRate | Yes | Integer | AUTO(-2)、22050、32000、44100、48000 単位: Hz | 出力オーディオサンプリングレートの設定 AUTO設定時にソースのオーディオサンプリングレートを使用 | |
video | Yes | Object | - トランスコードビデオオプション設定のオブジェクト encodingOptionTypeが AUDIOの場合、 videoオブジェクトは省略 | ||
video.codec | Yes | String | AVC | ビデオコーデック設定 AVC(H.264)に対応 | |
video.codecOptions | Yes | Object | ビデオコーデック詳細オプション設定オブジェクト | ||
video.codecOptions.profile | Yes | String | BASELINE, MAIN, HIGH | Video Codec Profileは、動画の使用用途に合わせ、 H.264コーデックの特定の技術を使用できるように、予め定義しておいた標準明細 | |
video.codecOptions.level | Yes | String | 1, 1b, 1.1, 1.2, 1.3, 2.1, 2.2, 3.1, 3.2, 4.1, 4.2, 5.1, 5.2 | Video Codec Levelは、動画を再生する端末の再生機(デコーダ)がどの程度のリソースを必要とするのかを決めておいた標準明細 | |
video.bitrate | Yes | Integer | bitrate > 0 単位: Kbps | ビデオストリームのビットレート設定 動画の画質を左右する非常に重要な要素として、1秒間の動画を構成するデータのサイズを設定 | |
video.width | Yes | Integer | AUTO(-2)、96~4096の範囲の整数、単位: ピクセル | 出力ビデオの幅 widthのみ AUTOの場合、heightは固定され、widthは当該動画の比率に合わせて変換 | |
video.height | Yes | Integer | AUTO(-2)、96~4096の範囲の整数、単位: ピクセル | 出力ビデオの高さ heightのみ AUTOの場合、widthは固定され、heightは当該動画の比率に合わせて変換 | |
video.framerate | Yes | Double | AUTO(-2), 10, 15, 23.97, 24, 29.97, 30, 50, 60 | 1秒当たりのフレーム数設定 出力ビデオストリームに1秒当たりに、いくつのフレームを表示するかを設定 | |
video.maxFramerate | No | Integer | 10~60の間の整数 | Video.framerateが AUTOの場合のみ使用し、最大 framerateを設定 | |
video.keyframeInterval | Yes | Integer | 1~100の範囲の整数 | キーフレーム間隔設定 ビデオにキーフレームが作成される間隔(単位: 秒) | |
video.rateControl | Yes | String | AUTO,ABR, CRF, CBR video.passが2-Passの場合、 ABRのみ許可 | ABR | - ビデオ変換時のビットレート配分方式 CBR: 固定ビットレートで、全フレームに対しビットレートを同様に変換 ビットレートが固定されているために、変換後の容量を予測しやすいが、ABR、CRFに比べて品質が劣る CRF: 圧縮効率は高く、エンコード前のビットレートとファイルサイズを指定不可 ABR: 可変ビットレートで、平均ビットレートを維持しながら必要なビットレートに応じて可変 |
video.pass | Yes | String | 1-Pass, 2-Pass | - ビデオ変換時に使用するエンコード方式 2-Passは、1-Passに比べ与えられた bitrateを効率的に活用するが、エンコード時間が長い |
レスポンス
フィールド名 | タイプ | 説明 | 備考 |
---|---|---|---|
error | Object | リクエスト失敗時のレスポンス エラーレスポンスコードとメッセージ | |
error.code | Integer | エラーレスポンスコード | |
error.message | String | エラーレスポンスメッセージ | |
content | Object | VOD Station OPEN APIレスポンスオブジェクト | |
content.disabled | Boolean | Sub Accountで提供されるフィールド 当該リソースの 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 | 1秒当たりのフレーム数 | |
content.video.keyframeInterval | Integer | ビデオにキーフレームが作成される間隔(単位: 秒) | |
content.video.rateControl | String | ビットレートの配分方式 | |
content.defaultSet | Boolean | システム提供プリセットかどうか |
例
リクエスト例
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
}
}
}
この記事は役に立ちましたか?