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

単一のトランスコーディングジョブの詳細を照会します。

操作説明

この API は非推奨です。代わりに GetMediaConvertJob – メディアトランスコーディングジョブの照会を呼び出してください。

今すぐお試しください

この 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:GetTranscodeJob

*All Resource

*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
ParentJobId	string	必須	ジョブ ID。	ab4802364a2e49208c99efab82dfa8e8

レスポンスフィールド

フィールド	型	説明	例
	object	応答。
RequestId	string	リクエスト ID。	9EDC30DC-0050-5459-B788-F761B2BE359B
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：OSS ファイル。 Media：メディアアセット ID。	OSS
Media	string	メディア値： Type が OSS の場合、このフィールドは OSS および HTTP プロトコルをサポートする URL です。 Type が Media の場合、このフィールドはメディアアセット ID です。	oss://bucket/path/to/video.mp4
InputUrl	string	メディアストリーム URL。メディアストリームをトランスコードする場合にのみ、このパラメーターを指定します。	oss://bucket/path/to/video.mp4
ProcessConfig	object	トランスコード処理構成。
Transcode	object	トランスコード構成。
TemplateId	string	テンプレート ID。	9547c6ad97cb4f2aaa29683ebd18d410
OverwriteParams	object	オーバーライドパラメーター。指定された場合、これらのパラメーターは対応するテンプレートパラメーターを上書きします。
Video	object	ビデオ設定。
Codec	string	エンコード形式。	H.264
Profile	string	エンコードプロファイル。サポートされる値：baseline、main、high。 baseline：モバイルデバイス向け。 main：標準解像度デバイス向け。 high：高解像度デバイス向け。デフォルト値：high。	Main
Bitrate	string	ビデオ平均ビットレート。有効範囲：[10, 50000]。単位：Kbps。	3000
Crf	string	ビットレート品質制御係数。有効範囲：[0, 51]。デフォルト値：H.264 の場合は 23、H.265 の場合は 26。 Crf が設定されている場合、Bitrate 設定は無視されます。	23
Width	string	幅。有効範囲：[128, 4096]。単位：px。デフォルト値：元の動画の幅。	1920
Height	string	高さ。有効範囲：[128, 4096]。単位：px。デフォルト値：元の動画の高さ。	1080
Fps	string	フレームレート。有効範囲：(0, 60]。入力ファイルのフレームレートが 60 を超える場合は、60 を使用します。デフォルト値：入力ファイルのフレームレート。	25
Gop	string	キーフレーム間の最大フレーム数。有効範囲：[1, 1080000]。デフォルト値：250。	250
Preset	string	ビデオエンコーダープリセット。このパラメーターは H.264 のみでサポートされます。サポートされる値：veryfast、fast、medium、slow、slower。デフォルト値：medium。既定値: 中間。	medium
ScanMode	string	スキャンモード。サポートされる値：interlaced、progressive。	progressive
PixFmt	string	ビデオカラーフォーマット。有効値：yuv420p、yuvj420p、およびその他の標準カラーフォーマット。	yuv420p
Remove	string	ビデオを削除するかどうか。	false
Crop	string	ビデオトリミング。2 つの方法がサポートされています：このパラメーターを「border」に設定することで、黒枠を自動検出してトリミングします。カスタムトリミングは width:height:left:top の形式で指定します。	1280:800:0:140
Pad	string	ビデオに黒枠を追加します。形式：width:height:left:top。	1280:800:0:140
LongShortMode	string	自動回転（縦横自動判別モード）を有効にするかどうか。	false
Bufsize	string	バッファサイズ：有効範囲：[1000, 128000]。デフォルト値：6000。単位：Kb。	6000
Maxrate	string	ピークビデオビットレート：有効範囲：[10, 50000]。単位：Kbps。	9000
AbrMax	string	最大 ABR ビットレート（narrow-high 1 のみ有効）：有効範囲：[10, 50000]。単位：Kbps。	6000
Audio	object	音声設定。
Codec	string	音声コーデックフォーマット：AAC、MP3、VORBIS、FLAC。デフォルト値：AAC 既定値: AAC。	AAC
Profile	string	音声エンコードプリセット。 Codec が AAC の場合、有効値は aac_low、aac_he、aac_he_v2、aac_ld、aac_eld です。	aac_low
Samplerate	string	サンプルレート。サポートされる値：22050、32000、44100、48000、96000、単位：Hz	44100
Bitrate	string	出力ファイルの音声ビットレート。有効範囲：[8, 1000] 単位：Kbps デフォルト値：128	128
Channels	string	サウンドチャンネル数。デフォルト値：2	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：通常 ABR に使用されます。twopass より高速なエンコードです。 twopass：通常 VBR に使用されます。onepass より低速なエンコードです。 CBR：一定ビットレートモード。デフォルト値：onepass。	onepass
IsCheckReso	string	ビデオ解像度をチェックするかどうか。IsCheckReso と IsCheckResoFail は相互排他です。IsCheckResoFail が優先されます。 true：チェックします。入力動画の解像度（幅または高さ）が出力設定より小さい場合、入力動画の解像度を使用してトランスコードします。 false：チェックしません。デフォルト値：false。	true
IsCheckResoFail	string	ビデオ解像度をチェックするかどうか。IsCheckReso と IsCheckResoFail は相互排他です。このパラメーターが優先されます。 true：チェックします。入力動画の解像度（幅または高さ）が出力設定より小さい場合、トランスコード失敗を返します。 false：チェックしません。デフォルト値：false。	true
IsCheckVideoBitrate	string	ビデオビットレートをチェックするかどうか。IsCheckVideoBitrate と IsCheckVideoBitrateFail は相互排他です。IsCheckVideoBitrateFail が優先されます。 true：チェックします。入力動画のビットレートが出力設定より低い場合、入力動画のビットレートを使用してトランスコードします。 false：チェックしません。デフォルト値：false。	true
IsCheckVideoBitrateFail	string	ビデオビットレートをチェックするかどうか。IsCheckVideoBitrate と IsCheckVideoBitrateFail は相互排他です。このパラメーターが優先されます。 true：チェックします。入力動画のビットレートが出力設定より低い場合、トランスコード失敗を返します。 false：チェックしません。デフォルト値：false。	true
IsCheckAudioBitrate	string	音声ビットレートをチェックするかどうか。IsCheckAudioBitrate と IsCheckAudioBitrateFail は相互排他です。IsCheckAudioBitrateFail が優先されます。 true：チェックします。入力音声のビットレートが出力設定より低い場合、入力音声のビットレートを使用してトランスコードします。 false：チェックしません。デフォルト値：このパラメーターが空で、コーデックが入力ソースと異なる場合：false。このパラメーターが空で、コーデックが入力ソースと一致する場合：true。	true
IsCheckAudioBitrateFail	string	音声ビットレートをチェックするかどうか。IsCheckAudioBitrate と IsCheckAudioBitrateFail は相互排他です。このパラメーターが優先されます。 true：チェックします。入力音声のビットレートが出力設定より低い場合、トランスコード失敗を返します。 false：チェックしません。デフォルト値：false。	true
AdjDarMethod	string	解像度調整方法。このパラメーターは Width および Height の両方が指定されている場合にのみ有効です。LongShortMode と一緒に使用できます。有効値：rescale、crop、pad、none。デフォルト値：none。例: 解像度の設定方法を確認してください。	none
Tags	object
	string
