SubmitJobs API を使用して ApsaraVideo MPS トランスコーディングジョブを送信する - ApsaraVideo MPS - Alibaba Cloud - ApsaraVideo Media Processing

この操作は、トランスコーディングジョブを送信します。コンソールで作成したトランスコーディングタスクやワークフローが要件を満たさない場合、この操作を使用して、ビジネスロジックに基づいて必要なトランスコーディングパラメーターを設定できます。

操作説明

トランスコーディングジョブは非同期ジョブです。すぐに実行されることは保証されていません。トランスコーディングジョブを送信すると、ジョブは MPS キューに追加され、スケジューリングを待ちます。したがって、API 応答はトランスコーディングの完了を示すものではありません。結果を確認するには、QueryTranscodeJobList 操作を呼び出してステータスをポーリングするか、キューの MNS メッセージ通知を設定します。詳細については、「メッセージ通知の受信」をご参照ください。
単一の入力ファイルの最大サイズは 100 GB です。これより大きいファイルはジョブの失敗を引き起こす可能性があります。
プリセットインテリジェントテンプレートを使用して入力ファイルをトランスコーディングするには、まず SubmitAnalysisJob 操作 (SubmitAnalysisJob) を呼び出してテンプレート分析ジョブを送信します。分析ジョブが成功した後、QueryAnalysisJobList 操作 (QueryAnalysisJobList) を呼び出して、入力ファイルで利用可能なプリセットテンプレートのリストを取得します。トランスコーディングジョブを送信する際に、TemplateId パラメーターを利用可能なプリセットテンプレート ID のいずれかに設定します。指定されたテンプレートが利用可能なプリセットテンプレートのリストにない場合、トランスコーディングジョブは失敗します。
プリセット静的テンプレートを使用して入力ファイルをトランスコーディングする場合、テンプレート分析ジョブを送信する必要はありません。
MPS で複数の Alibaba Cloud アカウントを使用するには、ご利用の Alibaba Cloud アカウントに RAM ユーザーを作成できます。詳細については、「RAM ユーザーを作成し、権限を付与する」をご参照ください。異なる Alibaba Cloud アカウントを使用してトランスコーディングジョブを送信およびクエリする場合、クエリ結果にデータは返されません。
トランスコーディングに関するよくある質問への回答については、「ApsaraVideo Media Processing よくある質問」をご参照ください。

QPS 制限

この操作の QPS 制限は、ユーザーあたり 100 リクエスト/秒です。この制限を超えるとレート制限がトリガーされ、ビジネスに影響を与える可能性があります。この操作は適宜呼び出してください。詳細については、「QPS 制限」をご参照ください。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

mts:SubmitJobs

create

*All Resource

*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
Input	string	必須	ジョブ入力。詳細については、「入力の詳細」をご参照ください。説明 ApsaraVideo Media Processing API では、Object の値は UTF-8 エンコーディングを使用して URL エンコードする必要があります。 OSS リージョンは、MPS がデプロイされているリージョンと一致する必要があります。	{"Bucket":"exampleBucket","Location":"oss-cn-hangzhou","Object":"example.flv","Referer": "用户自行在OSS控制台设置的OSS防盗链参数"}
Outputs	string	必須	ジョブ出力設定。詳細については、「出力の詳細」をご参照ください。 Outputs は Output オブジェクトの JSON 配列です。最大サイズは 30 です。	[{"OutputObject":"exampleOutput.mp4","TemplateId":"6181666213ab41b9bc21da8ff5ff**","WaterMarks":[{"InputFile":{"Bucket":"exampleBucket","Location":"oss-cn-hangzhou","Object":"image_01.png"},"WaterMarkTemplateId":"9b772ce2740d4d55876d8b542d47**"}],"UserData":"testid-001"}]
OutputBucket	string	必須	出力ファイルが保存される OSS バケット。 OSS バケットの定義に従います。詳細については、「用語」をご参照ください。	exampleBucket
OutputLocation	string	任意	出力バケットが存在する OSS リージョン。 OSS バケットは、ApsaraVideo Media Processing サービスと同じリージョンにある必要があります。 OSS バケットの定義に従います。詳細については、「用語」をご参照ください。	oss-cn-hangzhou
PipelineId	string	必須	パイプライン ID。詳細については、「用語」をご参照ください。 MPS コンソールの [設定] > [パイプラインとコールバック] で確認できます。非同期通知を受信するには、MNS メッセージトピックをパイプラインにバインドします。詳細については、「メッセージ通知の受信」をご参照ください。	dd3dae411e704030b921e52698e5****

レスポンスフィールド

フィールド	型	説明	例
	object	応答パラメーター。
JobResultList	object
JobResult	array<object>	送信されたトランスコーディングジョブのリスト。
	array<object>	応答パラメーター。
Code	string	ジョブの作成が失敗した場合のエラーコード。ジョブが正常に作成された場合、このパラメーターは返されません。	InvalidParameter.NullValue
Job	object	詳細なジョブ情報。ジョブの送信が失敗した場合、ジョブ ID は生成されません。
Code	string	トランスコーディングが失敗した場合のエラーコード。トランスコーディングが成功した場合、このパラメーターは返されません。	InternalError
CreationTime	string	ジョブが追加された時間。	2014-01-10T12:00:00Z
FinishTime	string	ジョブが終了した時間。	2014-01-10T12:20:00Z
Input	object	ジョブ入力。
Bucket	string	ジョブ入力の OSS バケット。	example-bucket-****
Location	string	ジョブ入力の OSS ロケーション。	oss-cn-hangzhou
Object	string	ジョブ入力の OSS オブジェクト。	example.flv
JobId	string	ジョブ ID。	31fa3c9ca8134f9cec2b4b0b0f78****
MNSMessageResult	object	ジョブ完了の MNS 通知結果。
ErrorCode	string	通知が失敗した場合のエラーコード。通知が成功した場合、このパラメーターは返されません。	InvalidParameter.ResourceNotFound
ErrorMessage	string	通知が失敗した場合のエラーメッセージ。通知が成功した場合、このパラメーターは返されません。	The resource operated "%s" cannot be found.
MessageId	string	通知が失敗した場合のエラーメッセージ ID。通知が成功した場合、このパラメーターは返されません。	123
Message	string	トランスコーディングが失敗した場合のメッセージ。トランスコーディングが成功した場合、このパラメーターは返されません。	The operation has failed due to some unknown error, exception or failure.
Output	object	ジョブ出力。
AmixList	object
Amix	array<object>	音声ミキシングリスト。
	object	応答パラメーター。
