SubmitTranscodeJob - Intelligent Media Services - Alibaba Cloud ドキュメントセンター

ソースファイル、出力フォーマット、および関連パラメーターを指定して、Intelligent Media Services にビデオまたはオーディオファイルのトランスコーディングジョブを送信します。

操作説明

この操作は 2025 年 12 月 31 日に廃止されます。代わりに SubmitMediaConvertJob - メディアトランスコーディングジョブの送信を呼び出してください。

今すぐお試しください

この 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 ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

ice:SubmitTranscodeJob

*すべてのリソース。

*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
Name	string	任意	ジョブの名前。	job-name
InputGroup	array<object>	必須	ジョブ入力グループ。単一の入力はトランスコーディングジョブを作成します。複数の入力は音声ストリームとビデオストリームのマージタスクを作成します。	job-name
	object	必須	ジョブ入力。
Type	string	必須	メディアオブジェクトタイプ。	OSS
Media	string	必須	メディア値。	oss://バケット/パス/to/video.mp4
InputUrl	string	任意	入力ストリームパス。このパラメーターは、Type が Media に設定されている場合にのみ有効で、メディアアセット内の特定のファイルを入力として指定できます。システムは、指定された inputUrl がメディアアセット内に存在するかどうかを確認します。	oss://バケット/パス/to/video.mp4
OutputGroup	array<object>	必須	タスクの出力グループ。	user-data
	array<object>	必須	タスクの出力。
Output	object	必須	出力メディアの構成。
Type	string	必須	メディアオブジェクトタイプ。	OSS
Media	string	必須	メディア値。	oss://バケット/パス/to/video.mp4
OutputUrl	string	任意	出力ストリームのパス。このパラメーターは、type が media に設定されている場合にのみ有効で、メディアアセット内の特定のファイルを出力として選択できます。サポートされるプレースホルダー: - {MediaId}: メディアアセット ID。 - {JobId}: トランスコーディングサブタスク ID。 - {ExtName}: ファイル拡張子。トランスコーディングテンプレートの出力フォーマットから取得されます。 - {DestMd5}: トランスコーディング出力ファイルの MD5 値。注意: 1. このパラメーターには {MediaId} と {JobId} の両方のプレースホルダーを含める必要があります。2. 出力バケットは MediaId が配置されているバケットと同じになります。	oss://バケット/パス/to/{MediaId}/{JobId}.mp4
ProcessConfig	object	必須	タスクの処理構成。
Transcode	object	必須	トランスコード中の構成。
TemplateId	string	必須	テンプレートの ID。	9547c6ad97cb4f2aaa29683ebd18d410
OverwriteParams	object	任意	オーバーライドパラメーター。指定された場合、これらのパラメーターは対応するテンプレートパラメーターを上書きします。
Video	object	任意	ビデオの設定。
Codec	string	任意	エンコード形式。	H.264
Profile	string	任意	エンコードプロファイル。	Main
Bitrate	string	任意	平均ビデオビットレート。有効な値: 10～50000。単位: Kbit/s。	3000
Crf	string	任意	ビットレート品質コントロール係数。有効な値: 0～51。デフォルト値: エンコード形式が H.264 の場合は 23、H.265 の場合は 26。	23
Width	string	任意	幅。有効な値: 128～4096。単位: px。デフォルト値: ビデオの元の幅。	1920
Height	string	任意	高さ。有効な値: 128～4096。単位: px。デフォルト値: ビデオの元の高さ。	1080
Fps	string	任意	フレームレート。有効な値: (0, 60]。デフォルト値: 入力ファイルのフレームレート。	25
Gop	string	任意	キーフレーム間の最大フレーム数。有効な値: 1～1080000。デフォルト値: 250。	250
Preset	string	任意	ビデオエンコーダープリセット。H.264 のみこのパラメーターをサポートします。	medium
ScanMode	string	任意	スキャンモード。	progressive
PixFmt	string	任意	ビデオピクセルフォーマット。	yuv420p
Remove	string	任意	ビデオストリームを削除するかどうかを指定します。	false
Crop	string	任意	ビデオクロッピングパラメーター。2 つのメソッドがサポートされています。	1280:800:0:140
Pad	string	任意	ビデオパディングパラメーター。形式: width:height:left:top。例: 1280:800:0:140。	1280:800:0:140
LongShortMode	string	任意	横縦自動適応（長短辺モード）を有効にするかどうかを指定します。	false
Bufsize	string	任意	バッファーサイズ。有効な値: 1000～128000。デフォルト値: 6000。単位: Kbit/s。	6000
Maxrate	string	任意	ピークビデオビットレート。有効な値: 10～50000。単位: Kbit/s。	9000
AbrMax	string	任意	ABR 最大値ビットレート。このパラメーターは Narrowband HD 1.0 にのみ効果があります。有効な値: 10～50000。単位: Kbit/s。	6000
Audio	object	任意	音声の設定。
Codec	string	任意	音声コーデックフォーマット。有効な値: AAC、MP3、VORBIS、FLAC。	AAC
Profile	string	任意	音声エンコーディングプリセット。	aac_low
Samplerate	string	任意	サンプルレート。デフォルト値: 44100。有効な値: 22050、32000、44100、48000、96000。単位: Hz。	44100
Bitrate	string	任意	出力ファイルの音声ビットレート。有効な値: 8～1000。単位: Kbit/s。デフォルト値: 128。	128
Channels	string	任意	音声チャンネルの数。	2
Remove	string	任意	音声ストリームを削除するかどうかを指定します。	false
Volume	object	任意	ボリュームコントロールの設定。
Method	string	任意	ボリューム調整メソッド。	auto
IntegratedLoudnessTarget	string	任意	ターゲットラウドネス。	-6
TruePeak	string	任意	ピークボリューム。	-1
LoudnessRangeTarget	string	任意	ラウドネスの有効値。	8
Container	object	任意	コンテナフォーマットの設定。
Format	string	任意	コンテナフォーマット。	mp4
MuxConfig	object	任意	マルチプレックスの設定。
Segment	object	任意	セグメントの設定。
Duration	string	任意	セグメント期間。	10
ForceSegTime	string	任意	強制セグメントの時間ポイント。	2,3
TransConfig	object	任意	条件付きのトランスコード中パラメーター。
TransMode	string	任意	動画トランスコーディングモード。有効な値:	onepass
IsCheckReso	string	任意	動画の解像度を確認するかどうかを指定します。IsCheckReso と IsCheckResoFail のいずれか一方のみ使用できます。IsCheckResoFail の優先度が高くなります。	true
IsCheckResoFail	string	任意	動画の解像度を確認するかどうかを指定します。IsCheckReso と IsCheckResoFail のいずれか一方のみ使用できます。このパラメーターの優先度が高くなります。	true
IsCheckVideoBitrate	string	任意	動画のビットレートを確認するかどうかを指定します。IsCheckVideoBitrate と IsCheckVideoBitrateFail のいずれか一方のみ使用できます。IsCheckVideoBitrateFail の優先度が高くなります。	true
IsCheckVideoBitrateFail	string	任意	動画のビットレートを確認するかどうかを指定します。IsCheckVideoBitrate と IsCheckVideoBitrateFail のいずれか一方のみ使用できます。このパラメーターの優先度が高くなります。	true
IsCheckAudioBitrate	string	任意	音声のビットレートを確認するかどうかを指定します。IsCheckAudioBitrate と IsCheckAudioBitrateFail のいずれか一方のみ使用できます。IsCheckAudioBitrateFail の優先度が高くなります。	true
IsCheckAudioBitrateFail	string	任意	音声のビットレートを確認するかどうかを指定します。IsCheckAudioBitrate と IsCheckAudioBitrateFail のいずれか一方のみ使用できます。このパラメーターの優先度が高くなります。	true
AdjDarMethod	string	任意	解像度の再書き込みに使用されるメソッド。このパラメーターは、Width と Height の両方が指定されている場合にのみ効果が適用されます。LongShortMode と併用できます。	none
ImageWatermarks	array<object>	任意	イメージウォーターマークの構成。
	array<object>	任意	イメージウォーターマークの構成。