ImageWatermarks	array<object>	画像ウォーターマーク構成。
	array<object>	画像ウォーターマーク構成。
TemplateId	string	テンプレート ID。	9547c6ad97cb4f2aaa29683ebd18d410
OverwriteParams	object	オーバーライドパラメーター。指定された場合、これらのパラメーターは対応するテンプレートパラメーターを上書きします。
Width	string	幅。	32
Height	string	画像ウォーターマークの高さ。	32
Dx	string	ウォーターマーク位置、x。	10
Dy	string	ウォーターマーク位置、y。	10
ReferPos	string	参照位置：TopLeft、TopRight、BottomLeft、BottomRight。デフォルト値：TopLeft。	TopLeft
Timeline	object	表示時間設定。
Start	string	開始時刻。	00:00:05
Duration	string	表示期間（秒）または「ToEND」。	ToEND
File	object	ウォーターマーク画像ファイル。
Type	string	メディアオブジェクトタイプ。有効値： OSS：OSS ファイル。 Media：メディアアセット ID。	OSS
Media	string	メディア値： Type が OSS の場合、このフィールドは OSS および HTTP プロトコルをサポートする URL です。 Type が Media の場合、このフィールドはメディアアセット ID です。	oss://bucket/path/to/video.mp4
TextWatermarks	array<object>	テキストウォーターマーク構成。
	array<object>	テキストウォーターマーク構成。