AmixURL	string	バックグラウンド音声としてミキシングするメディアファイル。有効な値：OSS URL または文字列 `"input"`。入力シナリオ：同じ動画から 2 つのオーディオトラックをミキシングします。	https://outpu***.oss-cn-shanghai.aliyuncs.com/mp4-to-mp3%5E1571025263578816%40.mp3
Duration	string	持続時間。フォーマット：数値または時間フォーマット。	20
Map	string	AmixURL からターゲットのオーディオトラックを選択します。有効な値：0:a:{audio_index}、例：0:a:0。	0:a:0
MixDurMode	string	メディアの持続時間の選択。有効な値：first、long。 first：入力メディアの持続時間を出力メディアの持続時間として使用します。 long：2 つのメディアファイルのうち、長い方の持続時間を出力メディアの持続時間として使用します。デフォルト値：long。	long
Start	string	開始時間。フォーマット：数値または時間フォーマット、例：「1:25:36.240」または「32000.23」。	0
Audio	object	音声設定。説明リクエストパラメーターで音声設定を指定した場合、指定したトランスコーディングテンプレートの対応するパラメーターがオーバーライドされます。
Bitrate	string	出力ファイルの音声ビットレート。単位：Kbps。デフォルト値：128。	128
Channels	string	サウンドチャンネル数。 Codec が mp3 に設定されている場合、有効な値は 1 と 2 です。 Codec が aac に設定されている場合、有効な値は 1、2、4、5、6、8 です。デフォルト値：2。	6
Codec	string	音声コーデック形式。有効な値：aac、mp3、vorbis、flac。デフォルト値：aac。	aac
Profile	string	音声コーデックプロファイル。説明 Codec が aac の場合、有効な値には aac_low、aac_he、aac_he_v2、aac_ld、aac_eld が含まれます。	aac_low
Qscale	string	音声品質管理係数。	15
Samplerate	string	サンプルレート。有効な値：22050、32000、44100、48000、96000。単位：Hz。デフォルト値：44100。説明コンテナフォーマットが flv で、音声コーデックが mp3 の場合、サンプルレート 32000、48000、96000 はサポートされません。音声コーデックが mp3 の場合、サンプルレート 96000 はサポートされません。	32000
Volume	object	音量制御。
Level	string	音量調整レベル。単位：dB。デフォルト：-20 dB。	-20
Method	string	音量調整方法。有効な値： auto：自動調整。 dynamic：動的調整。 linear：線形調整。	auto
AudioStreamMap	string	音声ストリームインデックス。フォーマット：0:a:{index}、例：0:a:0。インデックスは音声ストリームリスト内の位置で、0 から始まります。設定しない場合、デフォルトの音声ストリームが選択されます。	0:a:0
Clip	object	クリッピングセグメント。
TimeSpan	object	クリッピング時間範囲。
Duration	string	持続時間。フォーマット：`hh:mm:ss[.SSS]` または `sssss[.SSS]`。有効範囲：`[00:00:00.000,23:59:59.999]` または `[0.000,86399.999]`。	01:00:59.999
Seek	string	開始時間。フォーマット：`hh:mm:ss[.SSS]` または `sssss[.SSS]`。有効範囲：`[00:00:00.000,23:59:59.999]` または `[0.000,86399.999]`。	01:59:59.999
Container	object	コンテナ。
Format	string	コンテナフォーマット。デフォルト値：mp4。動画トランスコーディングの場合、有効な値は flv、mp4、HLS (m3u8+ts)、MPEG-DASH (MPD+fMP4) です。音声トランスコーディングの場合、有効な値は mp3、mp4、ogg、flac、m4a です。画像の場合、有効な値は gif と WEBP です。コンテナフォーマットが gif の場合、VideoCodec は GIF に設定する必要があります。コンテナフォーマットが webp の場合、VideoCodec は WEBP に設定する必要があります。コンテナフォーマットが flv の場合、VideoCodec は H265 に設定できません。	flv
DeWatermark	string	ぼかし処理、JSON オブジェクトとして。詳細については、「パラメーター詳細」のぼかし処理の詳細をご参照ください。	{"0": [{"l": 10,"t": 10,"w": 10,"h": 10},{"l": 100,"t": 0.1,"w": 10,"h": 10}],"128000": [],"250000": [{"l": 0.2,"t": 0.1,"w": 0.01,"h": 0.05}]}
DigiWaterMark	object	デジタルウォーターマーク。
Alpha	string	テキストまたは画像の透明度。有効範囲：(0,1]。デフォルト値：1.0。	1.0
InputFile	object	入力ファイル。
Bucket	string	入力ファイルの OSS バケット。	example-bucket-****
Location	string	入力ファイルの OSS ロケーション。	oss-cn-hangzhou
Object	string	入力ファイルの OSS オブジェクト。	example-intput.flv
Type	string	ウォーターマークタイプ。設定した場合、この値はウォーターマークテンプレートの対応するパラメーターをオーバーライドします。有効な値： Image：デフォルト。画像ウォーターマーク。 Text：テキストウォーターマーク。	Image
Encryption	object	データ暗号化。m3u8 出力のみサポートされます。
Id	string	暗号化 ID。	31fa3c9ca8134f9cec2b4b0b0f78****
Key	string	動画の暗号鍵。	encryptionkey128
KeyType	string	暗号鍵はプレーンテキストで MPS に送信できません。Base64 または KMS を使用して暗号化する必要があります。例えば、キーが "encryptionkey128" の場合、Base64("encryptionkey128") または KMS(Base64("encryptionkey128")) を使用します。	Base64
KeyUri	string	キーにアクセスするための URL。BASE64 でエンコードされています。	https://1161758785*****.cn-shanghai.fc.aliyuncs.com/2016-08-15/proxy/HLS-decyptServer/decyptServer/
SkipCnt	string	暗号化をスキップする初期セグメント数 (高速再生を有効にするため)。	3
Type	string	暗号化タイプ。有効な値：hls-aes-128。	hls-aes-128
M3U8NonStandardSupport	object	M3U8 非標準サポート、JSON オブジェクトとして。詳細については、「パラメーター詳細」のM3U8 非標準パラメーターサポートの詳細をご参照ください。
TS	object	TS ファイルの非標準サポートのための JSON オブジェクト。詳細については、「パラメーター詳細」のTS パラメーターサポートの詳細をご参照ください。
Md5Support	boolean	M3U8 ファイルに TS ファイルの MD5 値を出力するかどうか。有効な値： true：はい。 false：いいえ。	true
SizeSupport	boolean	M3U8 ファイルに TS ファイルのサイズを出力するかどうか。有効な値： true：はい。 false：いいえ。	true
MergeConfigUrl	string	MergeList または MergeConfigUrl のいずれかを指定できますが、両方は指定できません。 MergeConfigUrl で指定された設定ファイルは、最大 50 のマージセグメントをサポートします。 MergeConfigUrl はマージ設定ファイルの URL です。設定ファイルは OSS に保存し、MPS がアクセスするための権限を付与する必要があります。内部ファイルの内容については、マージパラメーターの詳細をご参照ください。 mergeConfigfile の内容の例：`{"MergeList":[{"MergeURL":"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/video_01.mp4"}]}`。	`{"MergeList":[{"MergeURL":"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/video_01.mp4"}]}
MergeList	object
Merge	array<object>	動画マージ設定。
	object	詳細な動画マージ設定。
Duration	string	持続時間。フォーマット：`hh:mm:ss[.SSS]` または `sssss[.SSS]`。例：01:59:59.999 または 32000.23。	00000.20
MergeURL	string	マージセグメントの URL。例：`http://example-bucket-**.oss-cn-hangzhou.aliyuncs.com/example-object-**.flv`。 Object の値は UTF-8 エンコーディングを使用して URL エンコードする必要があります。	http://example-bucket-**.oss-cn-hangzhou.aliyuncs.com/example-object-**.flv
RoleArn	string	エージェント権限付与に使用されるロール ARN。	acs:ram:::role/
Start	string	開始時点。フォーマット：`hh:mm:ss[.SSS]` または `sssss[.SSS]`。例：01:59:59.999 または 32000.23。	00000.50
MuxConfig	object	多重化設定。リクエストでこのパラメーターを設定すると、指定したトランスコーディングテンプレートの対応するパラメーターがオーバーライドされます。
Gif	object	GIF 多重化設定。
DitherMode	string	カラーパレットのディザモード。有効な値：sierra、bayer。	bayer
FinalDelay	string	最終フレームの停止時間、センチ秒単位。	0
IsCustomPalette	string	カスタムカラーパレット機能。有効な値： true：カスタム。 false：カスタムではない。	false
Loop	string	ループ回数。	0
Segment	object	セグメンテーション設定、JSON オブジェクトとして。
Duration	string	セグメント期間。整数、秒単位。有効範囲：[1,10]。デフォルト値：10 秒。	20
Webp	object	WEBP 多重化設定。
Loop	string	ループ回数。	0
OpeningList	object
Opening	array<object>	オープニングリスト、JSON オブジェクトとして。
	object	応答パラメーター。
