すべてのプロダクト
Search

このプロダクト

    Intelligent Media Services:GetMediaInfo

    ドキュメントセンター

    Intelligent Media Services:GetMediaInfo

    最終更新日:Oct 09, 2026

    IMS メディア ID または入力 URL に基づいてメディアアセット情報を取得します。

    操作説明

    MediaId が空でない場合、それが優先されます。MediaId が空の場合は、InputURL を指定する必要があります。

    今すぐお試しください

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

    *すべてのリソース。

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    MediaId

    string

    任意

    IMS メディアアセットの ID。このパラメーターが空の場合は、InputURL を指定する必要があります。

    ****20b48fb04483915d4f2cd8ac****
    InputURL

    string

    任意

    対応するシステムで照会するメディアアセットの URL。使用する前に、メディアアセットを IMS コンテンツライブラリに登録し、IMS メディア ID に関連付ける必要があります。

    • 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 を返します。CDN URL は、メディアアセットが ApsaraVideo VOD からインポートされ、ApsaraVideo VOD でアクセラレーションドメイン名が設定されている場合にのみ返されます。

    cdn
    ReturnDetailedInfo

    string

    任意

    対応するメディアアセットフィールドの詳細情報を返すかどうかを指定します。サポートされているフィールド: AiRoughData.StandardSmartTagJob: メディアアセットがタグ分析に送信されている場合に、詳細なタグ付け結果を返すかどうかを指定します。有効な値:

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

    • true: タスク結果がテキストとして返されます。

    {"AiRoughData.StandardSmartTagJob": false}

    AuthTimeout

    integer

    任意

    レスポンスフィールド

    フィールド

    型

    説明

    例

    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

    タイトル。

    Title
    Description

    string

    説明。

    Description
    Category

    string

    カテゴリ。

    Category
    MediaTags

    string

    タグ。

    Tag,tag1
    CoverURL

    string

    カバー URL。

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

    string

    ユーザーデータ。

    userDataTest
    Snapshots

    string

    スナップショット。

    [ "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

    メディアアセットの作成時間。時間は ISO 8601 標準に従い、協定世界時 (UTC) (末尾が Z) で表示されます。

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

    string

    メディアアセットの更新時間。時間は ISO 8601 標準に従い、協定世界時 (UTC) (末尾が Z) で表示されます。

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

    string

    メディアアセットの削除時間。時間は ISO 8601 標準に従い、協定世界時 (UTC) (末尾が Z) で表示されます。

    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。ID の長さは 6～64 文字で、小文字、大文字、数字、ハイフン、アンダースコアのみ使用できます。ID はユーザーディメンション内で一意である必要があります。

    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

    ビットレート。

    1132.68
    Width

    string

    幅。

    960
    Height

    string

    高さ。

    540
    CreateTime

    string

    ファイルの作成時間。時間は ISO 8601 標準に従い、協定世界時 (UTC) (末尾が Z) で表示されます。

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

    string

    ファイルの更新時間。時間は ISO 8601 標準に従い、協定世界時 (UTC) (末尾が Z) で表示されます。

    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

    サンプルレート。

    44100
    Channels

    string

    チャンネル数。

    2
    ChannelLayout

    string

    チャンネル出力レイアウト。

    stereo
    Timebase

    string

    時間ベース。

    1/44100
    StartTime

    string

    開始時刻 (秒単位)。

    0.000000
    Duration

    string

    持続時間。

    16.200998
    Bitrate

    string

    ビットレート。

    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

    サンプル縦横比。

    0:1
    Dar

    string

    表示縦横比。

    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

    ビットレート。

    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

    ストレージタイプ。インテリジェント分析の完了後にデータを検索ライブラリに保存するかどうかを指定します。有効な値:

    • TEXT: テキストライブラリ

    TEXT
    AiCategory

    string

    AI カテゴリ。有効な値:

    • Lifestyle: ライフスタイル

    • Beauty: 美容

    • Cute pets: かわいいペット

    • News: ニュース

    • Advertisement: 広告

    • Environment and resources: 環境とリソース

    • Automotive: 自動車

    Lifestyle
    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 文字列として表されます。さまざまなタイプのデータ構造については、Result パラメーターの説明 を参照してください。

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

    string

    タグ認識タイプ。有効な値:

    • NLP: NLP 処理結果

    • TextLabel: テキストタグ

    • VideoLabel: ビデオタグ

    • 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": "[",
      "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": "Life",
      "AiJobId": "****483915d4f2cd8ac20b48fb04****",
      "StandardSmartTagJob": {
        "AiJobId": "****483915d4f2cd8ac20b48fb04****",
        "Status": "Analyzing",
        "ResultUrl": "http://xx.oss-cn-shanghai.aliyuncs.com/result2.txt",
        "Results": [
          {
            "Data": "{\"autoChapters\": [...]}",
            "Type": "NLP"
          }
        ]
      }
    }
  }
}

    エラーコード

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

    変更履歴

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