All Products
Search

This Product

    Intelligent Media Services:SearchMedia

    Document Center

    Intelligent Media Services:SearchMedia

    Last Updated:Jun 11, 2026

    Mengembalikan informasi Aset media yang sesuai dengan kriteria yang ditentukan berdasarkan parameter yang diberikan pengguna.

    Deskripsi operasi

    Untuk menggunakan fitur pencarian multimodal dari Alibaba Cloud Intelligent Media Services atau berkonsultasi mengenai masalah terkait, cari kelompok DingTalk (30415005038) dan bergabung dengan kelompok dukungan pelanggan pencarian multimodal Intelligent Media Services untuk menghubungi kami.

    Coba sekarang

    Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

    Test

    RAM authorization

    Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

    • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

    • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

    • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

    • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

      • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

      • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

    • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

    • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    ice:SearchMedia

    get

    *全部资源

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    Match

    string

    No

    Kondisi filter. .

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

    string

    No

    Bidang pengurutan dan Pesanan pengurutan. Pisahkan beberapa nilai dengan koma (,).

    utcCreate:Desc
    PageNo

    integer

    No

    Nomor halaman saat ini. Nilai default: 1.

    1
    PageSize

    integer

    No

    Jumlah entri per halaman. Nilai default: 10. Nilai maksimum: 50.

    20
    EntityId

    string

    No

    ID entitas.

    2d3bf1e35a1e42b5ab338d701efa****
    ScrollToken

    string

    No

    Token paginasi. String 32 karakter. Anda tidak perlu menyetel parameter ini untuk permintaan pencarian pertama. Ketika permintaan pencarian mencocokkan data, server mengembalikan nilai parameter ini untuk Catatan posisi data pencarian saat ini. Catatan nilai parameter yang dikembalikan dan setel parameter ini di permintaan pencarian berikutnya sebagai berikut: Parameter ini diperlukan jika Anda ingin menelusuri semua data yang sesuai dengan kriteria pencarian. Jika nilai parameter PageNo melebihi 200, setel parameter ini untuk mengoptimalkan kinerja pencarian. Anda hanya dapat melakukan paginasi maju, dengan jarak paginasi maksimum 1000 Aset media.

    F8C4F642184DBDA5D93907A70AAE****
    SearchLibName

    string

    No

    Pustaka pencarian.

    test-1
    CustomFilters

    string

    No

    Filter kustom. String JSON. Bidang yang didukung mencakup bidang integer intField1 dan bidang string strField1 serta strField2. Setiap bidang hanya mendukung satu mode pencocokan. Filter pada bidang berbeda menggunakan hubungan AND.

    • Pencocokan tepat, seperti {"intField1":12,"strField1":"abc"}

    • Pencocokan multi-nilai, seperti {"intField1":[12,13],"strField1":["abc","cd"]}

    • Pencocokan rentang, seperti {"intField1":{"gte":12,"lte":13}}.

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

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Skema tanggapan.

    RequestId

    string

    ID permintaan.

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

    string

    Apakah permintaan berhasil.

    True
    Code

    string

    Kode tanggapan.

    200
    MediaInfoList

    array<object>

    Kumpulan Aset media yang sesuai dengan kriteria.

    array<object>

    Daftar informasi Aset media.

    MediaId

    string

    ID Aset media.

    3b187b3620c8490886cfc2a9578c****
    MediaBasicInfo

    object

    Informasi dasar Aset media.

    MediaId

    string

    The ID of the media asset.

    132bd600fc3c71ec99476732a78f****
    InputURL

    string

    The address of the media asset that is waiting to be registered.

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

    string

    The type of the media asset.

    video
    BusinessType

    string

    The business type of the media asset.

    opening
    Source

    string

    The source of the media asset.

    oss
    Title

    string

    The title of the media asset.

    智能横屏转竖屏
    Description

    string

    The description of the media asset.

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

    string

    The category of the media asset.

    image
    MediaTags

    string

    The tags of the media asset.

    tags,tags2

    CoverURL

    string

    The thumbnail URL of the media asset.

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

    string

    The user data.

    userData
    Snapshots

    string

    The snapshots of the media asset.

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

    string

    The state of the media asset.

    Normal
    TranscodeStatus

    string

    The transcoding status of the media asset.

    Init
    CreateTime

    string

    The time when the media asset was created.

    2020-12-01T19:48Z
    ModifiedTime

    string

    The time when the media asset was modified.

    2020-12-01T19:48Z

    DeletedTime

    string

    The time when the media asset was deleted.

    2020-12-01T19:48Z

    SpriteImages

    string

    The image sprite of the media asset

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

    The ID of the category.

    44
    Biz

    string

    The business to which the media asset belongs.

    IMS
    UploadSource

    string

    The upload source of the media asset.

    general
    CateName

    string

    The name of the category.

    子分类1
    ReferenceId

    string

    The custom ID of the media asset. The ID is a string that contains 6 to 64 characters. Only letters, digits, hyphens (-), and underscores (_) are supported. Each custom ID is unique.

    123-123
    Namespace

    string

    Namespace.

    name-1
    VisionDescription

    string

    Visual description.

    足球进球
    StreamStatus

    string

    Stream status

    Active
    FileInfoList

    array<object>

    FileInfo.

    array<object>

    Daftar informasi file.

    FileBasicInfo

    object

    The basic information about the file, such as the duration and size.

    FileName

    string

    The name of the file.

    164265080291300080527050.wav
    FileStatus

    string

    The status of the file.

    Normal
    FileType

    string

    The type of the file.

    source_file
    FileSize

    string

    The size of the file in bytes.

    324784
    FileUrl

    string

    The Object Storage Service (OSS) URL of the file.

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

    string

    The region in which the file is stored.

    cn-beijing
    FormatName

    string

    The encapsulation format of the file.

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

    string

    The duration of the file.

    60.00000

    Bitrate

    string

    The bitrate of the file.

    1912.13

    Width

    string

    The width of the file.

    1920
    Height

    string

    The height of the file.

    480
    CreateTime

    string

    The time when the file was created.

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

    string

    The time when the file was last modified.

    2021-12-10T12:19Z
    ImagesInput

    string

    The image set information.

    {}
    AiData

    object

    Detail AI.

    AiLabelInfo

    array<object>

    The tags of the intelligent AI job.

    array<object>

    The tag of the intelligent AI job.

    FaceId

    string

    The face ID.

    5FE19530C7A422197535FE74F5DB****
    LabelType

    string

    The type of the tag.

    物体
    Source

    string

    The source.

    vision
    Category

    string

    The category.

    交通工具
    LabelName

    string

    The name of the entity.

    车
    LabelId

    string

    The ID of the entity.

    10310250338
    Occurrences

    array<object>

    The clips.

    array<object>

    The clip.

    Score

    number

    The score.

    0.75287705
    Image

    string

    The optimal face image encoded in Base64.

    99C64F6287
    TableBatchSeqId

    string

    The sequence ID of the vector table.

    85010D1
    clipId

    string

    The ID of the clip.

    5FE19530C7A422197535FE74F5DB****
    From

    number

    The start time of the clip.

    1.4
    To

    number

    The end time of the clip.

    2.5
    FinegrainName

    string

    The fine-grained name of the entity.

    车
    FinegrainId

    string

    The fine-grained ID of the entity.

    10310250338
    Content

    string

    The text content.

    皮皮
    Tracks

    array<object>

    The track sequence.

    object

    The track.

    Size

    number

    The size of the bounding box.

    50.2
    Position

    string

    The coordinates of the bounding box.

    468.0;67.0;615.0;267.0
    Timestamp

    number

    The timestamp of the track.

    1.4
    AsrInfo

    array<object>

    The information about audio files.

    object

    The audio information.

    From

    number

    The start time of the clip.

    1.4
    To

    number

    The end time of the clip.

    2.5
    ClipId

    string

    The ID of the clip.

    5FE19530C7A422197535FE74F5DB****
    Content

    string

    The text content.

    我是皮皮
    Timestamp

    number

    The timestamp of the clip.

    1.4
    OcrInfo

    array<object>

    The subtitles.

    object

    The information about the subtitle.

    From

    number

    The start time of the clip.

    1.4
    To

    number

    The end time of the clip.

    2.5
    ClipId

    string

    The ID of the clip.

    5FE19530C7A422197535FE74F5DB****
    Content

    string

    The text content.

    我是皮皮
    Timestamp

    number

    The timestamp of the clip.

    1.4
    AiRoughData

    object

    Data ringkasan AI.

    SaveType

    string

    The save type.

    TEXT
    Status

    string

    The data status.

    SaveSuccess
    AiJobId

    string

    The ID of the AI job.

    cd35b0b0025f71edbfcb472190a9****
    Result

    string

    The results of the AI job.

    http://xxxx.json
    AiCategory

    string

    TV Series

    视频AI分类
    IndexStatusList

    array<object>

    Daftar status Indeks.

    object

    Status Indeks.

    IndexType

    string

    Index category. Valid values:

    • mm: LLM

    • face: face

    • aiLabel: DataQ - Smart Tag Service

    mm
    IndexStatus

    string

    Index status. Valid values:

    • Running: running

    • Fail: failed

    • Success: Succeeded

    Success
    CustomFields

    string

    Parameter filter kustom.

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

    string

    Token paginasi.

    F8C4F642184DBDA5D93907A70AAE****
    Total

    integer

    Jumlah total Aset media yang sesuai dengan kriteria.

    163

    Contoh

    Respons sukses

    JSONformat

    {
  "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
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.