TemplateId	string	テンプレート ID。	9547c6ad97cb4f2aaa29683ebd18d410
OverwriteParams	object	オーバーライドパラメーター。指定された場合、これらのパラメーターは対応するテンプレートパラメーターを上書きします。
Content	string	ウォーターマークテキスト。Base64 エンコードしないでください。文字列は UTF-8 でエンコードされている必要があります。	test watermark
FontName	string	フォント。	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：OSS ファイル。 Media：メディアアセット ID。	OSS
Media	string	メディア値： Type が OSS の場合、このフィールドは OSS および HTTP プロトコルをサポートする URL です。 Type が Media の場合、このフィールドはメディアアセット ID です。	oss://bucket/path/to/video.mp4
Encryption	object	暗号化構成。
EncryptType	string	暗号化タイプ。	PrivateEncryption
CipherText	string	標準暗号化の暗号鍵の暗号文。	MTYi00NDU0LTg5O****
DecryptKeyUri	string	標準暗号化の復号サービスエンドポイント。	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
IsInheritTags	boolean	入力ストリームからタグを継承するかどうか。入力がメディアアセットでない場合、このパラメーターは有効になりません。デフォルト値：false	true
Output	object	出力メディア構成。
Type	string	メディアオブジェクトタイプ。有効値： OSS：OSS ファイル。 Media：メディアアセット ID。	OSS
Media	string	メディア値： Type が OSS の場合、このフィールドは OSS および HTTP プロトコルをサポートする URL です。 Type が Media の場合、このフィールドはメディアアセット ID です。	oss://bucket/path/to/video.mp4
OutputUrl	string	トランスコード済みストリーム URL。メディアストリームに出力する場合にのみ、このパラメーターを指定します。	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：送信済み。 Processing：トランスコード中。 Success：トランスコード成功。 Fail：トランスコード失敗。 Deleted：削除済み。	Init
OutFileMeta	object	生成された動画メディア情報。
FileBasicInfo	object	基本ファイル情報。
MediaId	string	メディアアセット ID。	486c2890096871edba6f81848c016303
FileName	string	ファイル名。	file.m3u8
FileStatus	string	ファイルステータス。	Normal
FileType	string	ファイルタイプ。有効値：source_file、transcode_file	source_file
FileSize	string	ファイルサイズ。単位：Byte。	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 フレームの有無。有効値： 0：B フレームなし、 1：B フレーム 1 個、 2：連続した B フレーム複数個。	2
Sar	string	サンプルアスペクト比。	478:477
Dar	string	表示アスペクト比。	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、90、180、270。デフォルト値：0	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	Job creation time. Format: yyyy-MM-ddTHH:mm:ssZ.	2022-01-12T08:49:41Z
Name	string	ジョブ名。	transcode-job
RequestId	string	Request ID at job submission.	31E30781-9495-5E2D-A84D-759B0A01E262
ParentJobId	string	親ジョブ ID。	8b2198504dd340b7b3c9842a74fc9baa
JobCount	integer	Number of sub-jobs.	1
Status	string	Job status. Success: All sub-jobs completed successfully. Fail: All sub-jobs failed.	Success
TriggerSource	string	Job source. API: API WorkFlow: Workflow Console: Console	API
Percent	integer	Job completion percentage.	0
SubmitTime	string	Job submission time. Format: yyyy-MM-ddTHH:mm:ssZ.	2022-01-12T08:49:41Z
FinishTime	string	Job completion time. Format: yyyy-MM-ddTHH:mm:ssZ.	2022-01-12T08:49:41Z
InputGroup	array<object>	Job input group. A single input represents a transcoding job. Multiple inputs represent an audio-video merging job.
	object	ジョブ入力。
