プリセットテンプレート分析ジョブを送信します。
操作説明
SubmitAnalysisJob オペレーションを呼び出してプリセットテンプレート分析ジョブを送信すると、ApsaraVideo Media Processing (MPS) はジョブの入力ファイルをインテリジェントに分析し、適切なプリセットテンプレートを推奨します。分析結果をクエリするには、QueryAnalysisJobList オペレーションを呼び出すか、非同期通知を有効にして分析結果を受信できます。
分析結果は、生成後 2 週間のみ保持されます。2 週間後に分析結果は削除されます。2 週間後にトランスコーディングジョブで推奨されたプリセットテンプレートを使用すると、ジョブは失敗し、エラーコード
AnalysisResultNotFoundが返されます。
QPS 制限
このオペレーションは、アカウントごとに 1 秒あたり 100 回まで呼び出すことができます。この制限を超過するリクエストは破棄され、サービス中断が発生します。このオペレーションを呼び出す際は、この制限に注意することを推奨します。詳細については、「QPS 制限」をご参照ください。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
mts:SubmitAnalysisJob |
create |
*All Resource
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| Input |
string |
必須 |
送信するプリセットテンプレート分析ジョブの入力情報です。値は JSON オブジェクトである必要があります。指定された OSS バケットに対する読み取り権限を MPS に付与するには、Object Storage Service (OSS) コンソールにログインする必要があります。詳細については、「パラメーターの詳細」トピックの「Input」セクションをご参照ください。 説明
OSS バケットは、ご利用の MPS サービスと同じリージョンに存在する必要があります。 |
{"Bucket":"example-bucket","Location":"oss-cn-hangzhou","Object":"example.flv"} |
| AnalysisConfig |
string |
任意 |
ジョブ構成です。このパラメーターは必要に応じて設定します。詳細については、「パラメーターの詳細」トピックの「AnalysisConfig」セクションをご参照ください。 |
{"QualityControl":{"RateQuality":25,"MethodStreaming":"network"}} |
| UserData |
string |
任意 |
カスタムデータです。カスタムデータには、英字、数字、ハイフン (-) を含めることができ、長さは 1,024 バイトまでです。カスタムデータは特殊文字で始めることはできません。 |
testid-001 |
| PipelineId |
string |
必須 |
ジョブが送信される MPS キューの ID です。MPS キューの ID を表示するには、MPS コンソールにログインし、左側のナビゲーションウィンドウで [グローバル設定] > [パイプライン] を選択します。非同期通知を有効にする場合は、MPS キューが Message Service (MNS) Topic にバインドされていることを確認してください。 |
bb558c1cc25b45309aab5be44d19**** |
| Priority |
string |
任意 |
ジョブが送信される MPS キュー内のジョブの優先度です。
|
10 |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
レスポンスパラメーターです。 |
||
| RequestId |
string |
リクエスト ID です。 |
B52658D4-07AB-43CD-82B0-210958A65E23 |
| AnalysisJob |
object |
送信されたプリセットテンプレート分析ジョブに関する情報です。 |
|
| CreationTime |
string |
ジョブ作成時間です。 |
2014-01-10T12:00:00Z |
| Percent |
integer |
トランスコードの進行状況です。 |
100 |
| State |
string |
ジョブのステータスです。有効値:
|
Success |
| AnalysisConfig |
object |
ジョブ構成です。 |
|
| QualityControl |
object |
ジョブ出力の品質管理です。 |
|
| MethodStreaming |
string |
再生モードです。有効値:
|
network |
| RateQuality |
string |
出力ファイルの品質レベルです。 |
50 |
| PropertiesControl |
object |
ジョブ出力の属性に対するコントロールです。 |
|
| Deinterlace |
string |
デインターレースが強制的に実行されたかどうかを示します。有効値:
|
Force |
| Crop |
object |
ビデオ画像のクロップ構成です。 |
|
| Top |
string |
クロップされた上マージンです。 説明
Mode パラメーターが Auto または None に設定されている場合、このパラメーターは無効です。 |
8 |
| Width |
string |
マージンがクロップされた後のビデオの幅です。 説明
Mode パラメーターが Auto または None に設定されている場合、このパラメーターは無効です。 |
8 |
| Height |
string |
マージンがクロップされた後のビデオの高さです。 説明
Mode パラメーターが Auto または None に設定されている場合、このパラメーターは無効です。 |
8 |
| Left |
string |
クロップされた左マージンです。 説明
Mode パラメーターが Auto または None に設定されている場合、このパラメーターは無効です。 |
8 |
| Mode |
string |
クロップモードです。有効値:
|
Auto |
| Message |
string |
ジョブが失敗した場合に返されるエラーメッセージです。 |
The resource operated \"PipelineId\" cannot be found |
| Priority |
string |
ジョブが送信された MPS キュー内のジョブの優先度です。
|
10 |
| MNSMessageResult |
object |
MNS からジョブ結果をユーザーに通知するために送信されたメッセージです。 |
|
| MessageId |
string |
ジョブが成功した場合に返されるメッセージ ID です。ジョブが失敗した場合、このパラメーターは返されません。 |
3ca84a39a9024f19853b21be9cf9**** |
| ErrorMessage |
string |
ジョブが失敗した場合に返されるエラーメッセージです。ジョブが成功した場合、このパラメーターは返されません。 |
The resource operated \"PipelineId\" cannot be found |
| ErrorCode |
string |
ジョブが失敗した場合に返されるエラーコードです。ジョブが成功した場合、このパラメーターは返されません。 |
InvalidParameter.ResourceNotFound |
| TemplateList |
object |
||
| Template |
array<object> |
一致したプリセットテンプレートです。 |
|
|
array<object> |
プリセットテンプレートに関する情報です。 |
||
| Video |
object |
ビデオコーデックの構成。 |
|
| Bufsize |
string |
バッファーサイズです。
|
5000 |
| Degrain |
string |
独立ノイズリダクションアルゴリズムの強度です。 |
5 |
| BitrateBnd |
object |
ビデオの平均ビットレート範囲です。 |
|
| Max |
string |
合計ビットレートの上限です。単位: Kbit/s。 |
20 |
| Min |
string |
合計ビットレートの下限です。単位: Kbit/s。 |
10 |
| PixFmt |
string |
ビデオカラーエンコーディングのピクセルフォーマットです。有効値: yuv420p や yuvj420p などの標準ピクセルフォーマット。 |
yuvj420p |
| Codec |
string |
ビデオコーデックです。デフォルト値: H.264。 |
H.264 |
| Height |
string |
ビデオの高さです。
|
1880 |
| Qscale |
string |
ビデオの品質管理レベルです。 |
15 |
| Bitrate |
string |
ビデオの平均ビットレートです。単位: Kbit/s。 |
10 |
| Maxrate |
string |
ビデオの最大ビットレートです。単位: Kbit/s。 |
10 |
| Profile |
string |
コーデックプロファイルです。有効値:
|
baseline |
| Crf |
string |
固定レート係数です。
|
27 |
| Gop |
string |
2つのキーフレーム間の最大フレーム数です。デフォルト値: 250。 |
1 |
| Width |
string |
ビデオの幅です。
|
1990 |
| Fps |
string |
フレームレートです。
|
60 |
| Preset |
string |
プリセットビデオアルゴリズムです。有効値: veryfast、fast、medium、slow、slower。デフォルト値: medium。 |
medium |
| ScanMode |
string |
スキャンモードです。有効値:
|
progressive |
| TransConfig |
object |
一般的なトランスコード構成です。 |
|
| TransMode |
string |
トランスコードモードです。有効値: onepass、twopass、CBR。デフォルト値: onepass。 |
onepass |
| State |
string |
テンプレートのステータスです。
|
Normal |
| MuxConfig |
object |
トランスミキシング構成です。 |
|
| Gif |
object |
GIF フォーマットのトランスミキシング構成です。 |
|
| FinalDelay |
string |
GIF フォーマットの 2 つの連続するループ間の間隔です。単位: 0.01秒。例えば、値 500 は 5 秒を示します。 |
0 |
| Loop |
string |
GIF または WebP フォーマットのループ数です。デフォルト値: 0。 |
0 |
| Segment |
object |
セグメント構成です。 |
|
| Duration |
string |
セグメントの長さです。単位: 秒。 |
60 |
| Name |
string |
テンプレート名です。 |
FLV-UD |
| Audio |
object |
オーディオコーデックの構成です。 |
|
| Profile |
string |
オーディオのコーデックプロファイルです。Codec パラメーターが aac に設定されている場合の有効値: aac_low、aac_he、aac_he_v2、aac_ld、aac_eld。 |
aac_low |
| Codec |
string |
オーディオコーデックフォーマットです。デフォルト値: acc。 |
mp3 |
| Samplerate |
string |
サンプリングレートです。
|
32000 |
| Qscale |
string |
オーディオの品質管理レベルです。 |
10 |
| Channels |
string |
サウンドチャンネル数です。デフォルト値: 2。 |
1 |
| Bitrate |
string |
出力ファイルのオーディオビットレートです。
|
8 |
| Id |
string |
トランスコーディングテンプレート ID です。 |
S00000000-00**** |
| Container |
object |
コンテナフォーマット構成です。 |
|
| Format |
string |
コンテナフォーマットです。 |
flv |
| UserData |
string |
カスタムデータです。 |
testid-001 |
| Code |
string |
ジョブが失敗した場合に返されるエラーコードです。ジョブが成功した場合、このパラメーターは返されません。 |
InvalidParameter.ResourceNotFound |
| InputFile |
object |
ジョブ入力に関する情報です。 |
|
| Object |
string |
入力ファイルとして使用される OSS オブジェクト名です。 |
example.flv |
| Location |
string |
OSS リージョン ID です。 |
oss-cn-hangzhou |
| Bucket |
string |
OSS バケット名です。 |
example-bucket |
| PipelineId |
string |
分析ジョブが送信された MPS キューの ID です。 |
bb558c1cc25b45309aab5be44d19**** |
| Id |
string |
テンプレート分析ジョブの ID です。 |
57f6aa3f84824309bcba67231b40**** |
例
成功レスポンス
JSONJSON
{
"RequestId": "B52658D4-07AB-43CD-82B0-210958A65E23",
"AnalysisJob": {
"CreationTime": "2014-01-10T12:00:00Z",
"Percent": 100,
"State": "Success",
"AnalysisConfig": {
"QualityControl": {
"MethodStreaming": "network",
"RateQuality": "50"
},
"PropertiesControl": {
"Deinterlace": "Force",
"Crop": {
"Top": "8",
"Width": "8",
"Height": "8",
"Left": "8",
"Mode": "Auto"
}
}
},
"Message": "The resource operated \\\"PipelineId\\\" cannot be found",
"Priority": "10",
"MNSMessageResult": {
"MessageId": "3ca84a39a9024f19853b21be9cf9****",
"ErrorMessage": "The resource operated \\\"PipelineId\\\" cannot be found",
"ErrorCode": "InvalidParameter.ResourceNotFound"
},
"TemplateList": {
"Template": [
{
"Video": {
"Bufsize": "5000",
"Degrain": "5",
"BitrateBnd": {
"Max": "20",
"Min": "10"
},
"PixFmt": "yuvj420p",
"Codec": "H.264",
"Height": "1880",
"Qscale": "15",
"Bitrate": "10",
"Maxrate": "10",
"Profile": "baseline",
"Crf": "27",
"Gop": "1",
"Width": "1990",
"Fps": "60",
"Preset": "medium",
"ScanMode": "progressive"
},
"TransConfig": {
"TransMode": "onepass"
},
"State": "Normal",
"MuxConfig": {
"Gif": {
"FinalDelay": "0",
"Loop": "0"
},
"Segment": {
"Duration": "60"
}
},
"Name": "FLV-UD",
"Audio": {
"Profile": "aac_low",
"Codec": "mp3",
"Samplerate": "32000",
"Qscale": "10",
"Channels": "1",
"Bitrate": "8"
},
"Id": "S00000000-00****",
"Container": {
"Format": "flv"
}
}
]
},
"UserData": "testid-001",
"Code": "InvalidParameter.ResourceNotFound",
"InputFile": {
"Object": "example.flv",
"Location": "oss-cn-hangzhou",
"Bucket": "example-bucket"
},
"PipelineId": "bb558c1cc25b45309aab5be44d19****",
"Id": "57f6aa3f84824309bcba67231b40****"
}
}エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。