すべてのプロダクト
Search

このプロダクト

    :SubmitMediaInfoJob

    ドキュメントセンター

    :SubmitMediaInfoJob

    最終更新日:Feb 25, 2026

    ApsaraVideo Media Processing (MPS) にメディア情報分析ジョブを送信します。この操作を呼び出すと、MPS は入力ファイルのメディア情報を分析し、その結果を返します。

    操作説明

    • メディア情報分析ジョブを送信する前に、ファイルが OSS にアップロード済みであることを確認してください。アップロードされていない場合、ジョブは失敗します。アップロード状況は OSS コールバックメッセージ を使用して確認できます。

    • メディア情報分析ジョブは、同期モードと非同期モードをサポートしています。

    • 非同期モードでは処理の即時性は保証されません。ジョブを送信すると MPS キューに入り、スケジューリングを待機します。API が応答を返す時点では、ジョブがまだ作成されていない可能性があります。結果を取得するには、QueryMediaInfoJob 操作をポーリングするか、MPS キューに対して MNS メッセージ通知を設定してください。詳細については、「」および「メッセージ通知の受信」をご参照ください。

    QPS 制限

    単一ユーザーあたりの最大クエリ/秒 (QPS) は 50 です。この制限を超えると、API 呼び出しがレート制限されます。これによりビジネスに影響を及ぼす可能性があるため、API 呼び出しは計画的に行ってください。詳細については、「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:SubmitMediaInfoJob

    create

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    Input

    string

    必須

    ジョブの入力情報です。詳細については、「入力パラメーターの詳細」をご参照ください。

    説明

    • MPS API では、Object 値を UTF-8 で URL エンコードする必要があります。

    • OSS バケットのリージョンは、MPS のデプロイリージョンと一致している必要があります。

    {"Bucket":"example-bucket","Location":"example-location","Object":"example%2Fexample.flv"}
    UserData

    string

    任意

    ユーザー定義データです。英数字およびハイフン (-) を使用できます。先頭を特殊文字にすることはできません。最大長は 1024 バイトです。

    testid-001
    PipelineId

    string

    任意

    パイプライン ID です。詳細については、「用語集」をご参照ください。

    • MPS コンソール>設定>パイプライン から、パイプラインの検索または作成が可能です。

    • 非同期通知を受信するには、パイプラインに MNS トピックをアタッチしてください。詳細については、「」および「メッセージ通知の受信」をご参照ください。

    88c6ca184c0e432bbf5b665e2a15****
    Async

    boolean

    任意

    ジョブを非同期で実行するかどうかを指定します。有効値：

    • true：ジョブを非同期で実行します（推奨）。

    • false：ジョブを同期で実行します。

    true
    Config

    string

    任意

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

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

    MediaInfoJob

    object

    メディア情報分析ジョブの詳細情報です。

    CreationTime

    string

    ジョブの送信時刻です。

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

    string

    ジョブのステータスです。

    • Success：ジョブが成功しました。

    • Fail：ジョブが失敗しました。

    • Analyzing：ジョブ実行中です。

    Analyzing
    JobId

    string

    メディア情報分析ジョブの ID です。

    23ca1d184c0e4341e5b665e2a12****
    UserData

    string

    ユーザー定義データです。

    testid-001
    Code

    string

    ジョブが失敗した場合のエラーコードです。

    InvalidParameter.JsonObjectFormatInvalid
    Message

    string

    ジョブが失敗した場合のエラーメッセージです。

    The parameter ”*” does not conform to the JSON Object specification
    PipelineId

    string

    パイプライン ID です。

    88c6ca184c0e432bbf5b665e2a15****
    Async

    boolean

    ジョブが非同期で実行されるかどうかを示します。

    true
    Input

    object

    ジョブの入力情報です。

    Object

    string

    入力ファイルの OSS オブジェクトです。

    example.flv
    Location

    string

    OSS バケットのリージョンです。

    example-location
    Bucket

    string

    入力ファイルの OSS バケットです。

    example-bucket
    MNSMessageResult

    object

    ジョブ完了時の MNS 通知結果です。

    MessageId

    string

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

    16f01ad6175e4230ac42bb5182cd****
    ErrorMessage

    string

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

    InvalidParameter.JsonObjectFormatInvalid
    ErrorCode

    string

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

    The parameter \"Input\" does not conform to the JSON Object specification
    Properties

    object

    メディアファイルのプロパティです。

    Width

    string

    動画の幅（ピクセル単位）です。

    1920
    Height

    string

    動画の高さ（ピクセル単位）です。

    1080
    Duration

    string

    合計再生時間（秒単位）です。

    17.226000
    Fps

    string

    フレームレートです。

    25
    Bitrate

    string

    ビットレート（Kbps 単位）です。

    1630.045
    FileFormat

    string

    ファイルフォーマットです。

    QuickTime/MOV
    Streams

    object

    ストリーム情報です。

    VideoStreamList

    object

    VideoStream

    array<object>

    動画ストリームリストです。最大 4 項目まで含まれます。

    array<object>

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

    Sar

    string

    サンプル縦横比です。

    1:1
    Height

    string

    動画の高さ（ピクセル単位）です。

    1080
    CodecTagString

    string

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

    avc1
    NetworkCost

    object

    ネットワーク帯域幅の消費量です。

    PreloadTime

    string

    プリロード時間です。

    8
    AvgBitrate

    string

    平均ビットレート（Kbps 単位）です。

    300.34
    CostBandwidth

    string

    最大帯域幅消費量です。

    10
    Width

    string

    動画の幅（ピクセル単位）です。

    1920
    Index

    string

    動画ストリームのインデックスです。メディアファイル内の動画ストリームの位置を識別します。一部のプレーヤーでは、どの動画ストリームから再生を開始するかを指定できます。他のプレーヤーでは、デフォルトでインデックス 1 から再生を開始します。

    1
    Timebase

    string

    タイムベースです。

    1/24000
    AvgFPS

    string

    平均フレームレートです。

    23.976025
    PixFmt

    string

    ピクセルフォーマットです。

    yuv420p
    Lang

    string

    言語です。

    eng
    CodecLongName

    string

    コーデックの正式名称です。

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

    string

    総フレーム数です。

    100
    Rotate

    string

    動画の回転角度（度単位）です。

    90
    Bitrate

    string

    ビットレート（Kbps 単位）です。

    1496.46
    HasBFrames

    string

    B フレームの有無を示します。0 はなし、1 はありを意味します。

    0
    Profile

    string

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

    High
    StartTime

    string

    開始時刻です。

    0.042000
    Dar

    string

    表示縦横比です。Dar = 動画の幅 / 動画の高さで計算されます。この値を使用して、動画が横長か縦長かを判断できます。

    16:9
    CodecName

    string

    コーデックの短縮名です。有効値：

    • h264

    • h265

    • gif

    • webp

    h264
    Duration

    string

    再生時間（秒単位）です。

    17.225542
    Fps

    string

    フレームレートです。

    25
    CodecTag

    string

    コーデックタグです。

    0x31637661
    CodecTimeBase

    string

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

    1001/48000
    Level

    string

    コーデックレベルです。

    41
    ColorRange

    string

    色範囲です。

    700
    ColorTransfer

    string

    色転送特性です。

    R255 G83 B170
    ColorPrimaries

    string

    原色です。

    700
    DurationInaccurate

    string

    DolbyVision

    object

    Profile

    string

    Level

    string

    AudioStreamList

    object

    AudioStream

    array<object>

    音声ストリームリストです。最大 4 項目まで含まれます。

    object

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

    Timebase

    string

    タイムベースです。

    1/44100
    Index

    string

    音声ストリームのインデックスです。メディアファイル内の音声ストリームの位置を識別します。

    1
    SampleFmt

    string

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

    fltp
    ChannelLayout

    string

    チャンネルレイアウトです。

    stereo
    Lang

    string

    言語です。

    eng
    Samplerate

    string

    サンプリング周波数（Hz 単位）です。

    44100
    CodecLongName

    string

    コーデックの正式名称です。

    AAC (Advanced Audio Coding)
    Channels

    string

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

    2
    NumFrames

    string

    総フレーム数です。

    123
    Bitrate

    string

    ビットレート（Kbps 単位）です。

    128.806
    CodecTagString

    string

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

    mp4a
    StartTime

    string

    開始時刻です。

    0.000000
    CodecName

    string

    コーデックの短縮名です。デフォルト値は aac です。有効値：

    • aac

    • mp3

    • mp4

    • ogg

    • flac

    aac
    Duration

    string

    再生時間（秒単位）です。

    17.159546
    CodecTag

    string

    コーデックタグです。

    0x6134706d
    CodecTimeBase

    string

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

    1/44100
    DurationInaccurate

    string

    SubtitleStreamList

    object

    SubtitleStream

    array<object>

    字幕ストリームリストです。最大 4 項目まで含まれます。

    object

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

    Timebase

    string

    タイムベースです。

    1/1000
    Index

    string

    字幕ストリームのインデックスです。メディアファイル内の字幕ストリームの位置を識別します。

    3
    StartTime

    string

    開始時刻です。

    0.000000
    CodecName

    string

    コーデックの短縮名です。有効値：

    • srt

    • ass

    ass
    Lang

    string

    言語です。

    eng
    CodecLongName

    string

    コーデックの正式名称です。

    ASS (Advanced SSA) subtitle
    Duration

    string

    再生時間（秒単位）です。

    1370.116000
    CodecTag

    string

    コーデックタグです。

    0x0000
    CodecTimeBase

    string

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

    0/1
    CodecTagString

    string

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

    [0][0][0][0]
    Format

    object

    フォーマット情報です。

    StartTime

    string

    開始時刻です。

    0.000000
    NumPrograms

    string

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

    0
    Size

    string

    ファイルサイズ（バイト単位）です。

    3509895
    NumStreams

    string

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

    2
    FormatLongName

    string

    コンテナまたはラッパー形式の正式名称です。

    QuickTime/MOV
    Duration

    string

    合計再生時間（秒単位）です。

    17.226000
    Bitrate

    string

    合計ビットレート（Kbps 単位）です。

    1630.045
    FormatName

    string

    コンテナまたはラッパー形式の短縮名です。詳細については、「パラメーター詳細」をご参照ください。

    mov
    Tags

    object

    FileSize

    string

    ファイルサイズ（バイト単位）です。

    3509895
    MD5

    string

    RequestId

    string

    リクエスト ID です。

    62D9BE16-B7D5-550C-A482-7A0F60E09877

    例

    成功レスポンス

    JSONJSON

    {
  "MediaInfoJob": {
    "CreationTime": "2014-01-10T12:00:00Z",
    "State": "Analyzing",
    "JobId": "23ca1d184c0e4341e5b665e2a12****",
    "UserData": "testid-001",
    "Code": "InvalidParameter.JsonObjectFormatInvalid",
    "Message": "The parameter ”*” does not conform to the JSON Object specification",
    "PipelineId": "88c6ca184c0e432bbf5b665e2a15****",
    "Async": true,
    "Input": {
      "Object": "example.flv",
      "Location": "example-location",
      "Bucket": "example-bucket"
    },
    "MNSMessageResult": {
      "MessageId": "16f01ad6175e4230ac42bb5182cd****",
      "ErrorMessage": "InvalidParameter.JsonObjectFormatInvalid",
      "ErrorCode": "The parameter \\\"Input\\\" does not conform to the JSON Object specification"
    },
    "Properties": {
      "Width": "1920",
      "Height": "1080",
      "Duration": "17.226000",
      "Fps": "25",
      "Bitrate": "1630.045",
      "FileFormat": "QuickTime/MOV",
      "Streams": {
        "VideoStreamList": {
          "VideoStream": [
            {
              "Sar": "1:1",
              "Height": "1080",
              "CodecTagString": "avc1",
              "NetworkCost": {
                "PreloadTime": "8",
                "AvgBitrate": "300.34",
                "CostBandwidth": "10"
              },
              "Width": "1920",
              "Index": "1",
              "Timebase": "1/24000",
              "AvgFPS": "23.976025",
              "PixFmt": "yuv420p",
              "Lang": "eng",
              "CodecLongName": "H.264/AVC/MPEG-4 AVC/MPEG-4 part 10",
              "NumFrames": "100",
              "Rotate": "90",
              "Bitrate": "1496.46",
              "HasBFrames": "0",
              "Profile": "High",
              "StartTime": "0.042000",
              "Dar": "16:9",
              "CodecName": "h264",
              "Duration": "17.225542",
              "Fps": "25",
              "CodecTag": "0x31637661",
              "CodecTimeBase": "1001/48000",
              "Level": "41",
              "ColorRange": "700",
              "ColorTransfer": "R255 G83 B170",
              "ColorPrimaries": "700",
              "DurationInaccurate": "",
              "DolbyVision": {
                "Profile": "",
                "Level": ""
              }
            }
          ]
        },
        "AudioStreamList": {
          "AudioStream": [
            {
              "Timebase": "1/44100",
              "Index": "1",
              "SampleFmt": "fltp",
              "ChannelLayout": "stereo",
              "Lang": "eng",
              "Samplerate": "44100",
              "CodecLongName": "AAC (Advanced Audio Coding)",
              "Channels": "2",
              "NumFrames": "123",
              "Bitrate": "128.806",
              "CodecTagString": "mp4a",
              "StartTime": "0.000000",
              "CodecName": "aac",
              "Duration": "17.159546",
              "CodecTag": "0x6134706d",
              "CodecTimeBase": "1/44100",
              "DurationInaccurate": ""
            }
          ]
        },
        "SubtitleStreamList": {
          "SubtitleStream": [
            {
              "Timebase": "1/1000",
              "Index": "3",
              "StartTime": "0.000000",
              "CodecName": "ass",
              "Lang": "eng",
              "CodecLongName": "ASS (Advanced SSA) subtitle",
              "Duration": "1370.116000",
              "CodecTag": "0x0000",
              "CodecTimeBase": "0/1",
              "CodecTagString": "[0][0][0][0]"
            }
          ]
        }
      },
      "Format": {
        "StartTime": "0.000000",
        "NumPrograms": "0",
        "Size": "3509895",
        "NumStreams": "2",
        "FormatLongName": "QuickTime/MOV",
        "Duration": "17.226000",
        "Bitrate": "1630.045",
        "FormatName": "mov",
        "Tags": {
          "test": "test",
          "test2": 1
        }
      },
      "FileSize": "3509895",
      "MD5": ""
    }
  },
  "RequestId": "62D9BE16-B7D5-550C-A482-7A0F60E09877"
}

    エラーコード

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

    変更履歴

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