Type	string	メディアオブジェクトタイプ。有効値： OSS：OSS ファイル。 Media：メディアアセット ID。	OSS
Media	string	メディア値： Type が OSS の場合、このフィールドは OSS および HTTP プロトコルをサポートする URL です。 Type が Media の場合、このフィールドはメディアアセット ID です。	oss://bucket/path/to/video.mp4
OutputGroup	array<object>	Job output group.
	array<object>	Job output.
Output	object	出力メディア構成。
Type	string	メディアオブジェクトタイプ。有効値： OSS：OSS ファイル。 Media：メディアアセット ID。	OSS
Media	string	メディア値： Type が OSS の場合、このフィールドは OSS および HTTP プロトコルをサポートする URL です。 Type が Media の場合、このフィールドはメディアアセット ID です。	oss://bucket/path/to/video.mp4
OutputUrl	string	出力ストリーム URL。	oss://bucket/path/to/video.mp4
ProcessConfig	object	ジョブ処理構成。
Transcode	object	トランスコード構成。
TemplateId	string	テンプレート ID。	9547c6ad97cb4f2aaa29683ebd18d410
OverwriteParams	object	オーバーライドパラメーター。指定された場合、これらのパラメーターは対応するテンプレートパラメーターを上書きします。
Video	object	ビデオ設定。
Codec	string	エンコード形式。	H.264
Profile	string	エンコードプロファイル。サポートされる値：baseline、main、high。 baseline：モバイルデバイス向け。 main：標準解像度デバイス向け。 high：高解像度デバイス向け。デフォルト値：high。	Main
Bitrate	string	ビデオ平均ビットレート。有効範囲：[10, 50000]。単位：Kbps。	3000
Crf	string	ビットレート品質制御係数。有効範囲：[0, 51]。デフォルト値：H.264 の場合は 23、H.265 の場合は 26。 Crf が設定されている場合、Bitrate 設定は無視されます。	23
Width	string	幅。有効範囲：[128, 4096]。単位：px。デフォルト値：元の動画の幅。	1920
Height	string	高さ。有効範囲：[128, 4096]。単位：px。デフォルト値：元の動画の高さ。	1080
Fps	string	フレームレート。有効範囲：(0, 60]。入力ファイルのフレームレートが 60 を超える場合は、60 を使用します。デフォルト値：入力ファイルのフレームレート。	25
Gop	string	キーフレーム間の最大フレーム数。有効範囲：[1, 1080000]。デフォルト値：250。	250
Preset	string	ビデオエンコーダープリセット。このパラメーターは H.264 のみでサポートされます。サポートされる値：veryfast、fast、medium、slow、slower。デフォルト値：medium。	medium
ScanMode	string	スキャンモード。サポートされる値：interlaced、progressive。	progressive
PixFmt	string	ビデオカラーフォーマット。有効値：yuv420p、yuvj420p、およびその他の標準カラーフォーマット。	yuv420p
Remove	string	ビデオを削除するかどうか。	false
Crop	string	ビデオトリミング。 2 つの方法がサポートされています。黒枠を自動検出してトリミングするには、このパラメーターを「border」に設定します。カスタムトリミングは width:height:left:top の形式で指定します。例：1280:800:0:140	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 単位：Kb	6000
Maxrate	string	ピークビデオビットレート有効範囲：[10, 50000] 単位：Kbps。	9000
AbrMax	string	最大 ABR ビットレート（narrow-high 1 のみ有効）有効範囲：[10, 50000]、単位：Kbps。	6000
Audio	object	音声設定。
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
Samplerate	string	サンプルレート。デフォルト値：44100 サポートされる値：22050、32000、44100、48000、96000、単位：Hz	44100
Bitrate	string	出力ファイルの音声ビットレート。有効範囲：[8, 1000] 単位：Kbps デフォルト値：128	128
Channels	string	サウンドチャンネル数。デフォルト値：2	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：通常 ABR に使用されます。twopass より高速なエンコードです。 twopass：通常 VBR に使用されます。onepass より低速なエンコードです。 CBR：一定ビットレートモード。デフォルト値：onepass。	onepass
IsCheckReso	string	ビデオ解像度をチェックするかどうか。IsCheckReso と IsCheckResoFail は相互排他です。IsCheckResoFail が優先されます。 true：チェックします。入力動画の解像度（幅または高さ）が出力設定より小さい場合、入力動画の解像度を使用してトランスコードします。 false：チェックしません。デフォルト値：false。	true
IsCheckResoFail	string	ビデオ解像度をチェックするかどうか。IsCheckReso と IsCheckResoFail は相互排他です。このパラメーターが優先されます。 true：チェックします。入力動画の解像度（幅または高さ）が出力設定より小さい場合、トランスコード失敗を返します。 false：チェックしません。デフォルト値：false。	true
IsCheckVideoBitrate	string	ビデオビットレートをチェックするかどうか。IsCheckVideoBitrate と IsCheckVideoBitrateFail は相互排他です。IsCheckVideoBitrateFail が優先されます。 true：チェックします。入力動画のビットレートが出力設定より低い場合、入力動画のビットレートを使用してトランスコードします。 false：チェックしません。デフォルト値：false。	true
IsCheckVideoBitrateFail	string	ビデオビットレートをチェックするかどうか。IsCheckVideoBitrate と IsCheckVideoBitrateFail は相互排他です。このパラメーターが優先されます。 true：チェックします。入力動画のビットレートが出力設定より低い場合、トランスコード失敗を返します。 false：チェックしません。デフォルト値：false。	true
IsCheckAudioBitrate	string	音声ビットレートをチェックするかどうか。IsCheckAudioBitrate と IsCheckAudioBitrateFail は相互排他です。IsCheckAudioBitrateFail が優先されます。 true：チェックします。入力音声のビットレートが出力設定より低い場合、入力音声のビットレートを使用してトランスコードします。 false：チェックしません。デフォルト値：このパラメーターが空で、コーデックが入力ソースと異なる場合：false。このパラメーターが空で、コーデックが入力ソースと一致する場合：true。	true
IsCheckAudioBitrateFail	string	音声ビットレートをチェックするかどうか。IsCheckAudioBitrate と IsCheckAudioBitrateFail は相互排他です。このパラメーターが優先されます。 true：チェックします。入力音声のビットレートが出力設定より低い場合、トランスコード失敗を返します。 false：チェックしません。デフォルト値：false。	true
AdjDarMethod	string	解像度調整方法。このパラメーターは Width および Height の両方が指定されている場合にのみ有効です。LongShortMode と一緒に使用できます。有効値：rescale、crop、pad、none。デフォルト値：none。	none
ImageWatermarks	array<object>	画像ウォーターマーク構成。
	array<object>	画像ウォーターマーク構成。
