すべてのプロダクト
Search

このプロダクト

    Intelligent Media Services:SubmitSyncMediaInfoJob

    ドキュメントセンター

    Intelligent Media Services:SubmitSyncMediaInfoJob

    最終更新日:Mar 21, 2026

    メディアファイルを同期モードで送信し、メディア情報の分析を行います。

    操作説明

    この操作を呼び出すことで、入力メディアファイルを同期モードで分析できます。この操作は、リアルタイム性能が高く、同時実行数が低いシナリオに適しています。入力メディアファイルのメディア情報を取得するのに時間がかかる場合、リクエストがタイムアウトしたり、取得された情報が不正確になったりする可能性があります。メディア情報を取得するには、SubmitMediaInfoJob 操作を呼び出すことを推奨します。

    今すぐお試しください

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

    create

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    Name

    string

    任意

    タスク名です。

    job-name
    Input

    object

    必須

    タスクの入力です。

    Type

    string

    必須

    メディアオブジェクトのタイプです。

    • OSS：Object Storage Service (OSS) オブジェクト。

    • Media：メディアアセット。

    OSS
    Media

    string

    必須

    メディアオブジェクトです。

    • Type が OSS に設定されている場合、このパラメーターを OSS オブジェクトの URL に設定します。OSS プロトコルと HTTP プロトコルの両方がサポートされています。

    説明

    URL 内の OSS バケットを使用する前に、Intelligent Media Services (IMS) コンソールの ストレージ管理 ページでバケットを追加する必要があります。

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

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

    string

    任意

    ユーザーデータです。

    user-data
    ScheduleConfig

    object

    任意

    スケジューリングパラメーターです。このパラメーターは省略可能です。

    PipelineId

    string

    任意

    タスクが送信された MPS キューの ID です。

    e37ebee5d98b4781897f6086e89f9c56
    Priority

    integer

    任意

    タスクの優先度です。有効値：1～10。値が大きいほど、優先度が高くなります。

    5

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    RequestId

    string

    リクエスト ID です。

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

    object

    MediaInfoJobDTO

    Name

    string

    タスク名です。

    job-name
    TriggerSource

    string

    タスクのソースです。有効値：API、WorkFlow、Console。

    API
    JobId

    string

    タスク ID です。

    ab4802364a2e49208c99efab82dfa8e8
    Input

    object

    タスクの入力です。

    Type

    string

    メディアオブジェクトのタイプです。有効値：

    • OSS：OSS オブジェクト。

    • Media：メディアアセット。

    OSS
    Media

    string

    メディアオブジェクトです。Type が OSS に設定されている場合、このパラメーターを OSS オブジェクトの URL に設定します。OSS プロトコルと HTTP プロトコルの両方がサポートされています。Type が Media に設定されている場合、このパラメーターをメディアアセットの ID に設定します。

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

    boolean

    非同期処理が実行されたかどうかを示します。

    true
    UserData

    string

    ユーザーデータです。

    user-data
    ScheduleConfig

    object

    スケジューリング情報です。

    PipelineId

    string

    タスクが送信された MPS キューの ID です。

    e37ebee5d98b4781897f6086e89f9c56
    Priority

    integer

    タスクの優先度です。有効値：1～10。値が大きいほど、優先度が高くなります。

    5
    Status

    string

    タスクの状態です。有効値：Init（タスクが送信済み）、Success（タスクが成功）、Fail（タスクが失敗）。

    Init
    SubmitResultJson

    object

    タスク送信情報です。

    {}
    MediaInfoProperty

    object

    メディア情報の詳細です。

    FileBasicInfo

    object

    基本ファイル情報です。

    MediaId

    string

    メディアアセットの ID です。

    999e68259c924f52a6be603cbb3f91cc
    FileName

    string

    ファイル名です。

    file.m3u8
    FileStatus

    string

    ファイルの状態です。有効値：

    • Normal

    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

    ビデオのビットレートです。

    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：ストリームに複数の連続した 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

    ストリームの言語です。

    zh
    Rotate

    string

    ビデオイメージの回転角度です。

    0
    SubmitTime

    string

    タスクが送信された時刻です。時刻は ISO 8601 標準の yyyy-MM-ddTHH:mm:ssZ 形式に従い、協定世界時 (UTC) で表示されます。

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

    string

    タスクが完了した時刻です。時刻は ISO 8601 標準の yyyy-MM-ddTHH:mm:ssZ 形式に従い、協定世界時 (UTC) で表示されます。

    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": "999e68259c924f52a6be603cbb3f91cc",
        "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"
  }
}

    エラーコード

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

    変更履歴

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