TemplateId	string	必須	テンプレートの ID。	9547c6ad97cb4f2aaa29683ebd18d410
OverwriteParams	object	任意	オーバーライドパラメーター。指定された場合、これらのパラメーターは対応するテンプレートパラメーターを上書きします。
Width	string	任意	出力動画上のウォーターマークイメージの幅。	32
Height	string	任意	出力動画上のウォーターマークイメージの高さ。	32
Dx	string	任意	出力動画に対するウォーターマークイメージの水平オフセット。	10
Dy	string	任意	出力動画に対するウォーターマークイメージの垂直オフセット。	10
ReferPos	string	任意	ウォーターマークの位置。	TopLeft
Timeline	object	任意	動的ウォーターマーク表示時間の設定。
Start	string	任意	ウォーターマークが表示され始める時間。	00:00:05
Duration	string	任意	ウォーターマークが表示される持続時間。	ToEND
File	object	任意	ウォーターマークイメージファイル。
Type	string	任意	メディアオブジェクトタイプ。	OSS
Media	string	任意	メディア値。	oss://バケット/パス/to/video.mp4
TextWatermarks	array<object>	任意	テキストウォーターマークの構成。
	array<object>	任意	テキストウォーターマークの構成。
TemplateId	string	必須	テンプレートの ID。	9547c6ad97cb4f2aaa29683ebd18d410
OverwriteParams	object	任意	オーバーライドパラメーター。指定された場合、これらのパラメーターは対応するテンプレートパラメーターを上書きします。
Content	string	任意	ウォーターマークテキスト。Base64 エンコーディングは必須ではありません。文字列は UTF-8 でエンコードする必要があります。	テストウォーターマーク
FontName	string	任意	フォント名。デフォルト値: SimSun。	SimSun
FontColor	string	任意	フォントの色。	#006400
FontAlpha	string	任意	フォントの透明度。	1.0
Top	string	任意	テキストの上ページの余白。	10
Left	string	任意	テキストの左ページの余白。	10
FontSize	integer	任意	フォントサイズ。	16
BorderWidth	integer	任意	罫線の幅。	0
BorderColor	string	任意	罫線の色。	#006400
Adaptive	string	任意	出力動画のサイズに基づいてフォントサイズを調整するかどうかを指定します。true / false、デフォルト値: false。	false
Subtitles	array<object>	任意	字幕焼き込みの構成。
	array<object>	任意	字幕の焼き込み構成。
TemplateId	string	必須	テンプレートの ID。	9547c6ad97cb4f2aaa29683ebd18d410
OverwriteParams	object	任意	オーバーライドパラメーター。指定された場合、これらのパラメーターは対応するテンプレートパラメーターを上書きします。
Format	string	任意	字幕ファイルのフォーマット。	vtt
CharEnc	string	任意	ファイルのエンコーディングフォーマット。	UTF-8
File	object	任意	字幕ファイル。
Type	string	任意	メディアオブジェクトタイプ。	OSS
Media	string	任意	メディア値。	oss://バケット/パス/to/video.mp4
Encryption	object	任意	暗号化構成。
EncryptType	string	任意	暗号化のタイプ。有効な値:	PrivateEncryption
CipherText	string	任意	標準暗号化の鍵暗号文。	MTYi00NDU0LTg5O****
DecryptKeyUri	string	任意	標準暗号化の復号サービス URL。	https://sample.com/パス?CipherText=MTYi00NDU0LTg5O****
KeyServiceType	string	任意	標準暗号化のキーサービスタイプ。有効な値:	KMS
CombineConfigs	array<object>	任意	マルチ入力ストリーム結合構成。
	object	任意	ストリーム結合構成。
