All Products
Search

This Product

    Intelligent Media Services:SearchMedia

    Document Center

    Intelligent Media Services:SearchMedia

    Last Updated:Aug 06, 2026

    Mengembalikan informasi aset media yang sesuai dengan kondisi filter yang ditentukan.

    Deskripsi operasi

    Untuk menggunakan fitur pencarian multimodal Alibaba Cloud Intelligent Media Services atau berkonsultasi mengenai isu terkait, cari grup DingTalk (30415005038) dan bergabunglah ke grup 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

    *Semua sumber daya.

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    Match

    string

    No

    Kondisi filter.

    Title = 'China' and utcCreate = ['1693367158561','1693367158562']
    SortBy

    string

    No

    Bidang pengurutan dan urutan pengurutan, dipisahkan 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 pagination. Ini adalah bidang 32 karakter. Anda tidak perlu mengatur parameter ini untuk permintaan pencarian pertama. Ketika permintaan pencarian menemukan data, server mengembalikan nilai parameter ini untuk mencatat posisi saat ini dari data pencarian. Catat nilai parameter yang dikembalikan dan atur parameter ini pada permintaan pencarian berikutnya sesuai dengan persyaratan atau saran berikut: Parameter ini harus diatur ketika Anda perlu melakukan traversal seluruh data yang sesuai dengan kondisi pencarian. Saat nilai parameter PageNo melebihi 200, atur parameter ini untuk mengoptimalkan performa pencarian. Anda hanya dapat melakukan paging maju, dan jarak paging maksimum adalah 1.000 aset media.

    F8C4F642184DBDA5D93907A70AAE****
    SearchLibName

    string

    No

    Pustaka pencarian.

    test-1
    CustomFilters

    string

    No

    Filter kustom. Ini adalah string JSON. Bidang yang didukung meliputi bidang integer intField1 dan bidang string strField1 serta strField2. Setiap bidang hanya mendukung satu jenis pencocokan. Filter pada bidang yang berbeda digabungkan dengan hubungan AND.

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

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Skema Respons。

    RequestId

    string

    ID permintaan.

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

    string

    Menunjukkan apakah permintaan berhasil.

    True
    Code

    string

    Kode respons.

    200
    MediaInfoList

    array<object>

    Kumpulan aset media yang memenuhi kriteria yang ditentukan.

    array<object>

    Daftar informasi aset media.

    MediaId

    string

    ID aset media.

    3b187b3620c8490886cfc2a9578c****
    MediaBasicInfo

    object

    Informasi dasar aset media.

    MediaId

    string

    ID aset media.

    132bd600fc3c71ec99476732a78f****
    InputURL

    string

    URL sumber aset media.

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

    string

    Jenis aset media.

    video
    BusinessType

    string

    Jenis bisnis aset media.

    opening
    Source

    string

    Sumber aset media.

    oss
    Title

    string

    Judul aset media.

    Smart landscape-to-portrait conversion
    Description

    string

    Deskripsi aset media.

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

    string

    Kategori aset media.

    image
    MediaTags

    string

    Tag yang diberikan pada aset media. Beberapa tag dipisahkan dengan koma.

    tags,tags2

    CoverURL

    string

    URL gambar sampul.

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

    string

    Data pengguna kustom.

    userData
    Snapshots

    string

    Informasi snapshot dalam format JSON.

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

    string

    Status aset media.

    Normal
    TranscodeStatus

    string

    Status transkoding aset media.

    Init
    CreateTime

    string

    Waktu pembuatan aset media.

    2020-12-01T19:48Z
    ModifiedTime

    string

    Waktu terakhir aset media dimodifikasi.

    2020-12-01T19:48Z

    DeletedTime

    string

    Waktu penghapusan aset media.

    2020-12-01T19:48Z

    SpriteImages

    string

    Informasi Sprite Image dalam format 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 kategori.

    44
    Biz

    string

    Bisnis tempat aset media tersebut berada.

    IMS
    UploadSource

    string

    Sumber unggahan.

    general
    CateName

    string

    Nama kategori.

    Subcategory 1
    ReferenceId

    string

    ID kustom unik untuk pengguna. Panjangnya harus 6 hingga 64 karakter dan dapat berisi huruf, angka, tanda hubung (-), dan garis bawah (_).

    123-123
    Namespace

    string

    Namespace.

    name-1
    VisionDescription

    string

    Deskripsi konten media yang dihasilkan oleh visi komputer.

    足球进球
    StreamStatus

    string

    Status aliran.

    Active
    FileInfoList

    array<object>

    FileInfos。

    array<object>

    Daftar informasi file.

    FileBasicInfo

    object

    Informasi dasar tentang file, seperti durasi dan ukurannya.

    FileName

    string

    Nama file.

    164265080291300080527050.wav
    FileStatus

    string

    Status file.

    Normal
    FileType

    string

    Jenis file.

    source_file
    FileSize

    string

    Ukuran file dalam byte.

    324784
    FileUrl

    string

    URL Object Storage Service (OSS) file tersebut.

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

    string

    Wilayah tempat file disimpan.

    cn-beijing
    FormatName

    string

    Format kontainer file.

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

    string

    Durasi file.

    60.00000

    Bitrate

    string

    Bitrate file.

    1912.13

    Width

    string

    Lebar video dalam piksel.

    1920
    Height

    string

    Tinggi video dalam piksel.

    480
    CreateTime

    string

    Waktu pembuatan file.

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

    string

    Waktu terakhir file dimodifikasi.

    2021-12-10T12:19Z
    ImagesInput

    string

    Informasi tentang set gambar.

    {}
    AiData

    object

    Detail AI.

    AiLabelInfo

    array<object>

    Daftar informasi label AI.

    array<object>

    Objek label AI.

    FaceId

    string

    ID wajah yang dikenali.

    5FE19530C7A422197535FE74F5DB****
    LabelType

    string

    Jenis label.

    Object
    Source

    string

    Sumber data AI.

    vision
    Category

    string

    Kategori label.

    Vehicle
    LabelName

    string

    Nama entitas.

    Car
    LabelId

    string

    ID entitas.

    10310250338
    Occurrences

    array<object>

    Daftar klip tempat entitas muncul.

    array<object>

    Objek klip.

    Score

    number

    Skor kepercayaan hasil pengenalan.

    0.75287705
    Image

    string

    Gambar optimal wajah yang dikenali, dikodekan dalam Base64.

    99C64F6287
    TableBatchSeqId

    string

    ID urutan tabel vektor.

    85010D1
    clipId

    string

    ID klip.

    5FE19530C7A422197535FE74F5DB****
    From

    number

    Waktu mulai klip.

    1.4
    To

    number

    Waktu akhir klip.

    2.5
    FinegrainName

    string

    Nama detail halus entitas.

    Car
    FinegrainId

    string

    ID detail halus entitas.

    10310250338
    Content

    string

    Konten teks.

    Pipi
    Tracks

    array<object>

    Urutan track yang merepresentasikan entitas dalam klip.

    object

    Titik data track.

    Size

    number

    Ukuran Kotak pembatas.

    50.2
    Position

    string

    Koordinat Kotak pembatas.

    468.0;67.0;615.0;267.0
    Timestamp

    number

    Timestamp titik data track.

    1.4
    AsrInfo

    array<object>

    Daftar hasil Automatic Speech Recognition (ASR).

    object

    Objek hasil ASR.

    From

    number

    Waktu mulai klip.

    1.4
    To

    number

    Waktu akhir klip.

    2.5
    ClipId

    string

    ID klip.

    5FE19530C7A422197535FE74F5DB****
    Content

    string

    Konten teks hasil transkripsi.

    I am Pipi.
    Timestamp

    number

    Timestamp klip.

    1.4
    OcrInfo

    array<object>

    Daftar hasil Optical Character Recognition (OCR).

    object

    Objek hasil OCR.

    From

    number

    Waktu mulai klip.

    1.4
    To

    number

    Waktu akhir klip.

    2.5
    ClipId

    string

    ID klip.

    5FE19530C7A422197535FE74F5DB****
    Content

    string

    Konten teks yang dikenali.

    我是皮皮
    Timestamp

    number

    Timestamp klip.

    1.4
    AiRoughData

    object

    Data ringkasan AI.

    SaveType

    string

    Jenis penyimpanan data AI.

    TEXT
    Status

    string

    Status penyimpanan data AI.

    SaveSuccess
    AiJobId

    string

    ID pekerjaan AI.

    cd35b0b0025f71edbfcb472190a9****
    Result

    string

    URL file hasil AI mentah.

    http://xxxx.json
    AiCategory

    string

    Kategori AI yang diterapkan pada aset media.

    视频AI分类
    IndexStatusList

    array<object>

    Daftar status indeks.

    object

    Status indeks.

    IndexType

    string

    Jenis indeks. Nilai yang valid:

    • mm: Large Language Model (LLM).

    • face: Wajah.

    • aiLabel: Pelabelan cerdas.

    mm
    IndexStatus

    string

    Status indeks. Nilai yang valid:

    • Running: Indeks sedang dibuat.

    • Fail: Pembuatan indeks gagal.

    • Success: Indeks berhasil dibuat.

    Success
    CustomFields

    string

    Parameter filter kustom.

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

    string

    Token pagination.

    F8C4F642184DBDA5D93907A70AAE****
    Total

    integer

    Jumlah total aset media yang memenuhi kondisi yang ditentukan.

    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": "Smart landscape-to-portrait conversion",
        "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": "Subcategory 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": "Object",
            "Source": "vision",
            "Category": "Vehicle",
            "LabelName": "Car",
            "LabelId": "10310250338",
            "Occurrences": [
              {
                "Score": 0.75287705,
                "Image": "99C64F6287",
                "TableBatchSeqId": "85010D1",
                "clipId": "5FE19530C7A422197535FE74F5DB****",
                "From": 1.4,
                "To": 2.5,
                "FinegrainName": "Car",
                "FinegrainId": "10310250338",
                "Content": "Pipi",
                "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": "I am Pipi.",
            "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.