TemplateId	string	テンプレート ID。	9547c6ad97cb4f2aaa29683ebd18d410
OverwriteParams	object	オーバーライドパラメーター。指定された場合、これらのパラメーターは対応するテンプレートパラメーターを上書きします。
Width	string	幅。	32
Height	string	高さ。	32
Dx	string	ウォーターマーク位置、x。	10
Dy	string	ウォーターマーク位置、y。	10
ReferPos	string	参照位置：TopLeft、TopRight、BottomLeft、BottomRight。デフォルト：TopLeft。	TopLeft
Timeline	object	表示時間設定。
Start	string	開始時刻。	00:00:05
Duration	string	表示期間（秒）または「ToEND」。	ToEND
File	object	ウォーターマーク画像ファイル。
Type	string	メディアオブジェクトタイプ。有効値： OSS：OSS ファイル。 Media：メディアアセット ID。	OSS
Media	string	メディア値： Type が OSS の場合、このフィールドは OSS および HTTP プロトコルをサポートする URL です。 Type が Media の場合、このフィールドはメディアアセット ID です。	oss://bucket/path/to/video.mp4
TextWatermarks	array<object>	テキストウォーターマーク構成。
	array<object>	テキストウォーターマーク構成。
TemplateId	string	テンプレート ID。	9547c6ad97cb4f2aaa29683ebd18d410
OverwriteParams	object	オーバーライドパラメーター。指定された場合、これらのパラメーターは対応するテンプレートパラメーターを上書きします。
Content	string	ウォーターマークテキスト。Base64 エンコードしないでください。文字列は UTF-8 でエンコードされている必要があります。	test watermark
FontName	string	フォント。	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：OSS ファイル。 Media：メディアアセット ID。	OSS
Media	string	メディア値： Type が OSS の場合、このフィールドは OSS および HTTP プロトコルをサポートする URL です。 Type が Media の場合、このフィールドはメディアアセット ID です。	oss://bucket/path/to/video.mp4
Encryption	object	暗号化構成。
EncryptType	string	暗号化タイプ。	PrivateEncryption
CipherText	string	標準暗号化の暗号鍵の暗号文。	MTYi00NDU0LTg5O****
DecryptKeyUri	string	標準暗号化の復号サービスエンドポイント。	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
UserData	string	ユーザーデータ。	user-data
ScheduleConfig	object	Job scheduling configuration.
PipelineId	string	パイプライン ID。	e37ebee5d98b4781897f6086e89f9c56
Priority	integer	ジョブ優先度。数値が大きいほど優先度が高くなります。有効範囲：1～10。	5