AudioIndex	string	必須	音声ストリームのインデックス。	0 or exclude
VideoIndex	string	必須	ビデオストリームのインデックス。	0 or exclude
Start	number	任意	入力ストリームの開始時刻。デフォルト値: 0。	0.0
Duration	number	任意	入力ストリームの持続時間。デフォルト値: ビデオの持続時間。	20.0
UserData	string	任意	JSON フォーマットのカスタム設定。値の長さは最大 512 バイトです。カスタムコールバック URL のセットがサポートされています。	user-data
ScheduleConfig	object	任意	タスクのスケジューリング情報。	job-name
PipelineId	string	任意	パイプラインの ID。	e37ebee5d98b4781897f6086e89f9c56
Priority	integer	任意	タスクの優先度。値が大きいほど優先度が高くなります。有効な値: 1～10。	5
ClientToken	string	任意	リクエストのべき等性を確保するために使用されるべき等性キー。	**12e8864746a0a398**

レスポンスフィールド

フィールド	型	説明	例
	object
RequestId	string	リクエスト ID。	31E30781-9495-5E2D-A84D-759B0A01E262
TranscodeParentJob	object	TranscodeParentJobWithSubJobDTO。
TranscodeJobList	array<object>	サブタスクのリスト。
	array<object>	サブタスクの詳細。
CreateTime	string	タスクが作成された時刻。	2022-01-12T08:49:41Z
Name	string	タスクの名前。	transcode-job
ParentJobId	string	親ジョブの ID。	8b2198504dd340b7b3c9842a74fc9baa
JobId	string	サブタスクの ID。	7d6a7e0d4db2457a8d45ff5d43e1bf0a
JobIndex	integer	ジョブ全体におけるサブタスクのインデックス番号。	0
InputGroup	array<object>	ジョブ入力グループ。単一の入力はトランスコーディングジョブを作成します。複数の入力は音声およびビデオストリームのマージジョブを作成します。
	object	ジョブ入力。
Type	string	メディアオブジェクトタイプ。	OSS
Media	string	メディア値。	oss://バケット/パス/to/video.mp4
InputUrl	string	入力ストリームのパス。このパラメーターは、Type が Media に設定されている場合にのみ有効で、メディアアセット内の特定のファイルを入力として指定できます。システムは、指定された inputUrl がメディアアセット内に存在するかどうかを確認します。	oss://バケット/パス/to/video.mp4
ProcessConfig	object	トランスコーディング構成。
Transcode	object	トランスコーディング構成。
TemplateId	string	テンプレートの ID。	9547c6ad97cb4f2aaa29683ebd18d410
OverwriteParams	object	オーバーライドパラメーター。指定された場合、これらのパラメーターは対応するテンプレートパラメーターを上書きします。
Video	object	ビデオの設定。
Codec	string	エンコード形式。	H.264
Profile	string	エンコードプロファイル。	Main
Bitrate	string	平均ビデオビットレート。	3000
Crf	string	ビットレート品質コントロール係数。	23
Width	string	幅。	1920
Height	string	高さ。	1080
Fps	string	フレームレート。	25
Gop	string	キーフレーム間の最大フレーム数。	250
Preset	string	ビデオエンコーダープリセット。H.264 のみこのパラメーターをサポートします。	medium
ScanMode	string	スキャンモード。	progressive
PixFmt	string	ビデオピクセルフォーマット。	yuv420p
Remove	string	ビデオストリームを削除するかどうかを指定します。	false
Crop	string	ビデオクロッピング設定。2 つのメソッドのセットがサポートされています。	1280:800:0:140
Pad	string	ビデオパディング設定。	1280:800:0:140
LongShortMode	string	横縦自動適応（長短辺モード）を有効にするかどうかを指定します。	false
Bufsize	string	バッファーサイズ。	6000
Maxrate	string	ピークビデオビットレート。	9000
AbrMax	string	ABR の最大値ビットレート。このパラメーターは Narrowband HD 1.0 でのみ有効です。	6000
Audio	object	音声の設定。
Codec	string	音声コーデックフォーマット。有効な値: AAC、MP3、VORBIS、FLAC。	AAC
Profile	string	音声エンコーディングプリセット。	aac_low
Samplerate	string	サンプルレート。	44100
Bitrate	string	出力ファイルの音声ビットレート。	128
Channels	string	音声チャンネルの数。	2
Remove	string	音声ストリームを削除するかどうかを指定します。	false
Volume	object	ボリュームコントロールの設定。
Method	string	ボリューム調整メソッド。	auto
IntegratedLoudnessTarget	string	ターゲットラウドネス。	-6
TruePeak	string	ピークボリューム。	-1
LoudnessRangeTarget	string	ラウドネス有効値。	8
Container	object	コンテナフォーマットの設定。
Format	string	コンテナフォーマット。	mp4
MuxConfig	object	マルチプレックスの設定。
Segment	object	セグメントの設定。
Duration	string	セグメント期間。	10
ForceSegTime	string	強制セグメント時間ポイント。	2,3
TransConfig	object	条件付きのトランスコード中パラメーター。
TransMode	string	動画トランスコーディングモード。有効な値:	onepass
IsCheckReso	string	動画の解像度を確認するかどうかを指定します。IsCheckReso と IsCheckResoFail のいずれか一方のみ使用できます。IsCheckResoFail の優先度が高くなります。	true
IsCheckResoFail	string	動画の解像度を確認するかどうかを指定します。IsCheckReso と IsCheckResoFail のいずれか一方のみ使用できます。このパラメーターの優先度が高くなります。	true
IsCheckVideoBitrate	string	動画のビットレートを確認するかどうかを指定します。IsCheckVideoBitrate と IsCheckVideoBitrateFail のいずれか一方のみ使用できます。IsCheckVideoBitrateFail の優先度が高くなります。	true
IsCheckVideoBitrateFail	string	動画のビットレートを確認するかどうかを指定します。IsCheckVideoBitrate と IsCheckVideoBitrateFail のいずれか一方のみ使用できます。このパラメーターの優先度が高くなります。	true
IsCheckAudioBitrate	string	音声のビットレートを確認するかどうかを指定します。IsCheckAudioBitrate と IsCheckAudioBitrateFail のいずれか一方のみ使用できます。IsCheckAudioBitrateFail の優先度が高くなります。	true
IsCheckAudioBitrateFail	string	音声のビットレートを確認するかどうかを指定します。IsCheckAudioBitrate と IsCheckAudioBitrateFail のいずれか一方のみ使用できます。このパラメーターの優先度が高くなります。	true
AdjDarMethod	string	解像度の再書き込みに使用されるメソッド。このパラメーターは、Width と Height の両方が指定されている場合にのみ効果が適用されます。LongShortMode と併用できます。	none
ImageWatermarks	array<object>	イメージウォーターマークの構成。
	array<object>	イメージウォーターマークの構成。
