すべてのプロダクト
Search

このプロダクト

    Intelligent Media Services:GetMediaInfo

    ドキュメントセンター

    Intelligent Media Services:GetMediaInfo

    最終更新日:Mar 21, 2026

    Intelligent Media Services (IMS) の mediaId または InputURL を使用して、メディアアセットの情報を取得します。

    操作説明

    MediaId が優先されます。MediaId が空の場合、InputURL は null であってはなりません。

    今すぐお試しください

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

    get

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    MediaId

    string

    任意

    Intelligent Media Services (IMS) 内のメディアアセットの ID。このパラメーターを省略する場合は、InputURL を指定する必要があります。

    ****20b48fb04483915d4f2cd8ac****
    InputURL

    string

    任意

    照会対象のメディアアセットのアドレス。事前に、メディアアセットを IMS メディアライブラリに登録し、mediaId と関連付ける必要があります。

    • Object Storage Service (OSS) の URL。以下の 2 つの形式がサポートされています。

    http(s)://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4

    oss://example-bucket/example.mp4。この形式を使用する場合、OSS リージョンはサービスエンドポイントのリージョンがデフォルトとなります。

    http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4
    OutputType

    string

    任意

    メディアアセットファイルの返却先 URL の種別。

    • oss：OSS URL を返却します。これがデフォルト値です。

    • cdn：コンテンツデリバリーネットワーク (CDN) の URL を返却します。ただし、メディアアセットが Video on Demand (VOD) からインポートされており、VOD で CDN ドメイン名が設定されている場合のみ CDN URL が返却されます。

    cdn
    ReturnDetailedInfo

    string

    任意

    特定のメディアアセットフィールドについて詳細情報を返すかどうか。サポートされる唯一のフィールドは AiRoughData.StandardSmartTagJob であり、タグ分析タスクの結果の返却方法を指定します。

    • false：タスク結果を URL として返却します。これがデフォルト値です。

    • true：タスク結果を文字列として返却します。

    {"AiRoughData.StandardSmartTagJob": false}

    AuthTimeout

    integer

    任意

    署名付き URL の有効期間（秒単位）。

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    応答スキーマ。

    RequestId

    string

    リクエスト ID。

    2FDE2411-DB8D-4A9A-875B-275798F14A5E
    MediaInfo

    object

    メディアアセットに関する情報。

    MediaId

    string

    メディアアセット ID。

    ****20b48fb04483915d4f2cd8ac****
    MediaBasicInfo

    object

    メディアアセットの基本情報。

    MediaId

    string

    メディアアセット ID。

    ****20b48fb04483915d4f2cd8ac****
    InputURL

    string

    メディアアセットの URL。

    https://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4
    MediaType

    string

    メディアアセットの種別。

    video
    BusinessType

    string

    メディアアセットのビジネス種別。

    general
    Source

    string

    メディアアセットのソース。

    oss
    Title

    string

    メディアアセットのタイトル。

    标题
    Description

    string

    メディアアセットの説明。

    描述
    Category

    string

    メディアアセットのカテゴリ。

    分类
    MediaTags

    string

    メディアアセットのタグをカンマ区切りで並べたリスト。

    标签,tag1
    CoverURL

    string

    カバーアイコンの URL。

    http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png?Expires=&OSSAccessKeyId=&Signature=&security-token=
    UserData

    string

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

    userDataTest
    Snapshots

    string

    スナップショットの URL のリスト。

    [ "http://example-bucket.oss-cn-shanghai.aliyuncs.com/snapshot-00001.png?Expires=&OSSAccessKeyId=&Signature=&security-token=", "http://example-bucket.oss-cn-shanghai.aliyuncs.com/snapshot-00002.jpg?Expires=&OSSAccessKeyId=&Signature=&security-token=",   "http://example-bucket.oss-cn-shanghai.aliyuncs.com/snapshot-00003.jpg?Expires=&OSSAccessKeyId=&Signature=&security-token=" ]
    Status

    string

    メディアアセットのステータス。

    Normal
    CreateTime

    string

    メディアアセットの作成時刻。時刻は協定世界時 (UTC) で、YYYY-MM-DDTHH:MM:SSZ 形式です。

    2020-12-26T04:11:08Z
    ModifiedTime

    string

    メディアアセットの最終更新時刻。時刻は協定世界時 (UTC) で、YYYY-MM-DDTHH:MM:SSZ 形式です。

    2020-12-26T04:11:10Z
    DeletedTime

    string

    メディアアセットの削除時刻。時刻は協定世界時 (UTC) で、YYYY-MM-DDTHH:MM:SSZ 形式です。

    2020-12-26T04:11:15Z
    SpriteImages

    string

    生成されたスプライト画像の詳細情報。

    [{"bucket":"example-bucket","count":"32","iceJobId":"******83ec44d58b2069def2e******","location":"oss-cn-shanghai","snapshotRegular":"example/example-{Count}.jpg","spriteRegular":"example/example-{TileCount}.jpg","templateId":"******e438b14ff39293eaec25******","tileCount":"1"}]
    CateId

    integer

    カテゴリ ID。

    3048
    Biz

    string

    メディアアセットに関連付けられたビジネス。

    ICE
    UploadSource

    string

    メディアアセットのアップロード元。

    general
    CateName

    string

    カテゴリ名。

    cateName
    ReferenceId

    string

    カスタムのユーザー固有 ID。長さは 6～64 文字で、英字、数字、ハイフン (-)、およびアンダースコア (_) のみを含めることができます。

    123-1234
    FileInfoList

    array<object>

    ファイル情報オブジェクトのリスト。

    array<object>

    FileBasicInfo

    object

    ファイルの基本情報（再生時間やサイズなど）。

    FileName

    string

    ファイル名。

    example.mp4
    FileStatus

    string

    ファイルのステータス。

    Normal
    FileType

    string

    ファイルの種別。

    source_file
    FileSize

    string

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

    30611502
    FileUrl

    string

    ファイルの OSS URL。

    http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4?Expires=&OSSAccessKeyId=&Signature=&security-token=
    Region

    string

    ファイルが保存されているリージョン。

    cn-shanghai
    FormatName

    string

    コンテナ形式。

    mov,mp4,m4a,3gp,3g2,mj2
    Duration

    string

    ファイルの再生時間（秒単位）。

    216.206667
    Bitrate

    string

    ファイルのビットレート（kbit/s 単位）。

    1132.68
    Width

    string

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

    960
    Height

    string

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

    540
    CreateTime

    string

    ファイルの作成時刻。時刻は協定世界時 (UTC) で、YYYY-MM-DDTHH:MM:SSZ 形式です。

    2020-12-26T04:11:08Z
    ModifiedTime

    string

    ファイルの最終更新時刻。時刻は協定世界時 (UTC) で、YYYY-MM-DDTHH:MM:SSZ 形式です。

    2020-12-26T04:11:10Z
    AudioStreamInfoList

    array<object>

    音声ストリーム情報のリスト。メディアアセットには複数の音声ストリームが含まれる場合があります。

    object

    Index

    string

    音声ストリームのインデックス。

    1
    CodecName

    string

    コーデックの短縮名。

    aac
    CodecLongName

    string

    コーデックの正式名称。

    AAC (Advanced Audio Coding)
    CodecTimeBase

    string

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

    1/24000
    CodecTagString

    string

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

    mp4a
    CodecTag

    string

    コーデックのタグ。

    0x6134706d
    Profile

    string

    エンコードプロファイル。

    High
    SampleFmt

    string

    サンプルフォーマット。

    fltp
    SampleRate

    string

    サンプルレート（Hz 単位）。

    44100
    Channels

    string

    音声チャンネル数。

    2
    ChannelLayout

    string

    チャンネルレイアウト。

    stereo
    Timebase

    string

    タイムベース。

    1/44100
    StartTime

    string

    開始時刻（秒単位）。

    0.000000
    Duration

    string

    再生時間（秒単位）。

    16.200998
    Bitrate

    string

    ビットレート（kbit/s 単位）。

    127.794
    Fps

    string

    音声フレームレート。

    8
    NumFrames

    string

    音声フレーム総数。

    10
    Lang

    string

    言語。

    und
    VideoStreamInfoList

    array<object>

    ビデオストリーム情報のリスト。メディアアセットには複数のビデオストリームが含まれる場合があります。

    object

    Index

    string

    ビデオストリームのインデックス。

    0
    CodecName

    string

    コーデックの短縮名。

    h264
    CodecLongName

    string

    コーデックの正式名称。

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

    string

    エンコードプロファイル。

    High
    CodecTimeBase

    string

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

    1/48
    CodecTagString

    string

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

    [0][0][0][0]
    CodecTag

    string

    コーデックのタグ。

    0x0000
    Width

    string

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

    960
    Height

    string

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

    540
    HasBFrames

    string

    B フレームの存在有無を指定します。

    2
    Sar

    string

    サンプルアスペクト比 (SAR)。

    0:1
    Dar

    string

    アスペクト比の表示 (DAR)。

    0:1
    PixFmt

    string

    ピクセルフォーマット。

    yuv420p
    Level

    string

    エンコードレベル。

    30
    Fps

    string

    ビデオフレームレート。

    24.0
    AvgFPS

    string

    平均フレームレート。

    24.0
    Timebase

    string

    タイムベース。

    1/12288
    StartTime

    string

    開始時刻（秒単位）。

    0.081706
    Duration

    string

    再生時間（秒単位）。

    216.206706
    Bitrate

    string

    ビットレート（kbit/s 単位）。

    1001.594
    NumFrames

    string

    フレーム総数。

    5184
    Lang

    string

    言語。

    und
    Rotate

    string

    動画の回転角度。

    0
    Nb_frames

    string

    ビデオフレーム総数。

    5184
    SubtitleStreamInfoList

    array<object>

    字幕ストリーム情報のリスト。メディアアセットには複数の字幕ストリームが含まれる場合があります。

    object

    Index

    string

    字幕ストリームのインデックス。

    1
    CodecName

    string

    コーデックの短縮名。

    srt
    CodecLongName

    string

    コーデックの正式名称。

    SubRip Text
    CodecTimeBase

    string

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

    29.97
    CodecTagString

    string

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

    unicode
    CodecTag

    string

    コーデックのタグ。

    unicode
    Timebase

    string

    タイムベース。

    30
    StartTime

    string

    開始時刻（秒単位）。

    0
    Duration

    string

    再生時間。

    1
    Lang

    string

    言語。

    und
    AiRoughData

    object

    AI 分析からの生データ。

    Result

    string

    AI 分析の生結果。

    https://sample-bucket.cn-shanghai.aliyuncs.com/result.json
    Status

    string

    AI 分析のステータス：

    • Analyzing：分析中です。

    • AnalyzeSuccess：分析が成功しました。

    • AnalyzeFailed：分析に失敗しました。

    • Saving：データを保存中です。

    • SaveSuccess：データの保存が完了しました。

    • SaveFailed：データの保存に失敗しました。

    • Deleting：データを削除中です。

    • DeleteSuccess：データの削除が完了しました。

    • DeleteFailed：データの削除に失敗しました。

    Analyzing
    SaveType

    string

    保存タイプ。AI 分析完了後に検索インデックスへの結果保存を行うか否かを指定します。有効な値：

    • TEXT：テキストインデックス。

    TEXT
    AiCategory

    string

    AI カテゴリ。有効な値：

    • Lifestyle

    • Appearance

    • Pets

    • News

    • Advertisement

    • Environment

    • Automobile

    生活
    AiJobId

    string

    AI ジョブ ID。

    ****483915d4f2cd8ac20b48fb04****
    StandardSmartTagJob

    object

    タグジョブ。

    AiJobId

    string

    AI ジョブ ID。

    ****483915d4f2cd8ac20b48fb04****
    Status

    string

    AI 分析ステータス：

    • Analyzing：分析中です。

    • AnalyzeSuccess：分析が成功しました。

    • AnalyzeFailed：分析に失敗しました。

    Analyzing
    ResultUrl

    string

    タグ結果の URL。

    http://xx.oss-cn-shanghai.aliyuncs.com/result2.txt
    Results

    array<object>

    タグ認識結果のリスト。

    object

    タグ認識結果

    Data

    string

    詳細な分析結果は JSON 文字列です。各 Type のデータ構造については、「Result パラメーターの説明」をご参照ください。

    {"autoChapters": [...]}
    Type

    string

    タグ識別タイプ。有効な値：

    • NLP：自然言語処理（NLP）の結果。

    • TextLabel：テキストタグ。

    • VideoLabel：ビデオタグ。

    • ASR：音声認識（ASR）の生結果。

    • OCR：光学文字認識（OCR）の生結果。

    NLP

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "2FDE2411-DB8D-4A9A-875B-275798F14A5E",
  "MediaInfo": {
    "MediaId": "****20b48fb04483915d4f2cd8ac****",
    "MediaBasicInfo": {
      "MediaId": "****20b48fb04483915d4f2cd8ac****",
      "InputURL": "https://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4",
      "MediaType": "video",
      "BusinessType": "general",
      "Source": "oss",
      "Title": "标题",
      "Description": "描述",
      "Category": "分类",
      "MediaTags": "标签,tag1",
      "CoverURL": "http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png?Expires=&OSSAccessKeyId=&Signature=&security-token=",
      "UserData": "userDataTest",
      "Snapshots": "[\n    \"http://example-bucket.oss-cn-shanghai.aliyuncs.com/snapshot-00001.png?Expires=&OSSAccessKeyId=&Signature=&security-token=\",\n    \"http://example-bucket.oss-cn-shanghai.aliyuncs.com/snapshot-00002.jpg?Expires=&OSSAccessKeyId=&Signature=&security-token=\",\n    \"http://example-bucket.oss-cn-shanghai.aliyuncs.com/snapshot-00003.jpg?Expires=&OSSAccessKeyId=&Signature=&security-token=\"\n]",
      "Status": "Normal",
      "CreateTime": "2020-12-26T04:11:08Z",
      "ModifiedTime": "2020-12-26T04:11:10Z",
      "DeletedTime": "2020-12-26T04:11:15Z",
      "SpriteImages": "[{\"bucket\":\"example-bucket\",\"count\":\"32\",\"iceJobId\":\"******83ec44d58b2069def2e******\",\"location\":\"oss-cn-shanghai\",\"snapshotRegular\":\"example/example-{Count}.jpg\",\"spriteRegular\":\"example/example-{TileCount}.jpg\",\"templateId\":\"******e438b14ff39293eaec25******\",\"tileCount\":\"1\"}]",
      "CateId": 3048,
      "Biz": "ICE",
      "UploadSource": "general",
      "CateName": "cateName",
      "ReferenceId": "123-1234"
    },
    "FileInfoList": [
      {
        "FileBasicInfo": {
          "FileName": "example.mp4",
          "FileStatus": "Normal",
          "FileType": "source_file",
          "FileSize": "30611502",
          "FileUrl": "http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4?Expires=&OSSAccessKeyId=&Signature=&security-token=",
          "Region": "cn-shanghai",
          "FormatName": "mov,mp4,m4a,3gp,3g2,mj2",
          "Duration": "216.206667",
          "Bitrate": "1132.68",
          "Width": "960",
          "Height": "540",
          "CreateTime": "2020-12-26T04:11:08Z",
          "ModifiedTime": "2020-12-26T04:11:10Z"
        },
        "AudioStreamInfoList": [
          {
            "Index": "1",
            "CodecName": "aac",
            "CodecLongName": "AAC (Advanced Audio Coding)",
            "CodecTimeBase": "1/24000",
            "CodecTagString": "mp4a",
            "CodecTag": "0x6134706d",
            "Profile": "High",
            "SampleFmt": "fltp",
            "SampleRate": "44100",
            "Channels": "2",
            "ChannelLayout": "stereo",
            "Timebase": "1/44100",
            "StartTime": "0.000000",
            "Duration": "16.200998",
            "Bitrate": "127.794",
            "Fps": "8",
            "NumFrames": "10",
            "Lang": "und"
          }
        ],
        "VideoStreamInfoList": [
          {
            "Index": "0",
            "CodecName": "h264",
            "CodecLongName": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
            "Profile": "High",
            "CodecTimeBase": "1/48",
            "CodecTagString": "[0][0][0][0]",
            "CodecTag": "0x0000",
            "Width": "960",
            "Height": "540",
            "HasBFrames": "2",
            "Sar": "0:1",
            "Dar": "0:1",
            "PixFmt": "yuv420p",
            "Level": "30",
            "Fps": "24.0",
            "AvgFPS": "24.0",
            "Timebase": "1/12288",
            "StartTime": "0.081706",
            "Duration": "216.206706",
            "Bitrate": "1001.594",
            "NumFrames": "5184",
            "Lang": "und",
            "Rotate": "0",
            "Nb_frames": "5184"
          }
        ],
        "SubtitleStreamInfoList": [
          {
            "Index": "1",
            "CodecName": "srt",
            "CodecLongName": "SubRip Text",
            "CodecTimeBase": "29.97",
            "CodecTagString": "unicode",
            "CodecTag": "unicode",
            "Timebase": "30",
            "StartTime": "0",
            "Duration": "1",
            "Lang": "und"
          }
        ]
      }
    ],
    "AiRoughData": {
      "Result": "https://sample-bucket.cn-shanghai.aliyuncs.com/result.json",
      "Status": "Analyzing",
      "SaveType": "TEXT",
      "AiCategory": "生活",
      "AiJobId": "****483915d4f2cd8ac20b48fb04****",
      "StandardSmartTagJob": {
        "AiJobId": "****483915d4f2cd8ac20b48fb04****",
        "Status": "Analyzing",
        "ResultUrl": "http://xx.oss-cn-shanghai.aliyuncs.com/result2.txt",
        "Results": [
          {
            "Data": "{\"autoChapters\": [...]}",
            "Type": "NLP"
          }
        ]
      }
    }
  }
}

    エラーコード

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

    変更履歴

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