Height	string	高さ。有効な値：0~4096、-1、full。デフォルト値：-1。 -1 はソースの高さを意味します。 full は画面全体を埋めることを意味します。	1080
Start	string	メイン動画に対する相対的な開始時間。オープニング動画を表示する前の遅延。単位：秒。デフォルト値：0。	1
Width	string	幅。有効な値：0~4096、-1、full。デフォルト値：-1。 -1 はソースの幅を意味します。 full は画面全体を埋めることを意味します。	1920
openUrl	string	オープニング動画の OSS URL。	http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv
OutSubtitleList	object
OutSubtitle	array<object>	出力字幕リスト。
	array<object>	出力字幕の詳細。
Map	string	ビデオトラック。フォーマット：`0:{stream}:{stream_index}`、つまり `0:v:{video_index}`。ストリーム値：v = ビデオ。インデックスはビデオトラックリスト内の位置で、0 から始まります。	0:v:0
Message	string	ジョブ作成が失敗した場合のエラーメッセージ。ジョブ作成が成功した場合、このパラメーターは返されません。	The specified parameter “%s” cannot be null.
OutSubtitleFile	object	出力ファイルの詳細。
Bucket	string	入力ファイルの OSS バケット。	example-bucket-****
Location	string	出力ファイルの OSS ロケーション。	oss-cn-hangzhou
Object	string	出力ファイルの OSS オブジェクト。	example-output.flv
RoleArn	string	エージェント権限付与に使用されるロール ARN。	acs:ram:::role/
Success	boolean	操作が成功したかどうか。有効な値： true：成功。 false：失敗。	true
OutputFile	object	出力ファイル。
Bucket	string	入力ファイルの OSS バケット。	example-bucket-****
Location	string	出力ファイルの OSS ロケーション。	oss-cn-hangzhou
Object	string	出力ファイルの OSS オブジェクト。	example-output.flv
RoleArn	string	エージェント権限付与に使用されるロール ARN。	acs:ram:::role/
Priority	string	対応するパイプライン内でのジョブの優先度。最高優先度：10。デフォルト値：6。	5
Properties	object	メディアプロパティ。
Bitrate	string	ビットレート。	1000
Duration	string	持続時間。	55
FileFormat	string	ファイル形式。	QuickTime / MOV
FileSize	string	ファイルサイズ。	3509895
Format	object	フォーマット情報。
Bitrate	string	合計ビットレート。	1000
Duration	string	合計持続時間。	55
FormatLongName	string	コンテナまたはカプセル化形式の長い名前。	QuickTime / MOV
FormatName	string	コンテナまたはカプセル化形式の短い名前。有効な値：mov、mp4、m4a、3gp、3g2、mj2。	mov
NumPrograms	string	プログラムストリームの総数。	0
NumStreams	string	メディアストリームの総数。	2
Size	string	ファイルサイズ。	3509895
StartTime	string	開始時間。	0.000000
Fps	string	フレームレート、数値。	25
Height	string	動画の高さ。	720
Streams	object	ストリーム情報。
AudioStreamList	object
AudioStream	array<object>	音声ストリームリスト。
	object	音声ストリームの詳細。