TemplateId	string	テンプレートの ID。	9547c6ad97cb4f2aaa29683ebd18d410
OverwriteParams	object	オーバーライドパラメーター。指定された場合、これらのパラメーターは対応するテンプレートパラメーターを上書きします。
Width	string	出力動画上のウォーターマークイメージの幅。	32
Height	string	出力動画上のウォーターマークイメージの高さ。	32
Dx	string	出力動画に対するウォーターマークイメージの水平オフセット。	10
Dy	string	出力動画に対するウォーターマークイメージの垂直オフセット。	10
ReferPos	string	ウォーターマークの位置。	TopLeft
Timeline	object	動的ウォーターマーク表示時間の設定。
Start	string	ウォーターマークが表示され始める時間。	00:00:05
Duration	string	ウォーターマークが表示される持続時間。	ToEND
File	object	ウォーターマークイメージファイル。
Type	string	メディアオブジェクトタイプ。	OSS
Media	string	メディア値。	oss://バケット/パス/to/video.mp4
TextWatermarks	array<object>	テキストウォーターマークの構成。
	array<object>	テキストウォーターマークの構成。
TemplateId	string	テンプレートの ID。	9547c6ad97cb4f2aaa29683ebd18d410
OverwriteParams	object	オーバーライドパラメーター。指定した場合、これらのパラメーターはテンプレート内の対応するパラメーターを上書きします。
Content	string	ウォーターマークテキスト。Base64 エンコーディングは必須ではありません。文字列は UTF-8 でエンコードする必要があります。	テストウォーターマーク
FontName	string	フォント名。デフォルト値: SimSun。	SimSun
FontColor	string	フォントの色。	#006400
FontAlpha	string	フォントの透明度。	1.0
Top	string	テキストの上ページの余白。	10
Left	string	テキストの左ページの余白。	10
FontSize	integer	フォントサイズ。	16
BorderWidth	integer	罫線の幅。	0
BorderColor	string	罫線の色。	#006400
Adaptive	string	出力動画のサイズに基づいてフォントサイズを調整するかどうかを指定します。true / false、デフォルト値: false。	false
Subtitles	array<object>	字幕焼き込みの構成。
	array<object>	字幕焼き込みの構成。
TemplateId	string	テンプレートの ID。	9547c6ad97cb4f2aaa29683ebd18d410
OverwriteParams	object	オーバーライドパラメーター。指定された場合、これらのパラメーターは対応するテンプレートパラメーターを上書きします。
Format	string	字幕ファイルのファイル形式。	vtt
CharEnc	string	ファイルのエンコーディングフォーマット。	UTF-8
File	object	字幕ファイル。
Type	string	メディアオブジェクトタイプ。	OSS
Media	string	メディア値。	oss://bucket/path/to/video.mp4
Encryption	object	暗号化構成。
EncryptType	string	暗号化タイプ。	PrivateEncryption
CipherText	string	標準暗号化の鍵暗号文。	MTYi00NDU0LTg5O****
DecryptKeyUri	string	標準暗号化の復号サービス URL。	https://sample.com/path?CipherText=MTYi00NDU0LTg5O****
KeyServiceType	string	キーサービスタイプ。現在、KMS と Base64 のみがサポートされています。	KMS
CombineConfigs	array<object>	マルチ入力ストリームマージ構成。
	object	ストリームマージ構成。
AudioIndex	string	音声ストリームのインデックス。	0 or exclude
VideoIndex	string	ビデオストリームのインデックス。	0 or exclude
Start	number	入力ストリームの開始時刻。デフォルト値: 0。	0.0
Duration	number	入力ストリームの持続時間。デフォルト値: ビデオの持続時間。	20.0
Output	object	出力メディア構成。
Type	string	メディアオブジェクトタイプ。	OSS
Media	string	メディア値。	oss://bucket/path/to/video.mp4
OutputUrl	string	出力ストリームのパス。このパラメーターは type が media に設定されている場合にのみ有効で、メディアアセット内の特定のファイルを出力として選択できます。サポートされるプレースホルダー: - {MediaId}: メディアアセット ID。 - {JobId}: トランスコーディングサブタスク ID。 - {ExtName}: ファイル拡張子。トランスコーディングテンプレートの出力形式によって決定されます。 - {DestMd5}: トランスコーディング出力ファイルの MD5 ハッシュ値。注意: 1. このパラメーターには {MediaId} と {JobId} の両方のプレースホルダーを含める必要があります。2. 出力バケットは MediaId が存在するバケットと同じになります。	oss://bucket/path/to/{MediaId}/{JobId}.mp4
UserData	string	ユーザーデータ。	user-data
ScheduleConfig	object	タスクのスケジューリングフォーマット。
PipelineId	string	パイプラインの ID。	e37ebee5d98b4781897f6086e89f9c56
Priority	integer	タスクの優先度。値が大きいほど優先度が高くなります。有効な値: 1～10。	5
Status	string	トランスコーディングジョブのステータス。	Init
OutFileMeta	object	タスクによって生成された出力ビデオのメディア情報（フォーマット、レートなど）。
FileBasicInfo	object	基本ファイル情報（フォーマットを含む）。
MediaId	string	メディアアセットの ID。	73e07de0f77171eca3fc7035d0b26402
FileName	string	ファイル名。	file.m3u8
FileStatus	string	ファイルのステータス。	Normal
FileType	string	ファイルタイプ。有効な値: source_file、transcode_file。	source_file
FileSize	string	ファイルサイズ。単位: バイト。	31737
FileUrl	string	ファイルの URL。	http://bucket.oss-cn-shanghai.aliyuncs.com/path/to/file.m3u8
Region	string	ファイルが保存されているリージョン。	cn-shanghai
FormatName	string	ビデオフォーマット名。	hls,applehttp
Duration	string	ビデオの持続時間。単位: 秒。	403.039999
Bitrate	string	ビデオのビットレート。	888.563
Width	string	幅。	848
Height	string	高さ。	478
AudioStreamInfoList	array<object>	音声ストリームの情報。
	object	音声ストリームの情報。