例

成功レスポンス

JSONJSON

{
  "RequestId": "9EDC30DC-0050-5459-B788-F761B2BE359B",
  "TranscodeParentJob": {
    "TranscodeJobList": [
      {
        "CreateTime": "2022-01-12T08:49:41Z",
        "Name": "transcode-job",
        "ParentJobId": "8b2198504dd340b7b3c9842a74fc9baa",
        "JobId": "7d6a7e0d4db2457a8d45ff5d43e1bf0a",
        "JobIndex": 0,
        "InputGroup": [
          {
            "Type": "OSS",
            "Media": "oss://bucket/path/to/video.mp4",
            "InputUrl": "oss://bucket/path/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"
              },
              "Tags": {
                "key": ""
              }
            }
          },
          "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://bucket/path/to/video.mp4"
                }
              }
            }
          ],
          "TextWatermarks": [
            {
              "TemplateId": "9547c6ad97cb4f2aaa29683ebd18d410",
              "OverwriteParams": {
                "Content": "test watermark",
                "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
            }
          ],
          "IsInheritTags": true
        },
        "Output": {
          "Type": "OSS",
          "Media": "oss://bucket/path/to/video.mp4",
          "OutputUrl": "oss://bucket/path/to/{MediaId}/{JobId}.mp4\n"
        },
        "UserData": "user-data",
        "ScheduleConfig": {
          "PipelineId": "e37ebee5d98b4781897f6086e89f9c56",
          "Priority": 5
        },
        "Status": "Init",
        "OutFileMeta": {
          "FileBasicInfo": {
            "MediaId": "486c2890096871edba6f81848c016303",
            "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://bucket/path/to/video.mp4"
      }
    ],
    "OutputGroup": [
      {
        "Output": {
          "Type": "OSS",
          "Media": "oss://bucket/path/to/video.mp4",
          "OutputUrl": "oss://bucket/path/to/video.mp4\n"
        },
        "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://bucket/path/to/video.mp4"
                }
              }
            }
          ],
          "TextWatermarks": [
            {
              "TemplateId": "9547c6ad97cb4f2aaa29683ebd18d410",
              "OverwriteParams": {
                "Content": "test watermark",
                "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
            }
          ]
        }
      }
    ],
    "UserData": "user-data",
    "ScheduleConfig": {
      "PipelineId": "e37ebee5d98b4781897f6086e89f9c56",
      "Priority": 5
    }
  }
}

エラーコード

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

変更履歴

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