Bitrate	string	ビットレート。	128.806
ChannelLayout	string	サウンドチャンネル出力スタイル。	stereo
Channels	string	サウンドチャンネル数。	2
CodecLongName	string	エンコード形式の長い名前。	AAC (Advanced Audio Coding)
CodecName	string	エンコード形式の短い名前。	aac
CodecTag	string	エンコード形式タグ。	0x6134706d
CodecTagString	string	エンコード形式タグテキスト。	mp4a
CodecTimeBase	string	コーデックタイムベース。	1/44100
Duration	string	持続時間。	17.159546
Index	string	音声ストリームインデックス。メディアストリーム全体における音声ストリームの位置を識別します。	1
Lang	string	言語。詳細については、「FFmpeg 言語定義」および「ISO-639」をご参照ください。	eng
NumFrames	string	総フレーム数。	25
SampleFmt	string	サンプリング形式。	fltp
Samplerate	string	サンプルレート。	44100
StartTime	string	開始時間。	0.000000
Timebase	string	タイムベース。	1/44100
SubtitleStreamList	object
SubtitleStream	array<object>	字幕ストリームリスト。
	object	字幕ストリームの詳細。
Index	string	字幕ストリームインデックス。メディアストリーム全体における字幕ストリームの位置を識別します。	1
Lang	string	言語。詳細については、「FFmpeg 言語定義」および「ISO-639」をご参照ください。	eng
VideoStreamList	object
VideoStream	array<object>	ビデオストリームリスト。
	array<object>	ビデオストリームの詳細。
AvgFPS	string	平均フレームレート。	23.976025
Bitrate	string	ビットレート。	1496.46
CodecLongName	string	エンコード形式の長い名前。	H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10
CodecName	string	エンコード形式の短い名前。	h264
CodecTag	string	エンコード形式タグ。	0x31637661
CodecTagString	string	エンコード形式タグテキスト。	avc1
CodecTimeBase	string	コーデックタイムベース。	1001/48000
Dar	string	表示アスペクト比。	16:9
Duration	string	持続時間。	17.225542
Fps	string	フレームレート。	23.976025
HasBFrames	string	Bフレームが存在するかどうか。	2
Height	string	動画解像度の高さ。	720
Index	string	ビデオストリームインデックス。メディアストリーム全体におけるビデオストリームの位置を識別します。	0
Lang	string	言語。詳細については、「FFmpeg 言語定義」および「ISO-639」をご参照ください。	eng
Level	string	エンコーディングプロファイル。	51
NetworkCost	object	ネットワーク帯域幅消費。
AvgBitrate	string	平均ビットレート。	100
CostBandwidth	string	消費された最大帯域幅。	10
PreloadTime	string	プリロード時間。	8
NumFrames	string	総フレーム数。	25
PixFmt	string	ピクセルフォーマット。	yuv420p
Profile	string	コーデックプロファイル。	high
Sar	string	サンプルアスペクト比。	1:1
StartTime	string	開始時間。	0.000000
Timebase	string	タイムベース。	1/24000
Width	string	動画解像度の幅、数値。	1280
Width	string	動画の幅。	1280
Rotate	string	動画の時計回りの回転角度。	180
SubtitleConfig	object	字幕設定情報。
ExtSubtitleList	object
ExtSubtitle	array<object>	外部字幕のリスト。最大 4 項目の JSON 配列。
	array<object>	外部字幕の詳細。
CharEnc	string	外部字幕の文字コード。範囲：UTF-8、GBK、BIG5、auto。デフォルト：auto。説明外部字幕の文字コードを auto に設定すると、検出エラーが発生する可能性があります。特定の文字コードを指定することを推奨します。	UTF-8
FontName	string	外部字幕をハード字幕に変換するためのフォント名。デフォルト：SimSun。フォント情報の詳細については、「フォントリスト」をご参照ください。	"WenQuanYi Zen Hei", "Yuanti SC Regular", "SimSun"
Input	object	外部入力字幕ファイルの JSON オブジェクト。現在、srt および ass 形式をサポートしています。
Bucket	string	入力ファイルの OSS バケット。	example-bucket-****
Location	string	入力ファイルの OSS ロケーション。	oss-cn-hangzhou
Object	string	入力ファイルの OSS オブジェクト。	example-output.flv
SubtitleList	object
Subtitle	array<object>	字幕リスト。
	object	応答パラメーター。