Index	string	ストリームのインデックス。	1
CodecName	string	エンコード形式。	aac
CodecLongName	string	コーデックフォーマット名。	AAC (Advanced Audio Coding)
CodecTimeBase	string	コーデックの時間ベース。	1/44100
CodecTagString	string	コーデックタグ文字列。	[15][0][0][0]
CodecTag	string	コーデックタグ。	0x000f
SampleFmt	string	サンプルフォーマット。	fltp
SampleRate	string	サンプルレート。単位: Hz。	44100
Channels	string	音声チャンネルの数。	2
ChannelLayout	string	チャンネルレイアウト。	stereo
Timebase	string	時間ベース。	1/90000
StartTime	string	開始時刻。	1.473556
Duration	string	持続時間。単位: 秒。	403.039989
Bitrate	string	ビットレート。	0.f
Lang	string	言語。	cn
VideoStreamInfoList	array<object>	ビデオストリームの情報。
	object	ビデオストリームの情報。
Index	string	ストリームのインデックス。	0
Codec_name	string	エンコード形式。	h264
Codec_long_name	string	コーデックフォーマット名。	H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10
Profile	string	コーデックプロファイル。	High
Codec_time_base	string	コーデックの時間ベース。	1/50
Codec_tag_string	string	コーデックタグ文字列。	[27][0][0][0]
Codec_tag	string	コーデックタグ。	0x001b
Width	string	幅。	848
Height	string	高さ。	478
Has_b_frames	string	ビデオに B フレームが含まれているかどうかを示します。	2
Sar	string	サンプル縦横比 (SAR)。	478:477
Dar	string	表示縦横比 (DAR)。	16:9
PixFmt	string	ピクセルフォーマット。	yuv420p
Level	string	コーデックレベル。	31
Fps	string	フレームレート。	25.0
Avg_fps	string	平均フレームレート。	25.0
Time_base	string	時間ベース。	1/90000
Start_time	string	開始時刻。	1.473556
Duration	string	持続時間。単位: 秒。	403.039989
Bit_rate	string	ビットレート。	888.563
NumFrames	string	総フレーム数。	10040
Lang	string	言語。	cn
Rotate	string	ビデオの回転角度。	0
SubmitResultJson	object	タスクの送信結果。	{}
SubmitTime	string	タスクの送信時間。	2022-01-12T08:49:41Z
FinishTime	string	タスクの完了時間。	2022-01-12T08:49:41Z
RequestId	string	タスク送信時に返されたリクエスト ID。	31E30781-9495-5E2D-A84D-759B0A01E262
CreateTime	string	タスクの作成時間。時間は yyyy-MM-ddTHH:mm:ssZ フォーマットです。	2022-01-12T08:49:41Z
Name	string	タスク名。	transcode-job
RequestId	string	タスク送信時に返されたリクエスト ID。	31E30781-9495-5E2D-A84D-759B0A01E262
ParentJobId	string	親ジョブの ID。	8b2198504dd340b7b3c9842a74fc9baa
JobCount	integer	サブタスクの数。	1
Status	string	タスクのステータス。有効な値:	Success
TriggerSource	string	タスクのソース。有効な値:	API
Percent	integer	タスクの完了率。	0
SubmitTime	string	タスクの送信時間。時間は yyyy-MM-ddTHH:mm:ssZ フォーマットです。	2022-01-12T08:49:41Z
FinishTime	string	タスクの完了時間。時間は yyyy-MM-ddTHH:mm:ssZ フォーマットです。	2022-01-12T08:49:41Z
InputGroup	array<object>	ジョブ入力のグループ。単一の入力はトランスコーディングジョブを作成します。複数の入力は音声ストリームおよびビデオストリームのマージタスクを作成します。
	object	ジョブ入力。
Type	string	メディアオブジェクトタイプ。	OSS
Media	string	メディア値。	oss://バケット/パス/to/video.mp4
OutputGroup	array<object>	タスクの出力グループ。
	array<object>	タスクの出力。
