All Products
Search

This Product

    Intelligent Media Services:SearchMediaByAILabel

    Document Center

    Intelligent Media Services:SearchMediaByAILabel

    Last Updated:Jun 11, 2026

    Melakukan pencarian multimodal berdasarkan nama orang, subtitle, atau kategori AI.

    Deskripsi operasi

    Melakukan pencarian multimodal berdasarkan nama orang, subtitle, atau kategori AI. Pencarian kasar mengembalikan hasil pada tingkat aset media. Pencarian halus mengembalikan informasi segmen yang cocok dalam aset media.

    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:SearchMediaByAILabel

    get

    *全部资源

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    SearchLibName

    string

    No

    Nama pustaka pencarian.

    test-1
    MediaType

    string

    No

    Tipe aset media. Nilai valid:

    • image: image

    • video: video

    • audio: audio.

    Valid values:

    • image :

      image.

    • video :

      video.

    • audio :

      audio.

    video
    SortBy

    string

    No

    Urutan pengurutan hasil kueri. Nilai valid:

    • CreationTime:Desc (default): Mengurutkan hasil berdasarkan waktu pembuatan secara menurun.

    • CreationTime:Asc: Mengurutkan hasil berdasarkan waktu pembuatan secara menaik.

    CreationTime:Desc

    PageNo

    integer

    No

    Nomor halaman. Nilai default: 1.

    1
    PageSize

    integer

    No

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

    20
    Text

    string

    No

    Konten pencarian.

    风筝
    MultimodalSearchType

    string

    No

    Tipe pencarian multimodal. Nilai default: FullSearch. Nilai valid:

    • PersonName: pencarian berdasarkan nama orang

    • Ocr: pencarian berdasarkan subtitle

    • AiCategory: pencarian berdasarkan kategorisasi AI

    • FullSearch: pencarian teks lengkap.

    Valid values:

    • PersonName :

      PersonName.

    • AiCategory :

      AiCategory.

    • FullSearch :

      FullSearch.

    • Ocr :

      Ocr.

    Ocr
    SpecificSearch

    boolean

    No

    Apakah akan menggunakan pencarian halus. Nilai valid:

    • true: Pencarian halus.

    • false: Pencarian kasar.

    true
    MediaId

    string

    No

    ID aset media. Parameter ini wajib diisi untuk pencarian halus.

    ****c469e944b5a856828dc2****

    MatchingMode

    string

    No

    Mode pencocokan. Nilai default: fuzzy. Nilai valid:

    • fuzzy: Pencocokan kabur

    • precise: Pencocokan tepat. Mode ini hanya berlaku untuk aset media yang baru ditambahkan.

    Valid values:

    • precise :

      precise.

    • fuzzy :

      fuzzy.

    fuzzy
    Namespace

    string

    No

    Namespace.

    name-1
    CustomFilters

    string

    No

    Filter kustom. String JSON. Bidang yang didukung meliputi bidang integer intField1 dan bidang string strField1 serta strField2. Setiap bidang hanya mendukung satu tipe pencocokan. Filter pada bidang berbeda digabungkan dengan logika 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"}
    UtcCreate

    string

    No

    Waktu pembuatan, dalam timestamp milidetik. gte menunjukkan lebih besar atau sama dengan, dan lte menunjukkan kurang dari atau sama dengan.

    • Rentang, seperti {"gte":1761205662998,"lte":1771205662998}.

    {"gte":1761205662998,"lte":1771205662998}

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Skema Tanggapan.

    RequestId

    string

    ID permintaan.

    ******11-DB8D-4A9A-875B-275798******
    Success

    string

    Apakah permintaan berhasil.

    true
    Code

    string

    Kode pengembalian.

    200
    MediaList

    array<object>

    Daftar aset media yang sesuai dengan kriteria.

    array<object>

    Detail aset media.

    AiData

    object

    Detail AI.

    AiLabelInfo

    array<object>

    The tags of the AI job.

    array<object>

    The information about the AI tag.

    FaceId

    string

    The ID of the face.

    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.

    103102503**
    Occurrences

    array<object>

    The information about the clips.

    array<object>

    The information about the clip.

    Score

    number

    The score.

    0.75287705

    Image

    string

    The image that contains the most face information.

    https://service-****-public.oss-cn-hangzhou.aliyuncs.com/1563457****438522/service-image/f788974f-9595-43b2-a478-7c7a1afb****.jpg
    TableBatchSeqId

    string

    The sequence ID of the vector table.

    85010D1**
    ClipId

    string

    The ID of the clip.

    158730355E4B82257D8AA1583A58****
    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.

    103102503**
    Content

    string

    The content of the text.

    智能标签测试

    Tracks

    array<object>

    The tracks.

    object

    The track.

    Size

    number

    The size of the bounding box.

    50
    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 information about the audio file.

    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 content of the audio.

    智能标签测试
    Timestamp

    number

    The timestamp of the clip.

    1.4
    OcrInfo

    array<object>

    The information about subtitle files.

    object

    The information about the subtitle file.

    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 content of the text.

    皮皮
    Timestamp

    number

    The timestamp of the clip.

    1.4
    StorageLocation

    string

    Alamat penyimpanan.

    out-****.oss-cn-shanghai.aliyuncs.com

    Status

    string

    Status video.

    Valid values:

    • PrepareFail :

      PrepareFail.

    • UploadFail :

      UploadFail.

    • Init :

      Init.

    • UploadSucc :

      UploadSucc.

    • Transcoding :

      Transcoding.

    • TranscodeFail :

      TranscodeFail.

    • Deleted :

      Deleted.

    • Normal :

      Normal.

    • Uploading :

      Uploading.

    • Preparing :

      Preparing.

    • Blocked :

      Blocked.

    • Checking :

      Checking.

    Normal
    CreationTime

    string

    Waktu pembuatan. Format: yyyy-MM-ddTHH:mm:ssZ (UTC).

    2017-11-14T09:15:50Z

    ModificationTime

    string

    Waktu modifikasi. Format: yyyy-MM-ddTHH:mm:ssZ (UTC).

    2017-11-14T09:15:50Z

    MediaId

    string

    ID aset media.

    1c6ce34007d571ed94667630a6bc****

    Tags

    string

    Daftar tag.

    标签1, 标签2

    Description

    string

    Deskripsi.

    阿里云VOD视频描述

    AppId

    string

    ID aplikasi. Nilai default: app-1000000.

    app-1000000
    Size

    integer

    Ukuran file sumber. Unit: bytes.

    10897890
    CoverUrl

    string

    URL sampul.

    http://example.aliyundoc.com/snapshot/****.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e27333****
    Duration

    number

    Durasi. Unit: seconds.

    12.2
    Title

    string

    Judul.

    史上最牛音乐播放器

    Snapshots

    array

    Array URL Snapshot video.

    string

    URL Snapshot video.

    http://example.aliyundoc.com/snapshot/****.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e27333****
    Total

    integer

    Jumlah total aset media yang sesuai dengan kriteria.

    30

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "Success": "true",
  "Code": "200",
  "MediaList": [
    {
      "AiData": {
        "AiLabelInfo": [
          {
            "FaceId": "5FE19530C7A422197535FE74F5DB****\n",
            "LabelType": "物体",
            "Source": "vision",
            "Category": "交通工具",
            "LabelName": "车",
            "LabelId": "103102503**",
            "Occurrences": [
              {
                "Score": 0.75287705,
                "Image": "https://service-****-public.oss-cn-hangzhou.aliyuncs.com/1563457****438522/service-image/f788974f-9595-43b2-a478-7c7a1afb****.jpg",
                "TableBatchSeqId": "85010D1**",
                "ClipId": "158730355E4B82257D8AA1583A58****",
                "From": 1.4,
                "To": 2.5,
                "FinegrainName": "车",
                "FinegrainId": "103102503**",
                "Content": "智能标签测试\n",
                "Tracks": [
                  {
                    "Size": 50,
                    "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****\n",
            "Content": "皮皮",
            "Timestamp": 1.4
          }
        ]
      },
      "StorageLocation": "out-****.oss-cn-shanghai.aliyuncs.com\n",
      "Status": "Normal",
      "CreationTime": "2017-11-14T09:15:50Z\n",
      "ModificationTime": "2017-11-14T09:15:50Z\n",
      "MediaId": "1c6ce34007d571ed94667630a6bc****\n",
      "Tags": "标签1, 标签2\n",
      "Description": "阿里云VOD视频描述\n",
      "AppId": "app-1000000",
      "Size": 10897890,
      "CoverUrl": "http://example.aliyundoc.com/snapshot/****.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e27333****",
      "Duration": 12.2,
      "Title": "史上最牛音乐播放器\n",
      "Snapshots": [
        "http://example.aliyundoc.com/snapshot/****.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e27333****"
      ]
    }
  ],
  "Total": 30
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.