Map	string	オーディオトラック。フォーマット：`0:{stream}:{stream_index}`、つまり `0:a:{audio_index}`。ストリーム値は音声ストリームの場合は a です。インデックスは音声ストリームリスト内の位置で、0 から始まります。	0:a:0
SuperReso	object	解像度はソースに従います。
IsHalfSample	string	サンプルレート関連のパラメーターを取得するかどうか。有効な値： true：はい。 false：いいえ。	true
TailSlateList	object
TailSlate	array<object>	エンドスレートリスト、JSON オブジェクトとして。
	object	応答パラメーター。
BgColor	string	エンドスレート動画の幅と高さがメイン動画より小さい場合、空白部分の背景色を設定します。デフォルトは White です。その他の値については、「bgcolor」をご参照ください。	White
BlendDuration	string	メイン動画とエンドスレート間のトランジション時間。効果はフェードイン/フェードアウトです：メイン動画の最終フレームが表示されている間にエンドスレート動画が再生されます。メイン動画の最終フレームは徐々にフェードアウトし、エンドスレート動画は徐々にフェードインします。単位：秒。デフォルト：0。	2
Height	string	高さ。有効な値：0~4096、-1、full。 -1 はソースの高さを意味し、full は画面全体を埋めることを意味します。デフォルト：-1。	1080
IsMergeAudio	boolean	エンドスレート動画の音声コンテンツをマージするかどうか。有効な値： true：マージする。 false：マージしない。	false
Start	string	開始時間。	1
TailUrl	string	エンドスレート動画の OSS URL。	http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv
Width	string	幅。有効な値：0~4096、-1、full。 -1 はソースの幅を意味し、full は画面全体を埋めることを意味します。デフォルト：-1。	1920
TemplateId	string	トランスコーディングテンプレート ID。	S00000000-000010
TransConfig	object	一般的なトランスコーディング設定。説明リクエストでこの値を設定すると、指定したトランスコーディングテンプレートの対応するパラメーターがオーバーライドされます。
AdjDarMethod	string	解像度書き換え方法。デフォルト：none。有効な値： rescale：再スケーリング。 crop：クロップ。 pad：パディング。 none：書き換えない。	crop
IsCheckAudioBitrate	string	音声ビットレートをチェックするかどうか。出力音声ビットレートがソース音声ビットレートより大きい場合、出力音声ビットレートはソース音声ビットレートと等しいと見なされ、設定された音声ビットレートパラメーターは効果がありません。この値は IsCheckAudioBitrateFail よりも優先度が低いです。 true はチェックを意味します。 false はチェックしないことを意味します。デフォルト値：パラメーターが空で、コーデックがソースと異なる場合：false。パラメーターが空で、コーデックがソースと同じ場合：true。	false
IsCheckAudioBitrateFail	string	音声ビットレートをチェックするかどうか。この値は IsCheckAudioBitrate よりも優先度が高いです。出力音声ビットレートがソース音声ビットレートより大きい場合、トランスコーディングは実行されず、ジョブは直接失敗します。 false：チェックする。 true：チェックしない。	true
IsCheckReso	string	解像度をチェックするかどうか。出力解像度が入力解像度より大きい場合（幅または高さに基づく）、出力解像度は入力解像度と等しいと見なされます。 true はチェックを意味します。 false はチェックしないことを意味します。デフォルト値：false。	false
IsCheckResoFail	string	解像度をチェックするかどうか。この値は IsCheckReso よりも優先度が高いです。出力解像度が入力解像度より大きい場合（幅または高さに基づく）、トランスコーディングは実行されず、ジョブは直接失敗します。 true：チェックする。 false：チェックしない。デフォルト値：false。	false
IsCheckVideoBitrate	string	ビデオビットレートをチェックするかどうか。出力ビデオビットレートが入力ビデオビットレートより大きい場合、出力ビデオビットレートは入力ビデオビットレートと等しいと見なされます。 true はチェックを意味します。 false はチェックしないことを意味します。デフォルト値：false。	false
IsCheckVideoBitrateFail	string	ビットレートをチェックするかどうか。出力ビデオビットレートがソースビデオビットレートより大きい場合、トランスコーディングは実行されず、ジョブは直接失敗します。この値は IsCheckVideoBitrate よりも優先度が高いです。 true はチェックを意味します。 false はチェックしないことを意味します。デフォルト値：false。	true
TransMode	string	トランスコーディングモード。有効な値： onepass：One-Pass アルゴリズムに基づき、良好な精度。 twopass：Two-Pass アルゴリズムに基づき、精度は低い。 CBR：固定ビットレート。	onepass
UserData	string	ユーザー定義データ。	example data
Video	object	動画設定。説明指定した場合、TemplateId で指定されたテンプレートの AliyunVideoCodec 設定が置き換えられます。
Bitrate	string	出力動画ファイルのビットレート。単位：Kbps。	10
BitrateBnd	object	平均動画ビットレート範囲。
Max	string	最大合計ビットレート。単位：Kbps。	20
Min	string	最小合計ビットレート。単位：Kbps。	10
Bufsize	string	バッファサイズ。単位：Kb。デフォルト値：6000。	1000
Codec	string	コーデック形式。 H.264、H.265、GIF、WEBP をサポートします。デフォルト値：H.264。	H.264
Crf	string	レート品質制御係数。 Crf が設定されている場合、Bitrate 設定は無視されます。デフォルト値：H.264 コーデックの場合は 23、H.265 コーデックの場合は 26。	22
Crop	string	ビデオフレームのクロップ。2 つの方法をサポートします：黒枠の自動検出とクロップ：border に設定します。カスタムクロップ：パラメーター形式は width:height:left:top です。	1280:800:0:140
Degrain	string	独立したノイズ除去アルゴリズムの強度。	5
Fps	string	フレームレート。単位：fps。有効範囲：0-60。入力ファイルのフレームレートが 60 を超える場合、60 に設定されます。デフォルト値：入力ファイルのフレームレート。	60
Gop	string	キーフレーム間の最大時間間隔または最大フレーム数。単位：秒 (s)。デフォルト値：10s。最大フレーム数には単位はありません。	1
Height	string	高さ。単位：px。デフォルト値：元の動画の高さ。	1280
MaxFps	string	最大フレームレート。	15
Maxrate	string	ピークビデオビットレート。単位：Kbps。	10
Pad	string	黒枠によるビデオパディング。パラメーター形式：width:height:left:top。単位：px。	1280:800:0:140
PixFmt	string	ビデオカラーフォーマット。デフォルト値：yuv420p または元のカラーフォーマット。有効な値：yuv420p、yuvj420p、およびその他の標準カラーフォーマット。説明非標準のカラーフォーマット（yuvj420p(pc, bt470bg/bt470bg/smpte170m) など）は互換性設定が必要で、そうしないとトランスコーディングが失敗します。	yuvj420p
Preset	string	ビデオアルゴリズムプリセット。デフォルト：medium。有効な値： veryfast：超高速。 fast：高速。 medium：中間。 slow：低速。 slower：より低速。	veryfast
Profile	string	エンコーディングプロファイル。現在 H.264 のみサポートされています。デフォルト：high。有効な値：説明複数の解像度がある場合、低スペックのデバイスでの再生を保証するために、最低解像度を baseline に設定することを推奨します。その他の解像度は main または high に設定します。 baseline：モバイルデバイス向け。 main：標準解像度デバイス向け。 high：高解像度デバイス向け。	baseline
Qscale	string	ビデオ品質管理値。	15
ResoPriority	string	リソース優先度。	1
ScanMode	string	スキャンモード。有効な値：未設定：入力ファイルの元のモードを使用します。 auto：自動デインターレース。 progressive：プログレッシブスキャン。 interlaced：インターレーススキャン。デフォルト値：空、つまり未設定。ベストプラクティス：インターレーススキャンはプログレッシブスキャンよりも多くのデータを節約しますが、画質は劣ります。そのため、主流のビデオ制作では現在プログレッシブスキャンが使用されています。 progressive または interlaced スキャンを設定しても、元のビデオモードと一致しない場合、トランスコーディングは失敗します。互換性を向上させるために、元のビデオモードまたは自動デインターレースに設定することを推奨します。	interlaced
Width	string	幅。単位：px。デフォルト値：元の動画の幅。	1080
VideoStreamMap	string	ビデオストリームインデックス。フォーマット：0:a:{index}、例：0:a:0。インデックスは音声ストリームリスト内の位置で、0 から始まります。設定しない場合、デフォルトのビデオストリームが選択されます。	0:a:0
WaterMarkConfigUrl	string	ウォーターマーク設定ファイルの URL。	http://example.com/configure
WaterMarkList	object
WaterMark	array<object>	ウォーターマークリスト。説明ウォーターマークの出力が切り捨てられたり失敗したりする場合は、テキストウォーターマークに特殊文字が含まれていないか確認してください。含まれている場合は、特殊文字をエスケープしてから渡すか、チケットを送信して Alibaba Cloud サポートに互換性対応を依頼してください。
	array<object>	ウォーターマークの詳細。