Output	object	出力メディア構成。
Type	string	メディアオブジェクトタイプ。	OSS
Media	string	メディア値。	oss://バケット/パス/to/video.mp4
ProcessConfig	object	タスクの処理構成。
Transcode	object	トランスコード中の構成。
TemplateId	string	テンプレートの ID。	9547c6ad97cb4f2aaa29683ebd18d410
OverwriteParams	object	オーバーライドパラメーター。指定された場合、これらのパラメーターは対応するテンプレートパラメーターを上書きします。
Video	object	ビデオの設定。
Codec	string	エンコード形式。	H.264
Profile	string	エンコードプロファイル。	Main
Bitrate	string	平均ビデオビットレート。	3000
Crf	string	ビットレート品質コントロール係数。	23
Width	string	幅。	1920
Height	string	高さ。	1080
Fps	string	フレームレート。	25
Gop	string	キーフレーム間の最大フレーム数。	250
Preset	string	ビデオエンコーダープリセット。H.264 のみこのパラメーターをサポートします。	medium
ScanMode	string	スキャンモード。	progressive
PixFmt	string	ビデオピクセルフォーマット。	yuv420p
Remove	string	ビデオストリームを削除するかどうかを指定します。	false
Crop	string	ビデオのクロップ設定。	1280:800:0:140
Pad	string	ビデオのパディング（黒罫線）設定。	1280:800:0:140
LongShortMode	string	横縦自動適応（長短辺モード）を有効にするかどうかを指定します。	false
Bufsize	string	バッファーサイズ。	6000
Maxrate	string	ピークビデオビットレート。	9000
AbrMax	string	ABR の最大ビットレート。このパラメーターは Narrowband HD 1.0 にのみ効果があります。	6000
Audio	object	音声の設定。
Codec	string	音声コーデックフォーマット。有効な値: AAC、MP3、VORBIS、FLAC。	AAC
Profile	string	音声エンコーディングプリセット。	aac_low
Samplerate	string	サンプルレート。	44100
Bitrate	string	出力ファイルの音声ビットレート。	128
Channels	string	音声チャンネルの数。	2
Remove	string	音声ストリームを削除するかどうかを指定します。	false
Volume	object	ボリュームコントロールの設定。
Method	string	ボリュームの調整メソッド。	auto
IntegratedLoudnessTarget	string	ターゲットラウドネス。	-6
TruePeak	string	ピークボリューム。	-1
LoudnessRangeTarget	string	ラウドネスの範囲。	8
Container	object	コンテナフォーマットの設定。
Format	string	コンテナフォーマット。	mp4
MuxConfig	object	マルチプレックスの設定。
Segment	object	セグメントの設定。
Duration	string	セグメントの持続時間。	10
ForceSegTime	string	強制的にセグメントを分割する時間ポイント。	2,3
TransConfig	object	条件付きのトランスコード中パラメーター。
TransMode	string	動画トランスコーディングモード。有効な値:	onepass
IsCheckReso	string	動画の解像度を確認するかどうかを指定します。IsCheckReso と IsCheckResoFail のいずれか一方のみ使用できます。IsCheckResoFail の優先度が高くなります。	true
IsCheckResoFail	string	動画の解像度を確認するかどうかを指定します。IsCheckReso と IsCheckResoFail のいずれか一方のみ使用できます。このパラメーターの優先度が高くなります。	true
IsCheckVideoBitrate	string	動画のビットレートを確認するかどうかを指定します。IsCheckVideoBitrate と IsCheckVideoBitrateFail のいずれか一方のみ使用できます。IsCheckVideoBitrateFail の優先度が高くなります。	true
IsCheckVideoBitrateFail	string	動画のビットレートを確認するかどうかを指定します。IsCheckVideoBitrate と IsCheckVideoBitrateFail のいずれか一方のみ使用できます。このパラメーターの優先度が高くなります。	true
IsCheckAudioBitrate	string	音声のビットレートを確認するかどうかを指定します。IsCheckAudioBitrate と IsCheckAudioBitrateFail のいずれか一方のみ使用できます。IsCheckAudioBitrateFail の優先度が高くなります。	true
IsCheckAudioBitrateFail	string	音声のビットレートを確認するかどうかを指定します。IsCheckAudioBitrate と IsCheckAudioBitrateFail のいずれか一方のみ使用できます。このパラメーターの優先度が高くなります。	true
AdjDarMethod	string	解像度の再書き込みに使用されるメソッド。このパラメーターは Width と Height の両方が指定されている場合にのみ効果があります。LongShortMode と併用できます。	none
ImageWatermarks	array<object>	イメージウォーターマークの構成。
	array<object>	イメージウォーターマークの構成。
TemplateId	string	テンプレートの ID。	9547c6ad97cb4f2aaa29683ebd18d410
OverwriteParams	object	オーバーライドパラメーター。指定された場合、これらのパラメーターは対応するテンプレートパラメーターを上書きします。
Width	string	出力ビデオ上のウォーターマークイメージの幅。	32
Height	string	出力動画のウォーターマークイメージの高さ。	32
Dx	string	出力動画に対するウォーターマークイメージの水平オフセット。	10
Dy	string	出力動画に対するウォーターマークイメージの垂直オフセット。	10
ReferPos	string	ウォーターマークの位置。	TopLeft
Timeline	object	動的ウォーターマーク表示時間の設定。
Start	string	ウォーターマークが表示される開始時刻。	00:00:05
Duration	string	ウォーターマークが表示される持続時間。	ToEND
File	object	ウォーターマークイメージファイル。
Type	string	メディアオブジェクトタイプ。	OSS
Media	string	メディア値。	oss://バケット/パス/to/video.mp4
TextWatermarks	array<object>	テキストウォーターマークの構成。
	array<object>	テキストウォーターマークの構成。
TemplateId	string	テンプレートの ID。	9547c6ad97cb4f2aaa29683ebd18d410
OverwriteParams	object	オーバーライドパラメーター。指定された場合、これらのパラメーターは対応するテンプレートパラメーターを上書きします。
Content	string	ウォーターマークテキスト。Base64 エンコーディングは必須ではありません。文字列は UTF-8 でエンコードする必要があります。	テストウォーターマーク
FontName	string	フォント名。デフォルト値: SimSun。	SimSun
FontColor	string	フォントの色。	#006400
FontAlpha	string	フォントの透明度。	1.0
Top	string	テキストの上ページの余白。	10
Left	string	テキストの左ページの余白。	10
FontSize	integer	フォントサイズ。	16
BorderWidth	integer	罫線の幅。	0
BorderColor	string	罫線の色。	#006400
Adaptive	string	出力動画のサイズに基づいてフォントサイズを調整します。	false
Subtitles	array<object>	字幕焼き込みの構成。
	array<object>	字幕焼き込みの構成。
TemplateId	string	テンプレートの ID。	9547c6ad97cb4f2aaa29683ebd18d410
OverwriteParams	object	オーバーライドパラメーター。指定された場合、これらのパラメーターは対応するテンプレートパラメーターを上書きします。
Format	string	字幕ファイル形式。	vtt
CharEnc	string	ファイルエンコーディングフォーマット。	UTF-8
File	object	字幕ファイル。
Type	string	メディアオブジェクトタイプ。	OSS
Media	string	メディア値。	oss://バケット/パス/to/video.mp4
Encryption	object	暗号化構成。
EncryptType	string	暗号化タイプ。	PrivateEncryption
CipherText	string	標準暗号化の鍵暗号文。	MTYi00NDU0LTg5O****
DecryptKeyUri	string	標準暗号化の復号サービス URL。	https://sample.com/パス?CipherText=MTYi00NDU0LTg5O****
KeyServiceType	string	キーサービスタイプ。現在、KMS と Base64 のみがサポートされています。	KMS
CombineConfigs	array<object>	マルチ入力ストリームマージ構成。
	object	マルチ入力ストリームマージ構成。
