すべてのプロダクト
Search

このプロダクト

    Intelligent Media Services:SubmitMediaInfoJob

    ドキュメントセンター

    Intelligent Media Services:SubmitMediaInfoJob

    最終更新日:Apr 07, 2026

    メディア情報を取得するための非同期ジョブを作成します。

    操作説明

    • これは非同期 API です。タスクを送信すると、API はタスク ID を返し、タスクをバックグラウンド処理のためにキューに入れます。最終結果は、コールバックまたはメディア情報タスクのクエリによって取得できます。

    • この API を使用して、入力ファイルに対してメディア分析を実行します。時間的制約がなく、高い同時実行性が求められるユースケースに最適です。

    今すぐお試しください

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

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    Name

    string

    任意

    ジョブ名。

    job-name
    Input

    object

    必須

    ジョブの入力。

    job-name
    Type

    string

    必須

    入力メディアのタイプ。

    • OSS：入力は OSS ファイルです。

    • Media：入力はメディアアセット ID です。

    OSS
    Media

    string

    必須

    入力メディアのソース：

    • Type が OSS の場合、このパラメーターを入力ファイルの URL に設定します。OSS (oss://)、HTTP、または HTTPS の URL を使用できます。

    説明

    まず、URL で指定された OSS バケットを、ストレージ管理を使用して Intelligent Media Management Service (IMS) に追加する必要があります。

    • Type が Media の場合、このパラメーターをメディアアセット ID に設定します。

    oss://bucket/path/to/video.mp4
    UserData

    string

    任意

    カスタムユーザーデータ。

    user-data
    ScheduleConfig

    object

    任意

    スケジューリング設定。

    user-data
    PipelineId

    string

    任意

    パイプライン ID。

    e37ebee5d98b4781897f6086e89f9c56
    Priority

    integer

    任意

    ジョブの優先度。値が大きいほど優先度が高くなります。有効値の範囲は 1～10 です。

    5

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    RequestId

    string

    リクエスト ID。

    31E30781-9495-5E2D-A84D-759B0A01E262
    MediaInfoJob

    object

    メディア情報ジョブ。

    Name

    string

    ジョブ名。

    job-name
    TriggerSource

    string

    ジョブのソース。有効な値：

    • API：API オペレーションを呼び出してジョブが送信されました。

    • WorkFlow：ワークフローによってジョブがトリガーされました。

    • Console：コンソールでジョブが送信されました。

    API
    JobId

    string

    ジョブ ID。

    ab4802364a2e49208c99efab82dfa8e8
    Input

    object

    ジョブ入力。

    Type

    string

    入力メディアのタイプ。有効な値：

    • OSS：Object Storage Service (OSS) ファイル。

    • Media：メディア ID。

    OSS
    Media

    string

    メディアオブジェクトの値。この値は Type パラメーターによって異なります。

    • Type が OSS の場合、このパラメーターはメディアファイルの URL です。oss:// と HTTPS プロトコルの両方がサポートされています。

    • Type が Media の場合、このパラメーターはメディア ID です。

    oss://bucket/path/to/video.mp4
    Async

    boolean

    ジョブを非同期で処理するかどうかを示します。

    true
    UserData

    string

    ユーザーデータ。

    user-data
    ScheduleConfig

    object

    スケジューリング設定。

    PipelineId

    string

    パイプライン ID。

    e37ebee5d98b4781897f6086e89f9c56
    Priority

    integer

    ジョブの優先度。値が大きいほど優先度が高くなります。有効値の範囲は 1～10 です。

    5
    Status

    string

    ジョブステータス。有効な値：

    • Init：送信済み。

    • Success：成功。

    • Fail：失敗。

    Init
    SubmitResultJson

    object

    ジョブ送信の詳細。

    {}
    MediaInfoProperty

    object

    メディア情報の詳細。

    FileBasicInfo

    object

    ファイルの基本情報。

    MediaId

    string

    メディア ID。

    2b36bd19c13f4145b094c0cad80dbce5
    FileName

    string

    ファイル名。

    file.m3u8
    FileStatus

    string

    ファイルステータス。

    Normal
    FileType

    string

    ファイルタイプ。

    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

    ビデオのビットレート (Kbit/s 単位)。

    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

    ストリームの言語。

    us
    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：ストリームに 1 つの B フレームが含まれています。

    • 2：ストリームに 2 つ以上の連続した 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

    ストリームのビットレート (Kbit/s 単位)。

    888.563
    NumFrames

    string

    総フレーム数。

    10040
    Lang

    string

    ストリームの言語。

    zh
    Rotate

    string

    ビデオの回転角度 (度単位)。

    0
    SubmitTime

    string

    ジョブが送信された時刻。

    2022-01-12T08:49:41Z
    FinishTime

    string

    ジョブが完了した時刻。

    2022-01-12T08:49:41Z
    RequestId

    string

    リクエスト ID。

    4879B9DE-E4B6-19DC-91F5-9D5F4DCE4168

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "31E30781-9495-5E2D-A84D-759B0A01E262",
  "MediaInfoJob": {
    "Name": "job-name",
    "TriggerSource": "API",
    "JobId": "ab4802364a2e49208c99efab82dfa8e8",
    "Input": {
      "Type": "OSS",
      "Media": "oss://bucket/path/to/video.mp4"
    },
    "Async": true,
    "UserData": "user-data",
    "ScheduleConfig": {
      "PipelineId": "e37ebee5d98b4781897f6086e89f9c56",
      "Priority": 5
    },
    "Status": "Init",
    "SubmitResultJson": {},
    "MediaInfoProperty": {
      "FileBasicInfo": {
        "MediaId": "2b36bd19c13f4145b094c0cad80dbce5",
        "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": "us"
        }
      ],
      "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": "zh",
          "Rotate": "0"
        }
      ]
    },
    "SubmitTime": "2022-01-12T08:49:41Z",
    "FinishTime": "2022-01-12T08:49:41Z",
    "RequestId": "4879B9DE-E4B6-19DC-91F5-9D5F4DCE4168"
  }
}

    エラーコード

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

    変更履歴

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