Dx	string	ウォーターマーク画像の出力ビデオに対する水平オフセット。リクエストで設定した場合、この値はウォーターマークテンプレートの対応するパラメーターをオーバーライドします。デフォルト値は 0 です。値は 2 つの形式で指定できます：整数：ピクセル単位のオフセットを表します。範囲：[8,4096]。単位：px。小数：水平オフセットと出力ビデオ幅の比率を表します。範囲：(0,1)。小数点以下 4 桁までサポートします。例：0.9999。それ以上の桁は破棄されます。	1
Dy	string	ウォーターマーク画像の出力ビデオに対する垂直オフセット。リクエストで設定した場合、この値はウォーターマークテンプレートの対応するパラメーターをオーバーライドします。値は 2 つの形式で指定できます：整数：ピクセル単位の垂直オフセットを表します。範囲：[8,4096]。単位：px。小数：垂直オフセットと出力ビデオ高さの比率を表します。範囲：(0,1)。小数点以下 4 桁までサポートします。例：0.9999。それ以上の桁は破棄されます。	1
Height	string	ウォーターマーク画像の高さ。リクエストで設定した場合、この値はウォーターマークテンプレートの対応するパラメーターをオーバーライドします。値は 2 つの形式で指定できます：整数：ピクセル単位の高さを表します。範囲：[8,4096]。単位：px。小数：ウォーターマークの高さと出力ビデオの高さの比率を表します。範囲：(0,1)。小数点以下 4 桁までサポートします。例：0.9999。それ以上の桁は破棄されます。	1280
InputFile	object	ウォーターマーク入力ファイル。現在、PNG 画像と MOV ファイルを入力としてサポートしています。
Bucket	string	入力ファイルの OSS バケット。	example-bucket
Location	string	入力ファイルの OSS ロケーション。	oss-cn-hangzhou
Object	string	入力ファイルの OSS オブジェクト。	example-logo-****.png
ReferPos	string	ウォーターマークの位置。リクエストで設定した場合、この値はウォーターマークテンプレートの対応するパラメーターをオーバーライドします。有効な値： TopRight：右上。 TopLeft：左上。 BottomRight：右下。 BottomLeft：左下。	TopRight
Type	string	ウォーターマークタイプ。リクエストで設定した場合、この値はウォーターマークテンプレートの対応するパラメーターをオーバーライドします。詳細については、「パラメーター詳細」をご参照ください。有効な値： Image：画像ウォーターマーク。 Text：テキストウォーターマーク。	Image
WaterMarkTemplateId	string	ウォーターマークテンプレート ID。	88c6ca184c0e47098a5b665e2a12****
Width	string	ウォーターマーク画像の幅。リクエストで設定した場合、この値はウォーターマークテンプレートの対応するパラメーターをオーバーライドします。値は 2 つの形式で指定できます：整数：ピクセル単位の幅を表します。範囲：[8,4096]。単位：px。小数：ウォーターマークの幅と出力ビデオの幅の比率を表します。範囲：(0,1)。小数点以下 4 桁までサポートします。例：0.9999。それ以上の桁は破棄されます。	1080
Percent	integer	トランスコーディングの進捗状況。	100
PipelineId	string	パイプライン ID。	88c6ca184c0e47098a5b665e2a126797
State	string	ジョブのステータス。 Submitted：ジョブは送信されました。 TranscodeFail：トランスコーディングは失敗しました。	Submitted
Message	string	ジョブの作成が失敗した場合のエラーメッセージ。ジョブが正常に作成された場合、このパラメーターは返されません。	The specified parameter "%s" cannot be null.
Success	boolean	操作が成功したかどうか。有効な値： true：成功。 false：失敗。	true
RequestId	string	リクエスト ID。	25818875-5F78-4A45S71F6-D73936451234