AudioIndex	string	音声ストリームのインデックス。	0 or exclude
VideoIndex	string	ビデオストリームのインデックス。	0 or exclude
Start	number	入力ストリームの開始時刻。デフォルト値: 0。	0.0
Duration	number	入力ストリームの持続時間。デフォルト値: ビデオの持続時間。	20.0
UserData	string	ユーザーデータ。	user-data
ScheduleConfig	object	タスクのスケジューリング構成。
PipelineId	string	パイプラインの ID。	e37ebee5d98b4781897f6086e89f9c56
Priority	integer	タスクの優先度。値が大きいほど優先度が高くなります。有効な値: 1～10。	5

例

成功レスポンス

JSONJSON

{
  "RequestId": "31E30781-9495-5E2D-A84D-759B0A01E262",
  "TranscodeParentJob": {
    "TranscodeJobList": [
      {
        "CreateTime": "2022-01-12T08:49:41Z",
        "Name": "transcode-job",
        "ParentJobId": "8b2198504dd340b7b3c9842a74fc9baa",
        "JobId": "7d6a7e0d4db2457a8d45ff5d43e1bf0a",
        "JobIndex": 0,
        "InputGroup": [
          {
            "Type": "OSS",
            "Media": "oss://バケット/パス/to/video.mp4",
            "InputUrl": "oss://バケット/パス/to/video.mp4"
          }
        ],
        "ProcessConfig": {
          "Transcode": {
            "TemplateId": "9547c6ad97cb4f2aaa29683ebd18d410",
            "OverwriteParams": {
              "Video": {
                "Codec": "H.264",
                "Profile": "Main",
                "Bitrate": "3000",
                "Crf": "23",
                "Width": "1920",
                "Height": "1080",
                "Fps": "25",
                "Gop": "250",
                "Preset": "medium",
                "ScanMode": "progressive",
                "PixFmt": "yuv420p",
                "Remove": "false",
                "Crop": "1280:800:0:140",
                "Pad": "1280:800:0:140",
                "LongShortMode": "false",
                "Bufsize": "6000",
                "Maxrate": "9000",
                "AbrMax": "6000"
              },
              "Audio": {
                "Codec": "AAC",
                "Profile": "aac_low",
                "Samplerate": "44100",
                "Bitrate": "128",
                "Channels": "2",
                "Remove": "false",
                "Volume": {
                  "Method": "auto",
                  "IntegratedLoudnessTarget": "-6",
                  "TruePeak": "-1",
                  "LoudnessRangeTarget": "8"
                }
              },
              "Container": {
                "Format": "mp4"
              },
              "MuxConfig": {
                "Segment": {
                  "Duration": "10",
                  "ForceSegTime": "2,3"
                }
              },
              "TransConfig": {
                "TransMode": "onepass",
                "IsCheckReso": "true",
                "IsCheckResoFail": "true",
                "IsCheckVideoBitrate": "true",
                "IsCheckVideoBitrateFail": "true",
                "IsCheckAudioBitrate": "true",
                "IsCheckAudioBitrateFail": "true",
                "AdjDarMethod": "none"
              }
            }
          },
          "ImageWatermarks": [
            {
              "TemplateId": "9547c6ad97cb4f2aaa29683ebd18d410",
              "OverwriteParams": {
                "Width": "32",
                "Height": "32",
                "Dx": "10",
                "Dy": "10",
                "ReferPos": "TopLeft",
                "Timeline": {
                  "Start": "00:00:05",
                  "Duration": "ToEND"
                },
                "File": {
                  "Type": "OSS",
                  "Media": "oss://バケット/パス/to/video.mp4"
                }
              }
            }
          ],
          "TextWatermarks": [
            {
              "TemplateId": "9547c6ad97cb4f2aaa29683ebd18d410",
              "OverwriteParams": {
                "Content": "テストウォーターマーク",
                "FontName": "SimSun",
                "FontColor": "#006400",
                "FontAlpha": "1.0",
                "Top": "10",
                "Left": "10",
                "FontSize": 16,
                "BorderWidth": 0,
                "BorderColor": "#006400",
                "Adaptive": "false"
              }
            }
          ],
          "Subtitles": [
            {
              "TemplateId": "9547c6ad97cb4f2aaa29683ebd18d410",
              "OverwriteParams": {
                "Format": "vtt",
                "CharEnc": "UTF-8",
                "File": {
                  "Type": "OSS",
                  "Media": "oss://bucket/path/to/video.mp4"
                }
              }
            }
          ],
          "Encryption": {
            "EncryptType": "PrivateEncryption",
            "CipherText": "MTYi00NDU0LTg5O****",
            "DecryptKeyUri": "https://sample.com/path?CipherText=MTYi00NDU0LTg5O****",
            "KeyServiceType": "KMS"
          },
          "CombineConfigs": [
            {
              "AudioIndex": "0 or exclude",
              "VideoIndex": "0 or exclude",
              "Start": 0,
              "Duration": 20
            }
          ]
        },
        "Output": {
          "Type": "OSS",
          "Media": "oss://bucket/path/to/video.mp4",
          "OutputUrl": "oss://bucket/path/to/{MediaId}/{JobId}.mp4"
        },
        "UserData": "user-data",
        "ScheduleConfig": {
          "PipelineId": "e37ebee5d98b4781897f6086e89f9c56",
          "Priority": 5
        },
        "Status": "Init",
        "OutFileMeta": {
          "FileBasicInfo": {
            "MediaId": "73e07de0f77171eca3fc7035d0b26402",
            "FileName": "file.m3u8",
            "FileStatus": "Normal",
            "FileType": "source_file",
            "FileSize": "31737",
            "FileUrl": "http://bucket.oss-cn-shanghai.aliyuncs.com/path/to/file.m3u8",
            "Region": "cn-shanghai",
            "FormatName": "hls,applehttp",
            "Duration": "403.039999",
            "Bitrate": "888.563",
            "Width": "848",
            "Height": "478"
          },
          "AudioStreamInfoList": [
            {
              "Index": "1",
              "CodecName": "aac",
              "CodecLongName": "AAC (Advanced Audio Coding)",
              "CodecTimeBase": "1/44100",
              "CodecTagString": "[15][0][0][0]",
              "CodecTag": "0x000f",
              "SampleFmt": "fltp",
              "SampleRate": "44100",
              "Channels": "2",
              "ChannelLayout": "stereo",
              "Timebase": "1/90000",
              "StartTime": "1.473556",
              "Duration": "403.039989",
              "Bitrate": "0.f",
              "Lang": "cn"
            }
          ],
          "VideoStreamInfoList": [
            {
              "Index": "0",
              "Codec_name": "h264",
              "Codec_long_name": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
              "Profile": "High",
              "Codec_time_base": "1/50",
              "Codec_tag_string": "[27][0][0][0]",
              "Codec_tag": "0x001b",
              "Width": "848",
              "Height": "478",
              "Has_b_frames": "2",
              "Sar": "478:477",
              "Dar": "16:9",
              "PixFmt": "yuv420p",
              "Level": "31",
              "Fps": "25.0",
              "Avg_fps": "25.0",
              "Time_base": "1/90000",
              "Start_time": "1.473556",
              "Duration": "403.039989",
              "Bit_rate": "888.563",
              "NumFrames": "10040",
              "Lang": "cn",
              "Rotate": "0"
            }
          ]
        },
        "SubmitResultJson": {},
        "SubmitTime": "2022-01-12T08:49:41Z",
        "FinishTime": "2022-01-12T08:49:41Z",
        "RequestId": "31E30781-9495-5E2D-A84D-759B0A01E262"
      }
    ],
    "CreateTime": "2022-01-12T08:49:41Z",
    "Name": "transcode-job",
    "RequestId": "31E30781-9495-5E2D-A84D-759B0A01E262",
    "ParentJobId": "8b2198504dd340b7b3c9842a74fc9baa",
    "JobCount": 1,
    "Status": "Success",
    "TriggerSource": "API",
    "Percent": 0,
    "SubmitTime": "2022-01-12T08:49:41Z",
    "FinishTime": "2022-01-12T08:49:41Z",
    "InputGroup": [
      {
        "Type": "OSS",
        "Media": "oss://バケット/パス/to/video.mp4"
      }
    ],
    "OutputGroup": [
      {
        "Output": {
          "Type": "OSS",
          "Media": "oss://バケット/パス/to/video.mp4"
        },
        "ProcessConfig": {
          "Transcode": {
            "TemplateId": "9547c6ad97cb4f2aaa29683ebd18d410",
            "OverwriteParams": {
              "Video": {
                "Codec": "H.264",
                "Profile": "Main",
                "Bitrate": "3000",
                "Crf": "23",
                "Width": "1920",
                "Height": "1080",
                "Fps": "25",
                "Gop": "250",
                "Preset": "medium",
                "ScanMode": "progressive",
                "PixFmt": "yuv420p",
                "Remove": "false",
                "Crop": "1280:800:0:140",
                "Pad": "1280:800:0:140",
                "LongShortMode": "false",
                "Bufsize": "6000",
                "Maxrate": "9000",
                "AbrMax": "6000"
              },
              "Audio": {
                "Codec": "AAC",
                "Profile": "aac_low",
                "Samplerate": "44100",
                "Bitrate": "128",
                "Channels": "2",
                "Remove": "false",
                "Volume": {
                  "Method": "auto",
                  "IntegratedLoudnessTarget": "-6",
                  "TruePeak": "-1",
                  "LoudnessRangeTarget": "8"
                }
              },
              "Container": {
                "Format": "mp4"
              },
              "MuxConfig": {
                "Segment": {
                  "Duration": "10",
                  "ForceSegTime": "2,3"
                }
              },
              "TransConfig": {
                "TransMode": "onepass",
                "IsCheckReso": "true",
                "IsCheckResoFail": "true",
                "IsCheckVideoBitrate": "true",
                "IsCheckVideoBitrateFail": "true",
                "IsCheckAudioBitrate": "true",
                "IsCheckAudioBitrateFail": "true",
                "AdjDarMethod": "none"
              }
            }
          },
          "ImageWatermarks": [
            {
              "TemplateId": "9547c6ad97cb4f2aaa29683ebd18d410",
              "OverwriteParams": {
                "Width": "32",
                "Height": "32",
                "Dx": "10",
                "Dy": "10",
                "ReferPos": "TopLeft",
                "Timeline": {
                  "Start": "00:00:05",
                  "Duration": "ToEND"
                },
                "File": {
                  "Type": "OSS",
                  "Media": "oss://バケット/パス/to/video.mp4"
                }
              }
            }
          ],
          "TextWatermarks": [
            {
              "TemplateId": "9547c6ad97cb4f2aaa29683ebd18d410",
              "OverwriteParams": {
                "Content": "テストウォーターマーク",
                "FontName": "SimSun",
                "FontColor": "#006400",
                "FontAlpha": "1.0",
                "Top": "10",
                "Left": "10",
                "FontSize": 16,
                "BorderWidth": 0,
                "BorderColor": "#006400",
                "Adaptive": "false"
              }
            }
          ],
          "Subtitles": [
            {
              "TemplateId": "9547c6ad97cb4f2aaa29683ebd18d410",
              "OverwriteParams": {
                "Format": "vtt",
                "CharEnc": "UTF-8",
                "File": {
                  "Type": "OSS",
                  "Media": "oss://バケット/パス/to/video.mp4"
                }
              }
            }
          ],
          "Encryption": {
            "EncryptType": "PrivateEncryption",
            "CipherText": "MTYi00NDU0LTg5O****",
            "DecryptKeyUri": "https://sample.com/パス?CipherText=MTYi00NDU0LTg5O****",
            "KeyServiceType": "KMS"
          },
          "CombineConfigs": [
            {
              "AudioIndex": "0 or exclude",
              "VideoIndex": "0 or exclude",
              "Start": 0,
              "Duration": 20
            }
          ]
        }
      }
    ],
    "UserData": "user-data",
    "ScheduleConfig": {
      "PipelineId": "e37ebee5d98b4781897f6086e89f9c56",
      "Priority": 5
    }
  }
}

エラーコード

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

変更履歴

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