すべてのプロダクト
Search

このプロダクト

    ApsaraVideo Media Processing:ListJob

    ドキュメントセンター

    ApsaraVideo Media Processing:ListJob

    最終更新日:Feb 25, 2026

    トランスコーディングジョブの一覧を取得します

    操作説明

    • デフォルトでは、返されるトランスコーディングジョブは、作成時刻（CreationTime）の降順でソートされます。

    • この操作を呼び出すと、過去 90 日間に作成されたトランスコーディングジョブを取得できます。取得範囲は指定した時間範囲に基づきます。

    • ジョブのステータス、作成時刻の範囲、ApsaraVideo Media Processing (MPS) キューなどのリクエストパラメーターを設定することで、検索結果をフィルターできます。

    • デフォルトでは、MPS は同一アカウント内でのリージョン間データアクセスを許可していません。この操作を呼び出す前に、指定するリージョンが対象のトランスコーディングジョブのリージョンと一致していることを確認してください。一致しない場合、操作の呼び出しに失敗するか、無効な情報が返される可能性があります。

    QPS 制限

    この API 操作は、アカウントあたり 1 秒間に最大 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:ListJob

    get

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    NextPageToken

    string

    任意

    次のページのクエリ結果を取得するために使用するトークンです。最初のリクエストではこのパラメーターを指定する必要はありません。前回のクエリで取得したトークンを NextPageToken の値として指定してください。

    16f01ad6175e4230ac42bb5182cd****
    MaximumPageSize

    integer

    任意

    1 ページあたりの表示件数です。

    • デフォルト値：10。

    • 有効値：1～100。

    10
    State

    string

    任意

    トランスコーディングジョブのステータスです。デフォルト値：All。有効値：

    • All

    • Submitted

    • Transcoding

    • TranscodeSuccess

    • TranscodeFail

    • TranscodeCancelled

    All
    StartOfJobCreatedTimeRange

    string

    任意

    クエリ対象となる期間の開始時刻です。ISO 8601 標準の YYYY-MM-DDThh:mm:ssZ 形式で指定し、UTC 時間とする必要があります。

    2014-01-10T12:00:00Z
    EndOfJobCreatedTimeRange

    string

    任意

    クエリ対象となる期間の終了時刻です。ISO 8601 標準の YYYY-MM-DDThh:mm:ssZ 形式で指定し、UTC 時間とする必要があります。

    2014-01-11T12:00:00Z
    PipelineId

    string

    任意

    ジョブが送信される MPS キューの ID です。MPS キューの ID を取得するには、MPS コンソール にログインし、左側ナビゲーションウィンドウから グローバル設定 > MPS キューおよびコールバック を選択します。

    88c6ca184c0e424d5w5b665e2a12****

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    レスポンスパラメーターです。

    RequestId

    string

    リクエスト ID です。

    BC860F04-778A-472F-AB39-E1BF329C1EA8
    NextPageToken

    string

    ページネーショントークンです。次のリクエストで新しいページの結果を取得するために使用できます。

    16f01ad6175e4230ac42bb5182cd****
    JobList

    object

    Job

    array<object>

    トランスコーディングジョブです。

    array<object>

    CreationTime

    string

    ジョブが作成された時刻です。

    2014-01-10T12:00:00Z
    Percent

    integer

    トランスコードの進捗状況です。

    100
    FinishTime

    string

    ジョブが完了した時刻です。

    2014-01-10T12:20:25Z
    State

    string

    ジョブのステータスです。有効値：

    • Submitted

    • Transcoding

    • TranscodeSuccess

    • TranscodeFail

    • TranscodeCancelled

    TranscodeSuccess
    JobId

    string

    タスク ID です。

    31fa3c9ca8134fb4b0b0f7878301****
    Code

    string

    ジョブが失敗した場合に返されるエラーコードです。ジョブが成功した場合はこのパラメーターは返されません。

    InternalError
    Message

    string

    ジョブが失敗した場合に返されるエラーメッセージです。ジョブが成功した場合はこのパラメーターは返されません。

    The operation has failed due to some unknown error, exception or failure.
    Output

    object

    ジョブの出力です。

    Video

    object

    動画の構成です。

    Bufsize

    string

    バッファーのサイズです。

    6000
    Degrain

    string

    独立ノイズ除去アルゴリズムの強度です。

    5
    BitrateBnd

    object

    動画のビットレート範囲です。

    Max

    string

    最大ビットレートです。単位：Kbit/s。

    1000
    Min

    string

    最小ビットレートです。単位：Kbit/s。

    200
    PixFmt

    string

    動画のピクセルフォーマットです。有効値：yuv420p、yuvj420p などの標準ピクセルフォーマット。

    yuv420p
    Pad

    string

    動画に追加される黒い罫線です。単位：画素。

    • 形式：width:height:left:top。

    • 例：1280:800:0:140。

    1280:800:0:140
    Codec

    string

    動画コーデックです。有効値：H.264、H.265、GIF、WEBP。

    H.264
    Height

    string

    動画の高さです。

    • 単位：画素。

    • デフォルト値：入力動画の高さ。

    720
    Qscale

    string

    動画の品質制御レベルです。

    15
    Crop

    string

    動画のクロップモードです。有効値：

    • border：自動的に黒い罫線を検出し、削除します。

    • width:height:left:top 形式の値：カスタム設定に基づいて動画をクロップします。例：1280:800:0:140。

    border
    Bitrate

    string

    動画の平均ビットレートです。単位：Kbit/s。

    428
    Maxrate

    string

    動画の最大ビットレートです。単位：Kbit/s。

    1000
    MaxFps

    string

    最大フレームレートです。

    60
    Profile

    string

    コーデックプロファイルです。有効値：

    • baseline：モバイルデバイス向け。

    • main：標準解像度デバイス向け。

    • high：高解像度デバイス向け。

    • デフォルト値：high。

    high
    Crf

    string

    定数レートファクターです。このパラメーターが返される場合、Bitrate の値は無効になります。デフォルト値：26。

    26
    Gop

    string

    2 つのキーフレーム間の最大フレーム数です。デフォルト値：250。

    250
    Width

    string

    動画の幅です。

    • 単位：画素。

    • デフォルト値：入力動画の幅。

    1280
    Fps

    string

    フレームレートです。

    • 入力動画のフレームレートが 60 を超える場合、値は 60 になります。

    • デフォルト値：入力ファイルのフレームレート。

    25
    Preset

    string

    プリセット動画アルゴリズムです。デフォルト値：medium。有効値：

    • veryfast

    • fast

    • medium

    • slow

    • slower

    medium
    ScanMode

    string

    スキャンモードです。有効値：

    • このパラメーターが空欄の場合、入力ファイルのスキャンモードが使用されます。

    • auto：自動デインタレース。

    • progressive：プログレッシブスキャン。

    • interlaced：インターレーススキャン。

    • デフォルトでは、このパラメーターは空欄です。

    ベストプラクティス：インターレーススキャンはプログレッシブスキャンよりも帯域幅を消費しませんが、画質が劣ります。そのため、主流の動画制作ではプログレッシブスキャンが採用されています。

    • 入力ファイルのスキャンモードがプログレッシブスキャンでもインターレーススキャンでもない場合に、それぞれのスキャンモードを指定すると、トランスコーディングジョブは失敗します。

    • 互換性を高めるため、入力ファイルのスキャンモードまたは自動デインタレースを使用することを推奨します。

    interlaced
    ResoPriority

    string

    リソースの優先度です。

    1
    TransConfig

    object

    一般的なトランスコーディング構成です。リクエストでこのパラメーターを指定した場合、指定したトランスコーディングテンプレート内の対応するパラメーターが上書きされます。

    IsCheckAudioBitrate

    string

    音声ビットレートのチェックを行うかどうかを示します。出力音声のビットレートが入力音声のビットレートより高い場合、入力のビットレートが保持され、指定した音声ビットレートは適用されません。このパラメーターは IsCheckAudioBitrateFail よりも優先度が低くなります。有効値：

    • true

    • false

    • デフォルト値：

      • このパラメーターが空欄であり、出力音声のコーデックが入力音声のコーデックと異なる場合、デフォルト値は false です。

      • このパラメーターが空欄であり、出力音声のコーデックが入力音声のコーデックと同じ場合、デフォルト値は true です。

    false
    TransMode

    string

    トランスコーディングモードです。

    • 有効値：onepass、twopass、CBR。

    • デフォルト値：onepass。

    onepass
    IsCheckReso

    string

    解像度のチェックを行うかどうかを示します。幅または高さに基づき、出力解像度が入力解像度より高い場合、入力解像度が保持されます。有効値：

    • true

    • false

    • デフォルト値：false。

    false
    IsCheckVideoBitrateFail

    string

    動画ビットレートのチェックを行うかどうかを示します。出力動画のビットレートが入力動画のビットレートより高い場合、動画のトランスコードを行わず、トランスコーディング失敗が返されます。このパラメーターは IsCheckVideoBitrate よりも優先度が高くなります。有効値：

    • true

    • false

    • デフォルト値：false。

    false
    AdjDarMethod

    string

    解像度調整方法です。デフォルト値：none。有効値：rescale、crop、pad、none。

    none
    IsCheckVideoBitrate

    string

    動画ビットレートのチェックを行うかどうかを示します。出力動画のビットレートが入力動画のビットレートより高い場合、入力のビットレートが保持されます。有効値：

    • true

    • false

    • デフォルト値：false。

    false
    IsCheckResoFail

    string

    解像度のチェックを行うかどうかを示します。幅または高さに基づき、出力解像度が入力解像度より高い場合、トランスコーディング失敗が返されます。有効値：

    • true

    • false

    • デフォルト値：false。

    false
    IsCheckAudioBitrateFail

    string

    音声ビットレートのチェックを行うかどうかを示します。出力音声のビットレートが入力音声のビットレートより高い場合、音声のトランスコードを行わず、トランスコーディング失敗が返されます。このパラメーターは IsCheckAudioBitrate よりも優先度が高くなります。有効値：

    • false：音声ビットレートをチェックします。

    • true：音声ビットレートをチェックしません。

    false
    Encryption

    object

    暗号化構成です。M3U8 形式の出力のみサポートされます。

    Type

    string

    暗号化タイプです。返される値は hls-aes-128 のみです。

    hls-aes-128
    Key

    string

    動画を暗号化するために使用するキーです。

    encryptionkey128
    KeyType

    string

    キーの暗号化方法です。有効値：Base64、KMS。

    説明

    たとえば、キーが encryptionkey128 の場合、Base64 形式でキーを暗号化するか、Key Management Service (KMS) を使用してキーを暗号化できます。

    Base64
    Id

    string

    暗号化 ID です。

    31fa3c9ca8134f9cec2b4b0b0f78****
    KeyUri

    string

    キーを要求するために使用する URL です。URL は Base64 エンコードされています。

    https://1161758785*****.cn-shanghai.fc.aliyuncs.com/2016-08-15/proxy/HLS-decyptServer/decyptServer/
    SkipCnt

    string

    動画の先頭に暗号化されないフレーム数です。これらのフレームを暗号化しないことで、動画の再生を迅速に開始できます。

    3
    WaterMarkList

    object

    WaterMark

    array<object>

    ウォーターマークです。

    array<object>

    Type

    string

    ウォーターマークのタイプです。リクエストでこのパラメーターを指定した場合、ウォーターマークテンプレート内の対応するパラメーターが上書きされます。詳細については、「パラメーターの詳細」をご参照ください。有効値：

    • Image

    • Text

    Image
    ReferPos

    string

    ウォーターマークの位置です。

    • TopRight

    • TopLeft

    • BottomRight

    • BottomLeft

    TopRight
    Dx

    string

    ウォーターマーク画像の水平オフセットです（出力動画に対する相対値）。リクエストでこのパラメーターを指定した場合、ウォーターマークテンプレート内の対応するパラメーターが上書きされます。デフォルト値：0。値は整数または小数点以下を含む数値です。

    • 整数：水平オフセットの画素値を表します。

      • 有効値：[8, 4096]。

      • 単位：画素。

    • 小数点以下を含む数値：出力動画の解像度における幅に対する水平オフセットの比率を表します。

      • 有効値：(0, 1)。

      • 小数点以下は最大 4 桁まで可能です（例：0.9999）。それ以上の桁は自動的に削除されます。

    100
    Width

    string

    ウォーターマーク画像の幅です。リクエストでこのパラメーターを指定した場合、ウォーターマークテンプレート内の対応するパラメーターが上書きされます。値は整数または小数点以下を含む数値です。

    • 整数：ウォーターマークの幅の画素値を表します。

      • 有効値：[8, 4096]。

      • 単位：画素。

    • 小数点以下を含む数値：出力動画の解像度における幅に対するウォーターマークの幅の比率を表します。

      • 有効値：(0, 1)。

      • 小数点以下は最大 4 桁まで可能です（例：0.9999）。それ以上の桁は自動的に削除されます。

    50
    Height

    string

    ウォーターマークの高さです。リクエストでこのパラメーターを指定した場合、指定したウォーターマークテンプレート内の対応するパラメーターが上書きされます。値は整数または小数点以下を含む数値です。

    • 整数：ウォーターマークの高さの画素値を表します。

      • 有効値：[8, 4096]。

      • 単位：画素。

    • 小数点以下を含む数値：出力動画の解像度における高さに対するウォーターマークの高さの比率を表します。

      • 有効値：(0, 1)。

      • 小数点以下は最大 4 桁まで可能です（例：0.9999）。それ以上の桁は自動的に削除されます。

    50
    InputFile

    object

    ウォーターマークの入力ファイルです。

    Object

    string

    OSS オブジェクトの名前です（入力ファイルとして使用されます）。

    example-logo-****.png
    Location

    string

    入力ファイルが格納されている OSS リージョンの ID です。

    oss-cn-hangzhou
    Bucket

    string

    入力ファイルが格納されている OSS バケットの名前です。

    example-bucket
    WaterMarkTemplateId

    string

    ウォーターマークテンプレートの ID です。

    88c6ca184c0e47098a5b665e2a12****
    Dy

    string

    ウォーターマーク画像の垂直オフセットです（出力動画に対する相対値）。リクエストでこのパラメーターを指定した場合、ウォーターマークテンプレート内の対応するパラメーターが上書きされます。値は整数または小数点以下を含む数値です。

    • 整数：垂直オフセットの画素値を表します。

      • 有効値：[8, 4096]。

      • 単位：画素。

    • 小数点以下を含む数値：出力動画の解像度における高さに対する垂直オフセットの比率を表します。

      • 有効値：(0, 1)。

      • 小数点以下は最大 4 桁まで可能です（例：0.9999）。それ以上の桁は自動的に削除されます。

    100
    WaterMarkConfigUrl

    string

    ウォーターマーク構成ファイルの URL です。

    http://example.com/configure
    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}]}
    M3U8NonStandardSupport

    object

    M3U8 の非標準サポート構成です。値は JSON オブジェクトである必要があります。詳細については、「パラメーターの詳細」をご参照ください。

    TS

    object

    TS ファイルの非標準サポート構成です。値は JSON オブジェクトです。詳細については、「パラメーターの詳細」をご参照ください。

    SizeSupport

    boolean

    M3U8 ファイルに TS ファイルのサイズが含まれるかどうかを示します。

    • true

    • false

    true
    Md5Support

    boolean

    M3U8 ファイルに TS ファイルの MD5 値が含まれるかどうかを示します。有効値：

    • true

    • false

    true
    Priority

    string

    ジョブが追加される MPS キューにおけるジョブの優先度です。

    • 値 10 は最も高い優先度を意味します。

    • デフォルト値：6。

    6
    Audio

    object

    音声の構成です。

    Profile

    string

    音声コーデックのプロファイルです。値が aac の場合の有効値：aaclow、aache、aachev2、aacld、aaceld。

    aaclow
    Codec

    string

    音声コーデックです。

    • 有効値：aac、mp3、vorbis、flac。

    • デフォルト値：aac。

    aac
    Samplerate

    string

    サンプリングレートです。

    • 有効値：22050、32000、44100、48000、96000。

    • 単位：Hz。

    • デフォルト値：44100。

    • 動画コンテナ形式が FLV で音声コーデックが MP3 の場合、このパラメーターの値は 32000、48000、96000 にできません。また、音声コーデックが MP3 の場合、このパラメーターの値は 96000 にできません。

    44100
    Qscale

    string

    音声の品質制御レベルです。

    15
    Channels

    string

    サウンドチャンネルの数です。

    • 値が mp3 の場合、このパラメーターの値は 1 または 2 のみです。

    • 値が aac の場合、このパラメーターの値は 1、2、4、5、6、8 のいずれかです。

    • デフォルト値：2。

    2
    Volume

    object

    ボリュームの構成です。

    Method

    string

    ボリュームを調整する方法です。有効値：

    • auto

    • dynamic

    • linear

    auto
    Level

    string

    ボリューム調整範囲です。

    • 単位：デシベル。

    • デフォルト値：-20。

    -20
    Bitrate

    string

    出力ファイルの音声ビットレートです。

    • 単位：Kbit/s。

    • デフォルト値：128。

    128
    AudioStreamMap

    string

    音声ストリームのシーケンス番号です。

    • 形式：0:a:{シーケンス番号}。

    • シーケンス番号は、音声ストリームのリスト内でのインデックスであり、0 から始まります。シーケンス番号が指定されていない場合、デフォルトの音声ストリームが使用されます。

    0:a:0
    MergeList

    object

    Merge

    array<object>

    クリップのマージ構成です。

    object

    Start

    string

    クリップの開始時刻です。

    • 形式：hh:mm:ss[.SSS] または sssss[.SSS]。

    • 例：01:59:59.999、32000.23。

    01:59:59.999或者32000.23
    RoleArn

    string

    委任承認に使用する Resource Access Management (RAM) ロールの Alibaba Cloud Resource Name (ARN) です。

    acs:ram:::role/
    MergeURL

    string

    クリップの OSS URL です。

    • 例：http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/example-object.flv。

    • オブジェクトは UTF-8 標準で URL エンコードする必要があります。

    http://example-bucket.oss-cn-hangzhou.aliyuncs.com/example-object.flv
    Duration

    string

    クリップの長さです。

    • 形式：hh:mm:ss[.SSS] または sssss[.SSS]。

    • 例：01:59:59.999、32000.23。

    01:59:59.999
    SuperReso

    object

    ソース動画の解像度を使用する構成です。

    IsHalfSample

    string

    サンプリングレートに関連するパラメーターを取得するかどうかを示します。有効値：

    • true

    • false

    true
    UserData

    string

    カスタムデータです。

    test-001
    OutSubtitleList

    object

    OutSubtitle

    array<object>

    出力字幕です。

    array<object>

    Map

    string

    動画トラックです。形式：0:{Stream}:{ストリームシーケンス番号}（すなわち、0:v:{video_index}）。Stream の値は v であり、これは動画ストリームを意味します。シーケンス番号は、動画ストリームのリスト内でのインデックスであり、0 から始まります。

    0:v:0
    OutSubtitleFile

    object

    出力ファイルの詳細です。

    RoleArn

    string

    委任承認に使用する RAM ロールの ARN です。

    acs:ram:::role/
    Object

    string

    OSS オブジェクトの名前です（出力ファイルとして使用されます）。

    example-output.flv
    Location

    string

    出力ファイルが格納されている OSS リージョンの ID です。

    oss-cn-hangzhou
    Bucket

    string

    入力ファイルが格納されている OSS バケットの名称です。

    example-bucket-****
    Success

    boolean

    ジョブが作成されたかどうかを示します。有効値：

    • true

    • false

    true
    Message

    string

    ジョブの作成に失敗した場合に返されるエラーメッセージです。ジョブが正常に作成された場合はこのパラメーターは返されません。

    The specified parameter “%s” cannot be null.
    VideoStreamMap

    string

    動画ストリームのシーケンス番号です。

    • 形式：0:a:{シーケンス番号}。例：0:a:0。

    • シーケンス番号は、動画ストリームのリスト内でのインデックスであり、0 から始まります。

    • シーケンス番号が指定されていない場合、デフォルトの動画ストリームが使用されます。

    0:a:0
    OutputFile

    object

    出力ファイルの詳細です。

    RoleArn

    string

    委任承認に使用する RAM ロールの ARN です。

    acs:ram:::role/
    Object

    string

    OSS オブジェクトの名前です（出力ファイルとして使用されます）。

    example-output.flv
    Location

    string

    出力ファイルが格納されている OSS リージョンの ID です。

    oss-cn-hangzhou
    Bucket

    string

    入力ファイルが格納されている OSS バケットの名前です。

    example-bucket
    Rotate

    string

    動画の回転角度です。

    90
    Container

    object

    コンテナフォーマットの構成です。

    Format

    string

    コンテナフォーマットです。

    • デフォルト値：mp4。

    • 動画フォーマットには、FLV、MP4、HLS（M3U8 + TS）、MPEG-DASH（MPD + fMP4）があります。

    • 音声フォーマットには、MP3、MP4、Ogg、FLAC、M4A があります。

    • 画像フォーマットには、GIF、WebP があります。

    • コンテナフォーマットが GIF の場合、動画コーデックは GIF でなければなりません。

    • コンテナフォーマットが WebP の場合、動画コーデックは WebP でなければなりません。

    • コンテナフォーマットが FLV の場合、動画コーデックは H.265 にできません。

    flv
    Clip

    object

    クリップの情報です。

    TimeSpan

    object

    クリップの時間範囲です。

    Seek

    string

    クリップの開始時刻です。

    • 形式：hh:mm:ss[.SSS] または sssss[.SSS]。

    • 有効値：[00:00:00.000,23:59:59.999] または [0.000,86399.999]。

    • 例：01:59:59.999、32000.23。

    01:00:59.999
    Duration

    string

    クリップの長さです。

    • 形式：hh:mm:ss[.SSS] または sssss[.SSS]。

    • 有効値：[00:00:00.000,23:59:59.999] または [0.000,86399.999]。

    • 例：01:00:59.999、32000.23。

    01:00:59.999
    MergeConfigUrl

    string

    マージ構成ファイルの URL です。トランスコーディングジョブを送信する際に、MergeList または MergeConfigUrl のいずれかを指定できます。

    • MergeConfigUrl で指定される構成ファイルには、最大 50 個のクリップを含めることができます。

    • MergeConfigUrl は、クリップをマージするための構成ファイルの URL を示します。

    • 構成ファイルが OSS 内のオブジェクトとして保存され、MPS がその OSS オブジェクトにアクセスできることを確認してください。ファイルの内容については、「マージパラメーターの詳細」をご参照ください。

    • マージ構成ファイルの内容の例：{"MergeList":[{"MergeURL":"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/video_01.mp4"}]}。

    {"MergeList":[{"MergeURL":"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/video_01.mp4"}]}
    OpeningList

    object

    Opening

    array<object>

    オープニング部分です。

    object

    openUrl

    string

    オープニング部分の OSS URL です。

    http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv
    Start

    string

    オープニング部分の再生開始までの時間です（0 から開始）。

    • 単位：秒。

    • デフォルト値：0。

    0
    Width

    string

    オープニング部分の幅です。有効値：(0, 4096) の範囲内の値、-1、full。

    • デフォルト値：-1。

    • 値 -1 は、オープニング部分のソースの幅を保持することを意味します。

    • 値 full は、オープニング部分の幅がメイン部分の幅と等しいことを意味します。

    -1
    Height

    string

    オープニング部分の高さです。有効値：(0, 4096) の範囲内の値、-1、full。

    • デフォルト値：-1。

    • 値 -1 は、オープニング部分のソースの高さを保持することを意味します。

    • 値 full は、オープニング部分の高さがメイン部分の高さと等しいことを意味します。

    -1
    MuxConfig

    object

    トランスミュックス構成です。

    Webp

    object

    WebP のトランスミュックス構成です。

    Loop

    string

    ループ回数です。

    0
    Gif

    object

    GIF のトランスミュックス構成です。

    FinalDelay

    string

    最終フレームの表示時間を一時停止する期間です。単位：センチ秒。

    0
    DitherMode

    string

    パレットのカラーダザリングアルゴリズムです。有効値：sierra、bayer。

    bayer
    Loop

    string

    ループ回数です。

    0
    IsCustomPalette

    string

    カスタムパレットを使用するかどうかを示します。有効値：

    • true

    • false

    true
    Segment

    object

    セグメント構成です。値は JSON オブジェクトです。

    Duration

    string

    セグメントの長さです。値は整数である必要があります。単位：秒。

    • 有効値：[1, 10]。

    • デフォルト値：10。

    10
    TailSlateList

    object

    TailSlate

    array<object>

    エンディング部分です。

    object

    Start

    string

    開始時刻です。

    1
    BgColor

    string

    エンディング部分のサイズがメイン部分より小さい場合に追加されるバーの色です。デフォルト値：White。詳細については、「背景色」をご参照ください。

    White
    IsMergeAudio

    boolean

    エンディング部分の音声コンテンツをマージするかどうかを示します。有効値：

    • true

    • false

    true
    Width

    string

    エンディング部分の幅です。有効値：(0, 4096) の範囲内の値、-1、full。

    • 値 -1 は、エンディング部分のソースの幅を保持することを意味します。値 full は、エンディング部分の幅がメイン部分の幅と等しいことを意味します。

    • デフォルト値：-1。

    -1
    Height

    string

    エンディング部分の高さです。有効値：(0, 4096) の範囲内の値、-1、full。

    • 値 -1 は、エンディング部分のソースの高さを保持することを意味します。

    • 値 full は、エンディング部分の高さがメイン部分の高さと等しいことを意味します。

    • デフォルト値：-1。

    -1
    BlendDuration

    string

    メイン部分とエンディング部分間のトランジションの長さです。フェードトランジションが使用されます：メイン部分の最終フレームがフェードアウトし、エンディング部分の最初のフレームがフェードインします。単位：秒。デフォルト値：0。

    0
    TailUrl

    string

    エンディング部分の OSS URL です。

    http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv
    TemplateId

    string

    テンプレート ID です。

    S00000000-000010
    SubtitleConfig

    object

    字幕構成です。

    ExtSubtitleList

    object

    ExtSubtitle

    array<object>

    外部字幕です。値は JSON 配列です。

    array<object>

    CharEnc

    string

    外部字幕で使用される文字セットです。

    • 有効値：UTF-8、GBK、BIG5、auto。

    • デフォルト値：auto。

    説明

    このパラメーターを auto に設定した場合、検出された文字セットが実際の文字セットと異なる可能性があります。他の値を設定することを推奨します。

    auto
    FontName

    string

    外部字幕から変換されたハードコード字幕のフォントです。

    "WenQuanYi Zen Hei", "Yuanti SC Regular", "SimSun"
    Input

    object

    入力字幕ファイルです。

    • SRT または ASS 形式のファイルがサポートされています。「パラメーターの詳細」をご参照ください。

    • 例：{"Bucket":"example-bucket","Location":"oss-cn-hangzhou","Object":"example.srt"}。

    Object

    string

    OSS オブジェクトの名前です（入力ファイルとして使用されます）。

    example-output.flv
    Location

    string

    入力ファイルが格納されている OSS リージョンの ID です。

    oss-cn-hangzhou
    Bucket

    string

    入力ファイルが格納されている OSS バケットの名前です。

    example-bucket-****
    SubtitleList

    object

    Subtitle

    array<object>

    字幕です。

    object

    Map

    string

    動画ストリームのシーケンス番号です。シーケンス番号は、動画ストリームのリスト内でのインデックスであり、0 から始まります。リクエストで対応するパラメーターを設定しない場合、デフォルトの動画ストリームが選択されます。

    0
    Properties

    object

    メディアプロパティです。

    Width

    string

    動画の幅です。

    720
    Height

    string

    動画の高さです。

    1280
    Duration

    string

    動画の長さです。

    17
    Fps

    string

    動画のフレームレートです。

    30
    Bitrate

    string

    動画のビットレートです。

    490
    FileFormat

    string

    動画のフォーマットです。

    mp4
    Streams

    object

    ストリーム情報です。

    VideoStreamList

    object

    VideoStream

    array<object>

    動画ストリームです。

    array<object>

    Index

    string

    動画ストリームのシーケンス番号です。値は、すべての動画ストリームにおける動画ストリームの位置を示します。

    0
    Timebase

    string

    動画ストリームのタイムベースです。

    1/15360
    AvgFPS

    string

    動画ストリームの平均フレームレートです。

    30.0
    PixFmt

    string

    動画ストリームのピクセルフォーマットです。

    yuv420p
    Sar

    string

    動画ストリームのサンプルアスペクト比（SAR）です。

    1:1
    Lang

    string

    動画ストリームの言語です。「FFmpeg ドキュメント」および「ISO 639」をご参照ください。

    und
    CodecLongName

    string

    コーデックの完全な名称です。

    H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10
    Height

    string

    動画ストリームの高さ（画素単位）です。

    1280
    NumFrames

    string

    合計フレームレートです。

    30
    Bitrate

    string

    動画ストリームのビットレートです。

    421.117
    CodecTagString

    string

    コーデックのタグ文字列です。

    avc1
    HasBFrames

    string

    動画ストリームに B フレームが含まれているかどうかを示します。

    2
    Profile

    string

    コーデックプロファイルです。

    high
    StartTime

    string

    開始時刻です。

    0.000000
    NetworkCost

    object

    消費されたネットワーク帯域幅です。

    PreloadTime

    string

    動画ストリームを事前に読み込むために消費された時間です。

    8
    AvgBitrate

    string

    動画ストリームの平均ビットレートです。

    300
    CostBandwidth

    string

    消費された最大帯域幅です。

    10
    Dar

    string

    表示アスペクト比（DAR）です。

    9:16
    CodecName

    string

    コーデックの短縮名です。

    h264
    Width

    string

    動画ストリームの幅（画素単位）です。

    720
    Duration

    string

    動画ストリームの長さです。

    17.233333
    Fps

    string

    動画ストリームのフレームレートです。

    30.0
    CodecTag

    string

    コーデックのタグです。

    0x31637661
    CodecTimeBase

    string

    コーデックのタイムベースです。

    1/60
    Level

    string

    コーデックのレベルです。

    31
    AudioStreamList

    object

    AudioStream

    array<object>

    音声ストリームです。

    object

    Timebase

    string

    音声ストリームのタイムベースです。

    1/32000
    Index

    string

    音声ストリームのシーケンス番号です。値は、すべての音声ストリームにおける音声ストリームの位置を示します。

    1
    SampleFmt

    string

    サンプリングフォーマットです。

    fltp
    ChannelLayout

    string

    サウンドチャンネルの出力レイアウトです。

    mono
    Lang

    string

    音声ストリームの言語です。「FFmpeg ドキュメント」および「ISO 639」をご参照ください。

    und
    Samplerate

    string

    音声ストリームのサンプリングレートです。

    32000
    CodecLongName

    string

    コーデックの完全な名称です。

    AAC (Advanced Audio Coding)
    Channels

    string

    サウンドチャンネルの数です。

    1
    NumFrames

    string

    合計フレーム数です。

    30
    Bitrate

    string

    音声ストリームのビットレートです。

    64.136
    CodecTagString

    string

    コーデックのタグ文字列です。

    mp4a
    StartTime

    string

    開始時刻です。

    0.000000
    CodecName

    string

    コーデックの短縮名です。

    aac
    Duration

    string

    音声ストリームの長さです。

    17.223562
    CodecTag

    string

    コーデックのタグです。

    0x6134706d
    CodecTimeBase

    string

    コーデックのタイムベースです。

    1/32000
    SubtitleStreamList

    object

    SubtitleStream

    array<object>

    字幕ストリームです。

    object

    Index

    string

    字幕ストリームのシーケンス番号です。値は、すべての字幕ストリームにおける字幕ストリームの位置を示します。

    1
    Lang

    string

    字幕ストリームの言語です。

    und
    Format

    object

    フォーマット情報です。

    StartTime

    string

    開始時刻です。

    0.064000
    NumPrograms

    string

    プログラムストリームの総数です。

    0
    Size

    string

    ファイルのサイズです。

    1057273
    NumStreams

    string

    メディアストリームの総数です。

    2
    FormatLongName

    string

    コンテナフォーマットの完全な名称です。

    QuickTime / MOV
    Duration

    string

    合計時間です。

    17.234000
    Bitrate

    string

    合計ビットレートです。

    490.784
    FormatName

    string

    コンテナフォーマットの短縮名です。有効値：mov、mp4、m4a、3gp、3g2、mj2。

    mov
    FileSize

    string

    ファイルのサイズです。

    1057273
    PipelineId

    string

    MPS キューの ID です。

    88c6ca184c0e47b665e2a1267971****
    Input

    object

    ジョブ入力に関する情報です。

    Object

    string

    ジョブ入力として使用される OSS オブジェクトの名前です。

    example.flv
    Location

    string

    ジョブ入力が格納されている OSS リージョンの ID です。

    oss-cn-hangzhou
    Bucket

    string

    ジョブ入力が格納されている OSS バケットの名前です。

    example-bucket
    MNSMessageResult

    object

    Message Service (MNS) から送信された、ジョブの結果をユーザーに通知するメッセージです。

    MessageId

    string

    ジョブが成功した場合に返されるメッセージの ID です。

    123
    ErrorMessage

    string

    ジョブが失敗した場合に返されるエラーメッセージです。ジョブが成功した場合はこのパラメーターは返されません。

    The resource operated “%s” cannot be found.
    ErrorCode

    string

    ジョブが失敗した場合に返されるエラーコードです。ジョブが成功した場合はこのパラメーターは返されません。

    InvalidParameter.ResourceNotFound

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "BC860F04-778A-472F-AB39-E1BF329C1EA8",
  "NextPageToken": "16f01ad6175e4230ac42bb5182cd****",
  "JobList": {
    "Job": [
      {
        "CreationTime": "2014-01-10T12:00:00Z",
        "Percent": 100,
        "FinishTime": "2014-01-10T12:20:25Z",
        "State": "TranscodeSuccess",
        "JobId": "31fa3c9ca8134fb4b0b0f7878301****",
        "Code": "InternalError",
        "Message": "The operation has failed due to some unknown error, exception or failure.",
        "Output": {
          "Video": {
            "Bufsize": "6000",
            "Degrain": "5",
            "BitrateBnd": {
              "Max": "1000",
              "Min": "200"
            },
            "PixFmt": "yuv420p",
            "Pad": "1280:800:0:140",
            "Codec": "H.264",
            "Height": "720",
            "Qscale": "15",
            "Crop": "border",
            "Bitrate": "428",
            "Maxrate": "1000",
            "MaxFps": "60",
            "Profile": "high",
            "Crf": "26",
            "Gop": "250",
            "Width": "1280",
            "Fps": "25",
            "Preset": "medium",
            "ScanMode": "interlaced",
            "ResoPriority": "1"
          },
          "TransConfig": {
            "IsCheckAudioBitrate": "false",
            "TransMode": "onepass",
            "IsCheckReso": "false",
            "IsCheckVideoBitrateFail": "false",
            "AdjDarMethod": "none",
            "IsCheckVideoBitrate": "false",
            "IsCheckResoFail": "false",
            "IsCheckAudioBitrateFail": "false"
          },
          "Encryption": {
            "Type": "hls-aes-128",
            "Key": "encryptionkey128",
            "KeyType": "Base64",
            "Id": "31fa3c9ca8134f9cec2b4b0b0f78****",
            "KeyUri": "https://1161758785*****.cn-shanghai.fc.aliyuncs.com/2016-08-15/proxy/HLS-decyptServer/decyptServer/",
            "SkipCnt": "3"
          },
          "WaterMarkList": {
            "WaterMark": [
              {
                "Type": "Image",
                "ReferPos": "TopRight",
                "Dx": "100",
                "Width": "50",
                "Height": "50",
                "InputFile": {
                  "Object": "example-logo-****.png",
                  "Location": "oss-cn-hangzhou",
                  "Bucket": "example-bucket"
                },
                "WaterMarkTemplateId": "88c6ca184c0e47098a5b665e2a12****",
                "Dy": "100"
              }
            ]
          },
          "WaterMarkConfigUrl": "http://example.com/configure",
          "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}]}",
          "M3U8NonStandardSupport": {
            "TS": {
              "SizeSupport": true,
              "Md5Support": true
            }
          },
          "Priority": "6",
          "Audio": {
            "Profile": "aaclow",
            "Codec": "aac",
            "Samplerate": "44100",
            "Qscale": "15",
            "Channels": "2",
            "Volume": {
              "Method": "auto",
              "Level": "-20"
            },
            "Bitrate": "128"
          },
          "AudioStreamMap": "0:a:0",
          "MergeList": {
            "Merge": [
              {
                "Start": "01:59:59.999或者32000.23",
                "RoleArn": "acs:ram:::role/",
                "MergeURL": "http://example-bucket.oss-cn-hangzhou.aliyuncs.com/example-object.flv",
                "Duration": "01:59:59.999"
              }
            ]
          },
          "SuperReso": {
            "IsHalfSample": "true"
          },
          "UserData": "test-001",
          "OutSubtitleList": {
            "OutSubtitle": [
              {
                "Map": "0:v:0",
                "OutSubtitleFile": {
                  "RoleArn": "acs:ram:::role/",
                  "Object": "example-output.flv",
                  "Location": "oss-cn-hangzhou",
                  "Bucket": "example-bucket-****"
                },
                "Success": true,
                "Message": "The specified parameter “%s” cannot be null."
              }
            ]
          },
          "VideoStreamMap": "0:a:0",
          "OutputFile": {
            "RoleArn": "acs:ram:::role/",
            "Object": "example-output.flv",
            "Location": "oss-cn-hangzhou",
            "Bucket": "example-bucket"
          },
          "Rotate": "90",
          "Container": {
            "Format": "flv"
          },
          "Clip": {
            "TimeSpan": {
              "Seek": "01:00:59.999",
              "Duration": "01:00:59.999"
            }
          },
          "MergeConfigUrl": "{\"MergeList\":[{\"MergeURL\":\"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/video_01.mp4\"}]}",
          "OpeningList": {
            "Opening": [
              {
                "openUrl": "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv",
                "Start": "0",
                "Width": "-1",
                "Height": "-1"
              }
            ]
          },
          "MuxConfig": {
            "Webp": {
              "Loop": "0"
            },
            "Gif": {
              "FinalDelay": "0",
              "DitherMode": "bayer",
              "Loop": "0",
              "IsCustomPalette": "true"
            },
            "Segment": {
              "Duration": "10"
            }
          },
          "TailSlateList": {
            "TailSlate": [
              {
                "Start": "1",
                "BgColor": "White",
                "IsMergeAudio": true,
                "Width": "-1",
                "Height": "-1",
                "BlendDuration": "0",
                "TailUrl": "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv"
              }
            ]
          },
          "TemplateId": "S00000000-000010",
          "SubtitleConfig": {
            "ExtSubtitleList": {
              "ExtSubtitle": [
                {
                  "CharEnc": "auto",
                  "FontName": "\"WenQuanYi Zen Hei\", \"Yuanti SC Regular\", \"SimSun\"",
                  "Input": {
                    "Object": "example-output.flv",
                    "Location": "oss-cn-hangzhou",
                    "Bucket": "example-bucket-****"
                  }
                }
              ]
            },
            "SubtitleList": {
              "Subtitle": [
                {
                  "Map": "0"
                }
              ]
            }
          },
          "Properties": {
            "Width": "720",
            "Height": "1280",
            "Duration": "17",
            "Fps": "30",
            "Bitrate": "490",
            "FileFormat": "mp4",
            "Streams": {
              "VideoStreamList": {
                "VideoStream": [
                  {
                    "Index": "0",
                    "Timebase": "1/15360",
                    "AvgFPS": "30.0",
                    "PixFmt": "yuv420p",
                    "Sar": "1:1",
                    "Lang": "und",
                    "CodecLongName": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
                    "Height": "1280",
                    "NumFrames": "30",
                    "Bitrate": "421.117",
                    "CodecTagString": "avc1",
                    "HasBFrames": "2",
                    "Profile": "high",
                    "StartTime": "0.000000",
                    "NetworkCost": {
                      "PreloadTime": "8",
                      "AvgBitrate": "300",
                      "CostBandwidth": "10"
                    },
                    "Dar": "9:16",
                    "CodecName": "h264",
                    "Width": "720",
                    "Duration": "17.233333",
                    "Fps": "30.0",
                    "CodecTag": "0x31637661",
                    "CodecTimeBase": "1/60",
                    "Level": "31"
                  }
                ]
              },
              "AudioStreamList": {
                "AudioStream": [
                  {
                    "Timebase": "1/32000",
                    "Index": "1",
                    "SampleFmt": "fltp",
                    "ChannelLayout": "mono",
                    "Lang": "und",
                    "Samplerate": "32000",
                    "CodecLongName": "AAC (Advanced Audio Coding)",
                    "Channels": "1",
                    "NumFrames": "30",
                    "Bitrate": "64.136",
                    "CodecTagString": "mp4a",
                    "StartTime": "0.000000",
                    "CodecName": "aac",
                    "Duration": "17.223562",
                    "CodecTag": "0x6134706d",
                    "CodecTimeBase": "1/32000"
                  }
                ]
              },
              "SubtitleStreamList": {
                "SubtitleStream": [
                  {
                    "Index": "1",
                    "Lang": "und"
                  }
                ]
              }
            },
            "Format": {
              "StartTime": "0.064000",
              "NumPrograms": "0",
              "Size": "1057273",
              "NumStreams": "2",
              "FormatLongName": "QuickTime / MOV",
              "Duration": "17.234000",
              "Bitrate": "490.784",
              "FormatName": "mov"
            },
            "FileSize": "1057273"
          }
        },
        "PipelineId": "88c6ca184c0e47b665e2a1267971****",
        "Input": {
          "Object": "example.flv",
          "Location": "oss-cn-hangzhou",
          "Bucket": "example-bucket"
        },
        "MNSMessageResult": {
          "MessageId": "123",
          "ErrorMessage": "The resource operated “%s” cannot be found.",
          "ErrorCode": "InvalidParameter.ResourceNotFound"
        }
      }
    ]
  }
}

    エラーコード

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

    変更履歴

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