例

成功レスポンス

JSONJSON

{
  "JobResultList": {
    "JobResult": [
      {
        "Code": "InvalidParameter.NullValue",
        "Job": {
          "Code": "InternalError",
          "CreationTime": "2014-01-10T12:00:00Z",
          "FinishTime": "2014-01-10T12:20:00Z",
          "Input": {
            "Bucket": "example-bucket-****",
            "Location": "oss-cn-hangzhou",
            "Object": "example.flv"
          },
          "JobId": "31fa3c9ca8134f9cec2b4b0b0f78****",
          "MNSMessageResult": {
            "ErrorCode": "InvalidParameter.ResourceNotFound",
            "ErrorMessage": "The resource operated \"%s\" cannot be found.",
            "MessageId": "123"
          },
          "Message": "The operation has failed due to some unknown error, exception or failure.",
          "Output": {
            "AmixList": {
              "Amix": [
                {
                  "AmixURL": "https://outpu***.oss-cn-shanghai.aliyuncs.com/mp4-to-mp3%5E1571025263578816%40.mp3",
                  "Duration": "20",
                  "Map": "0:a:0",
                  "MixDurMode": "long",
                  "Start": "0"
                }
              ]
            },
            "Audio": {
              "Bitrate": "128",
              "Channels": "6",
              "Codec": "aac",
              "Profile": "aac_low",
              "Qscale": "15",
              "Samplerate": "32000",
              "Volume": {
                "Level": "-20",
                "Method": "auto"
              }
            },
            "AudioStreamMap": "0:a:0",
            "Clip": {
              "TimeSpan": {
                "Duration": "01:00:59.999",
                "Seek": "01:59:59.999"
              }
            },
            "Container": {
              "Format": "flv"
            },
            "DeWatermark": "{\"0\": [{\"l\": 10,\"t\": 10,\"w\": 10,\"h\": 10},{\"l\": 100,\"t\": 0.1,\"w\": 10,\"h\": 10}],\"128000\": [],\"250000\": [{\"l\": 0.2,\"t\": 0.1,\"w\": 0.01,\"h\": 0.05}]}",
            "DigiWaterMark": {
              "Alpha": "1.0",
              "InputFile": {
                "Bucket": "example-bucket-****",
                "Location": "oss-cn-hangzhou",
                "Object": "example-intput.flv"
              },
              "Type": "Image"
            },
            "Encryption": {
              "Id": "31fa3c9ca8134f9cec2b4b0b0f78****",
              "Key": "encryptionkey128",
              "KeyType": "Base64",
              "KeyUri": "https://1161758785*****.cn-shanghai.fc.aliyuncs.com/2016-08-15/proxy/HLS-decyptServer/decyptServer/",
              "SkipCnt": "3",
              "Type": "hls-aes-128"
            },
            "M3U8NonStandardSupport": {
              "TS": {
                "Md5Support": true,
                "SizeSupport": true
              }
            },
            "MergeConfigUrl": "`{\"MergeList\":[{\"MergeURL\":\"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/video_01.mp4\"}]}",
            "MergeList": {
              "Merge": [
                {
                  "Duration": "00000.20",
                  "MergeURL": "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/example-object-****.flv",
                  "RoleArn": "acs:ram:::role/",
                  "Start": "00000.50"
                }
              ]
            },
            "MuxConfig": {
              "Gif": {
                "DitherMode": "bayer",
                "FinalDelay": "0",
                "IsCustomPalette": "false",
                "Loop": "0"
              },
              "Segment": {
                "Duration": "20"
              },
              "Webp": {
                "Loop": "0"
              }
            },
            "OpeningList": {
              "Opening": [
                {
                  "Height": "1080",
                  "Start": "1",
                  "Width": "1920",
                  "openUrl": "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv"
                }
              ]
            },
            "OutSubtitleList": {
              "OutSubtitle": [
                {
                  "Map": "0:v:0",
                  "Message": "The specified parameter “%s” cannot be null.",
                  "OutSubtitleFile": {
                    "Bucket": "example-bucket-****",
                    "Location": "oss-cn-hangzhou",
                    "Object": "example-output.flv",
                    "RoleArn": "acs:ram:::role/"
                  },
                  "Success": true
                }
              ]
            },
            "OutputFile": {
              "Bucket": "example-bucket-****",
              "Location": "oss-cn-hangzhou",
              "Object": "example-output.flv",
              "RoleArn": "acs:ram:::role/"
            },
            "Priority": "5",
            "Properties": {
              "Bitrate": "1000",
              "Duration": "55",
              "FileFormat": "QuickTime / MOV",
              "FileSize": "3509895",
              "Format": {
                "Bitrate": "1000",
                "Duration": "55",
                "FormatLongName": "QuickTime / MOV",
                "FormatName": "mov",
                "NumPrograms": "0",
                "NumStreams": "2",
                "Size": "3509895",
                "StartTime": "0.000000"
              },
              "Fps": "25",
              "Height": "720",
              "Streams": {
                "AudioStreamList": {
                  "AudioStream": [
                    {
                      "Bitrate": "128.806",
                      "ChannelLayout": "stereo",
                      "Channels": "2",
                      "CodecLongName": "AAC (Advanced Audio Coding)",
                      "CodecName": "aac",
                      "CodecTag": "0x6134706d",
                      "CodecTagString": "mp4a",
                      "CodecTimeBase": "1/44100",
                      "Duration": "17.159546",
                      "Index": "1",
                      "Lang": "eng",
                      "NumFrames": "25",
                      "SampleFmt": "fltp",
                      "Samplerate": "44100",
                      "StartTime": "0.000000",
                      "Timebase": "1/44100"
                    }
                  ]
                },
                "SubtitleStreamList": {
                  "SubtitleStream": [
                    {
                      "Index": "1",
                      "Lang": "eng"
                    }
                  ]
                },
                "VideoStreamList": {
                  "VideoStream": [
                    {
                      "AvgFPS": "23.976025",
                      "Bitrate": "1496.46",
                      "CodecLongName": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
                      "CodecName": "h264",
                      "CodecTag": "0x31637661",
                      "CodecTagString": "avc1",
                      "CodecTimeBase": "1001/48000",
                      "Dar": "16:9",
                      "Duration": "17.225542",
                      "Fps": "23.976025",
                      "HasBFrames": "2",
                      "Height": "720",
                      "Index": "0",
                      "Lang": "eng",
                      "Level": "51",
                      "NetworkCost": {
                        "AvgBitrate": "100",
                        "CostBandwidth": "10",
                        "PreloadTime": "8"
                      },
                      "NumFrames": "25",
                      "PixFmt": "yuv420p",
                      "Profile": "high",
                      "Sar": "1:1",
                      "StartTime": "0.000000",
                      "Timebase": "1/24000",
                      "Width": "1280"
                    }
                  ]
                }
              },
              "Width": "1280"
            },
            "Rotate": "180",
            "SubtitleConfig": {
              "ExtSubtitleList": {
                "ExtSubtitle": [
                  {
                    "CharEnc": "UTF-8",
                    "FontName": "\"WenQuanYi Zen Hei\", \"Yuanti SC Regular\", \"SimSun\"",
                    "Input": {
                      "Bucket": "example-bucket-****",
                      "Location": "oss-cn-hangzhou",
                      "Object": "example-output.flv"
                    }
                  }
                ]
              },
              "SubtitleList": {
                "Subtitle": [
                  {
                    "Map": "0:a:0"
                  }
                ]
              }
            },
            "SuperReso": {
              "IsHalfSample": "true"
            },
            "TailSlateList": {
              "TailSlate": [
                {
                  "BgColor": "White",
                  "BlendDuration": "2",
                  "Height": "1080",
                  "IsMergeAudio": false,
                  "Start": "1",
                  "TailUrl": "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv",
                  "Width": "1920"
                }
              ]
            },
            "TemplateId": "S00000000-000010",
            "TransConfig": {
              "AdjDarMethod": "crop",
              "IsCheckAudioBitrate": "false",
              "IsCheckAudioBitrateFail": "true",
              "IsCheckReso": "false",
              "IsCheckResoFail": "false",
              "IsCheckVideoBitrate": "false",
              "IsCheckVideoBitrateFail": "true",
              "TransMode": "onepass"
            },
            "UserData": "example data",
            "Video": {
              "Bitrate": "10",
              "BitrateBnd": {
                "Max": "20",
                "Min": "10"
              },
              "Bufsize": "1000",
              "Codec": "H.264",
              "Crf": "22",
              "Crop": "1280:800:0:140",
              "Degrain": "5",
              "Fps": "60",
              "Gop": "1",
              "Height": "1280",
              "MaxFps": "15",
              "Maxrate": "10",
              "Pad": "1280:800:0:140",
              "PixFmt": "yuvj420p",
              "Preset": "veryfast",
              "Profile": "baseline",
              "Qscale": "15",
              "ResoPriority": "1",
              "ScanMode": "interlaced",
              "Width": "1080"
            },
            "VideoStreamMap": "0:a:0",
            "WaterMarkConfigUrl": "http://example.com/configure",
            "WaterMarkList": {
              "WaterMark": [
                {
                  "Dx": "1",
                  "Dy": "1",
                  "Height": "1280",
                  "InputFile": {
                    "Bucket": "example-bucket",
                    "Location": "oss-cn-hangzhou",
                    "Object": "example-logo-****.png"
                  },
                  "ReferPos": "TopRight",
                  "Type": "Image",
                  "WaterMarkTemplateId": "88c6ca184c0e47098a5b665e2a12****",
                  "Width": "1080"
                }
              ]
            }
          },
          "Percent": 100,
          "PipelineId": "88c6ca184c0e47098a5b665e2a126797",
          "State": "Submitted"
        },
        "Message": "The specified parameter \"%s\" cannot be null.",
        "Success": true
      }
    ]
  },
  "RequestId": "25818875-5F78-4A45S71F6-D73936451234"
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。