すべてのプロダクト
Search

このプロダクト

    Intelligent Media Services:SearchMedia

    ドキュメントセンター

    Intelligent Media Services:SearchMedia

    最終更新日:Mar 23, 2026

    指定されたパラメーターに一致するメディアアセットを返します。

    操作説明

    Intelligent Media Management (IMM) の「インテリジェントなメディアアセット検索」機能についてご質問がある場合は、DingTalk グループ ID `30415005038` を検索して、マルチモーダル検索に関する Q&A グループに参加してください。

    今すぐお試しください

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

    get

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    Match

    string

    任意

    検索のフィルター条件です。

    title = '中国' and utcCreate = ['1693367158561','1693367158562']
    SortBy

    string

    任意

    並べ替え対象のフィールドおよび並べ替え順序です。複数の並べ替え条件はカンマ (,) で区切ります。

    utcCreate:Desc
    PageNo

    integer

    任意

    取得するページ番号です。デフォルト値は `1` です。

    1
    PageSize

    integer

    任意

    1 ページあたりの結果件数です。デフォルト値は `10`、最大値は `50` です。

    20
    EntityId

    string

    任意

    エンティティ ID です。

    2d3bf1e35a1e42b5ab338d701efa****
    ScrollToken

    string

    任意

    深層ページネーション用のスクロールトークンです。このトークンは 32 文字の文字列です。初回の検索リクエストではこのパラメーターは必須ではありません。検索が成功した場合、応答には現在の位置を示す `ScrollToken` が含まれます。後続のリクエストでは、このトークンを使用して次のページの結果を取得します。すべての一致する結果を反復処理するには、このパラメーターを指定する必要があります。パフォーマンスを最適化するため、`PageNo` の値が `200` を超える場合にこのパラメーターを使用することを推奨します。スクロールは前方のみ可能で、最大で 1,000 件のメディアアセットまで取得できます。

    F8C4F642184DBDA5D93907A70AAE****
    SearchLibName

    string

    任意

    検索ライブラリの名前です。

    test-1
    CustomFilters

    string

    任意

    カスタムフィルターを JSON 文字列形式で指定します。整数型フィールド `intField1` および文字列型フィールド `strField1`、`strField2` をサポートしています。各フィールドに対しては 1 種類の一致タイプのみ使用できます。異なるフィールド間の条件は論理積 (AND) で結合されます。

    • 完全一致: {"intField1":12,"strField1":"abc"}

    • 複数値一致: {"intField1":[12,13],"strField1":["abc","cd"]}

    • 範囲一致: {"intField1":{"gte":12,"lte":13}}

    {"intField1":{"gte":12,"lte":13},"strField2":["cd","de"],"strField1":"abc"}

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    応答スキーマです。

    RequestId

    string

    リクエスト ID です。

    6F61C357-ACC0-57FB-876E-D5879533****
    Success

    string

    リクエストが成功したかどうかを示します。

    True
    Code

    string

    リターンコードです。

    200
    MediaInfoList

    array<object>

    検索条件に一致するメディアアセットのコレクションです。

    array<object>

    メディアアセットです。

    MediaId

    string

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

    3b187b3620c8490886cfc2a9578c****
    MediaBasicInfo

    object

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

    MediaId

    string

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

    132bd600fc3c71ec99476732a78f****
    InputURL

    string

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

    oss://clipres/longvideo/material/voice/prod/20220418/07d7c799f6054dc3bbef250854cf8498165024814****
    MediaType

    string

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

    video
    BusinessType

    string

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

    opening
    Source

    string

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

    oss
    Title

    string

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

    智能横屏转竖屏
    Description

    string

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

    对这个视频进行转码处理了
    Category

    string

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

    image
    MediaTags

    string

    メディアアセットに割り当てられたタグです。複数のタグはカンマで区切られます。

    tags,tags2

    CoverURL

    string

    カバーアイコンの URL です。

    https://dtlive-bj.oss-cn-beijing.aliyuncs.com/cover/e694372e-4f5b-4821-ae09-efd064f2****_large_cover_url.jpg
    UserData

    string

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

    userData
    Snapshots

    string

    スナップショット情報を JSON 形式で記述します。

    [{"bucket":"example-bucket","count":"3","iceJobId":"******f48f0e4154976b2b8c45******","location":"oss-cn-beijing","snapshotRegular":"example.jpg","templateId":"******e6a6440b29eb60bd7c******"}]
    Status

    string

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

    Normal
    TranscodeStatus

    string

    メディアアセットのトランスコードステータスです。

    Init
    CreateTime

    string

    メディアアセットが作成された時刻です。

    2020-12-01T19:48Z
    ModifiedTime

    string

    メディアアセットが最後に更新された時刻です。

    2020-12-01T19:48Z

    DeletedTime

    string

    メディアアセットが削除された時刻です。

    2020-12-01T19:48Z

    SpriteImages

    string

    スプライトイメージ情報を JSON 形式で記述します。

    [{"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 です。

    44
    Biz

    string

    メディアアセットが属するビジネスです。

    IMS
    UploadSource

    string

    アップロード元です。

    general
    CateName

    string

    カテゴリ名です。

    子分类1
    ReferenceId

    string

    ユーザーが独自に定義する一意の ID です。長さは 6～64 文字で、小文字、大文字、数字、ハイフン (-)、アンダースコア (_) のみ使用できます。

    123-123
    Namespace

    string

    名前空間です。

    name-1
    VisionDescription

    string

    コンピュータービジョンによって生成されたメディアコンテンツの説明です。

    足球进球
    StreamStatus

    string

    ストリームステータスです。

    Active
    FileInfoList

    array<object>

    ファイル情報のリストです。

    array<object>

    ファイル情報オブジェクトです。

    FileBasicInfo

    object

    ファイルの基本情報（例：再生時間、サイズ）です。

    FileName

    string

    ファイル名です。

    164265080291300080527050.wav
    FileStatus

    string

    ファイルのステータスです。

    Normal
    FileType

    string

    ファイルの種別です。

    source_file
    FileSize

    string

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

    324784
    FileUrl

    string

    Object Storage Service (OSS) 上のファイルの URL です。

    https://outin-d3f4681ddfd911ec99a600163e1403e7.oss-cn-shanghai.aliyuncs.com/sv/23d5cdd1-18180984899/23d5cdd1-1818098****.mp4
    Region

    string

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

    cn-beijing
    FormatName

    string

    ファイルのコンテナ形式です。

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

    string

    ファイルの持続時間です。

    60.00000

    Bitrate

    string

    ファイルのビットレートです。

    1912.13

    Width

    string

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

    1920
    Height

    string

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

    480
    CreateTime

    string

    ファイルが作成された時刻です。

    2022-05-30T02:02:17Z
    ModifiedTime

    string

    ファイルが最後に更新された時刻です。

    2021-12-10T12:19Z
    ImagesInput

    string

    画像セットに関する情報です。

    {}
    AiData

    object

    詳細な AI 処理データです。

    AiLabelInfo

    array<object>

    AI ラベル情報のリストです。

    array<object>

    AI ラベルオブジェクトです。

    FaceId

    string

    認識された顔の ID です。

    5FE19530C7A422197535FE74F5DB****
    LabelType

    string

    ラベルの種別です。

    物体
    Source

    string

    AI データのソースです。

    vision
    Category

    string

    ラベルのカテゴリです。

    交通工具
    LabelName

    string

    エンティティの名称です。

    车
    LabelId

    string

    エンティティの ID です。

    10310250338
    Occurrences

    array<object>

    エンティティが出現するクリップのリストです。

    array<object>

    クリップオブジェクトです。

    Score

    number

    認識結果に対する信頼度スコアです。

    0.75287705
    Image

    string

    認識された顔の最適なイメージ（Base64 エンコード）です。

    99C64F6287
    TableBatchSeqId

    string

    ベクターテーブルのシーケンス ID です。

    85010D1
    clipId

    string

    クリップ ID です。

    5FE19530C7A422197535FE74F5DB****
    From

    number

    クリップの開始時刻です。

    1.4
    To

    number

    クリップの終了時刻です。

    2.5
    FinegrainName

    string

    エンティティの詳細な名称です。

    车
    FinegrainId

    string

    エンティティの詳細な ID です。

    10310250338
    Content

    string

    テキストコンテンツです。

    皮皮
    Tracks

    array<object>

    クリップ内でエンティティを表すトラックのシーケンスです。

    object

    トラックのデータポイントです。

    Size

    number

    バウンディングボックスのサイズです。

    50.2
    Position

    string

    バウンディングボックスの座標です。

    468.0;67.0;615.0;267.0
    Timestamp

    number

    トラックのデータポイントのタイムスタンプです。

    1.4
    AsrInfo

    array<object>

    音声認識 (ASR) 結果のリストです。

    object

    ASR 結果オブジェクトです。

    From

    number

    クリップの開始時刻です。

    1.4
    To

    number

    クリップの終了時刻です。

    2.5
    ClipId

    string

    クリップ ID です。

    5FE19530C7A422197535FE74F5DB****
    Content

    string

    文字起こしされたテキストコンテンツです。

    我是皮皮
    Timestamp

    number

    クリップのタイムスタンプです。

    1.4
    OcrInfo

    array<object>

    光学文字認識 (OCR) 結果のリストです。

    object

    OCR 結果オブジェクトです。

    From

    number

    クリップの開始時刻です。

    1.4
    To

    number

    クリップの終了時刻です。

    2.5
    ClipId

    string

    クリップ ID です。

    5FE19530C7A422197535FE74F5DB****
    Content

    string

    認識されたテキストコンテンツです。

    我是皮皮
    Timestamp

    number

    クリップのタイムスタンプです。

    1.4
    AiRoughData

    object

    AI 処理データの要約です。

    SaveType

    string

    AI データの保存タイプです。

    TEXT
    Status

    string

    AI データの保存ステータスです。

    SaveSuccess
    AiJobId

    string

    AI ジョブの ID です。

    cd35b0b0025f71edbfcb472190a9****
    Result

    string

    生の AI 結果ファイルの URL です。

    http://xxxx.json
    AiCategory

    string

    メディアアセットに適用される AI カテゴリです。

    视频AI分类
    IndexStatusList

    array<object>

    さまざまなインデックス種別に対するインデックスステータスのリストです。

    object

    インデックスステータスオブジェクトです。

    IndexType

    string

    インデックスの種別です。有効な値は以下のとおりです。

    • mm: 大規模言語モデル (LLM)。

    • face: 顔。

    • aiLabel: AI ラベル。

    mm
    IndexStatus

    string

    インデックスのステータスです。有効な値は以下のとおりです。

    • Running: インデックスの作成中です。

    • Fail: インデックスの作成に失敗しました。

    • Success: インデックスの作成に成功しました。

    Success
    CustomFields

    string

    フィルター用のカスタムフィールドを JSON 文字列形式で指定します。

    {\"intField1\":12,\"strField1\":\"abc\"}
    ScrollToken

    string

    次のページの結果を取得する際に使用するトークンです。

    F8C4F642184DBDA5D93907A70AAE****
    Total

    integer

    検索条件に一致するメディアアセットの総数です。

    163

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "6F61C357-ACC0-57FB-876E-D5879533****",
  "Success": "True",
  "Code": "200",
  "MediaInfoList": [
    {
      "MediaId": "3b187b3620c8490886cfc2a9578c****",
      "MediaBasicInfo": {
        "MediaId": "132bd600fc3c71ec99476732a78f****",
        "InputURL": "oss://clipres/longvideo/material/voice/prod/20220418/07d7c799f6054dc3bbef250854cf8498165024814****",
        "MediaType": "video",
        "BusinessType": "opening",
        "Source": "oss",
        "Title": "智能横屏转竖屏",
        "Description": "对这个视频进行转码处理了",
        "Category": "image",
        "MediaTags": "tags,tags2\n",
        "CoverURL": "https://dtlive-bj.oss-cn-beijing.aliyuncs.com/cover/e694372e-4f5b-4821-ae09-efd064f2****_large_cover_url.jpg",
        "UserData": "userData",
        "Snapshots": "[{\"bucket\":\"example-bucket\",\"count\":\"3\",\"iceJobId\":\"******f48f0e4154976b2b8c45******\",\"location\":\"oss-cn-beijing\",\"snapshotRegular\":\"example.jpg\",\"templateId\":\"******e6a6440b29eb60bd7c******\"}]",
        "Status": "Normal",
        "TranscodeStatus": "Init",
        "CreateTime": "2020-12-01T19:48Z",
        "ModifiedTime": "2020-12-01T19:48Z\n",
        "DeletedTime": "2020-12-01T19:48Z\n",
        "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": 44,
        "Biz": "IMS",
        "UploadSource": "general",
        "CateName": "子分类1",
        "ReferenceId": "123-123",
        "Namespace": "name-1",
        "VisionDescription": "足球进球",
        "StreamStatus": "Active"
      },
      "FileInfoList": [
        {
          "FileBasicInfo": {
            "FileName": "164265080291300080527050.wav",
            "FileStatus": "Normal",
            "FileType": "source_file",
            "FileSize": "324784",
            "FileUrl": "https://outin-d3f4681ddfd911ec99a600163e1403e7.oss-cn-shanghai.aliyuncs.com/sv/23d5cdd1-18180984899/23d5cdd1-1818098****.mp4",
            "Region": "cn-beijing",
            "FormatName": "mov,mp4,m4a,3gp,3g2,mj2",
            "Duration": "60.00000\n",
            "Bitrate": "1912.13\n",
            "Width": "1920",
            "Height": "480",
            "CreateTime": "2022-05-30T02:02:17Z",
            "ModifiedTime": "2021-12-10T12:19Z",
            "ImagesInput": "{}"
          }
        }
      ],
      "AiData": {
        "AiLabelInfo": [
          {
            "FaceId": "5FE19530C7A422197535FE74F5DB****",
            "LabelType": "物体",
            "Source": "vision",
            "Category": "交通工具",
            "LabelName": "车",
            "LabelId": "10310250338",
            "Occurrences": [
              {
                "Score": 0.75287705,
                "Image": "99C64F6287",
                "TableBatchSeqId": "85010D1",
                "clipId": "5FE19530C7A422197535FE74F5DB****",
                "From": 1.4,
                "To": 2.5,
                "FinegrainName": "车",
                "FinegrainId": "10310250338",
                "Content": "皮皮",
                "Tracks": [
                  {
                    "Size": 50.2,
                    "Position": "468.0;67.0;615.0;267.0",
                    "Timestamp": 1.4
                  }
                ]
              }
            ]
          }
        ],
        "AsrInfo": [
          {
            "From": 1.4,
            "To": 2.5,
            "ClipId": "5FE19530C7A422197535FE74F5DB****",
            "Content": "我是皮皮",
            "Timestamp": 1.4
          }
        ],
        "OcrInfo": [
          {
            "From": 1.4,
            "To": 2.5,
            "ClipId": "5FE19530C7A422197535FE74F5DB****",
            "Content": "我是皮皮",
            "Timestamp": 1.4
          }
        ]
      },
      "AiRoughData": {
        "SaveType": "TEXT",
        "Status": "SaveSuccess",
        "AiJobId": "cd35b0b0025f71edbfcb472190a9****",
        "Result": "http://xxxx.json",
        "AiCategory": "视频AI分类"
      },
      "IndexStatusList": [
        {
          "IndexType": "mm",
          "IndexStatus": "Success"
        }
      ],
      "CustomFields": "{\\\"intField1\\\":12,\\\"strField1\\\":\\\"abc\\\"}"
    }
  ],
  "ScrollToken": "F8C4F642184DBDA5D93907A70AAE****",
  "Total": 163
}

    エラーコード

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

    変更履歴

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