All Products
Search
Document Center

Intelligent Media Services:Cara melakukan pencarian wajah pada banyak aset media

Last Updated:Jun 19, 2026

Intelligent Media Services (IMS) mendukung pencarian wajah pada aset media di pustaka konten, memungkinkan Anda menemukan individu tertentu atau menyaring konten sensitif dengan memanggil operasi OpenAPI.

Prasyarat

Kit pengembangan perangkat lunak (SDK) sisi server Intelligent Media Services (IMS) telah diinstal. Untuk informasi selengkapnya, lihat Instal SDK.

Prosedur

  1. Atur konfigurasi analisis konten cerdas.

    Panggil operasi CreateSearchIndex untuk mengaktifkan analisis konten cerdas otomatis saat pendaftaran aset media dan atur tipe indeks ke face.

    com.aliyun.ice20201109.Client client = Sample.createClient("accessKeyId", "accessKeySecret"); 
    com.aliyun.ice20201109.models.CreateSearchIndexRequest createSearchIndexRequest = new com.aliyun.ice20201109.models.CreateSearchIndexRequest() 
           .setIndexType("face"); 
    com.aliyun.teautil.models.RuntimeOptions runtime = new com.aliyun.teautil.models.RuntimeOptions(); 
    client.createSearchIndexWithOptions(createSearchIndexRequest, runtime);
  2. Daftarkan resource pustaka konten.

    Panggil operasi RegisterMediaInfo untuk menambahkan aset media ke pustaka konten. Pencarian wajah didukung untuk gambar dan video.

    com.aliyun.ice20201109.Client client = Sample.createClient("accessKeyId", "accessKeySecret");
    com.aliyun.ice20201109.models.RegisterMediaInfoRequest registerMediaInfoRequest = new com.aliyun.ice20201109.models.RegisterMediaInfoRequest()
            .setMediaType("video")
            .setTitle("face-test12")
            .setInputURL("oss://example-bucket/example.mp4");
    com.aliyun.teautil.models.RuntimeOptions runtime = new com.aliyun.teautil.models.RuntimeOptions();
    client.registerMediaInfoWithOptions(registerMediaInfoRequest, runtime);
  3. Ambil informasi aset media.

    Panggil operasi GetMediaInfo untuk memastikan bahwa aset media berhasil ditambahkan ke pustaka konten.

    com.aliyun.ice20201109.Client client = Sample.createClient("accessKeyId", "accessKeySecret");
    com.aliyun.ice20201109.models.GetMediaInfoRequest getMediaInfoRequest = new com.aliyun.ice20201109.models.GetMediaInfoRequest()
            .setInputURL("oss://example-bucket/example.mp4");
    com.aliyun.teautil.models.RuntimeOptions runtime = new com.aliyun.teautil.models.RuntimeOptions();
    client.getMediaInfoWithOptions(getMediaInfoRequest, runtime);

    Jika nilai AiRoughData.Status dalam respons adalah SaveSuccess, aset media berhasil ditambahkan ke pustaka konten.

  4. Cari aset media di pustaka konten berdasarkan gambar wajah (pencarian kasar).

    Panggil operasi SearchMediaByFace dengan URL gambar wajah untuk menemukan aset media yang berisi wajah yang cocok.

    com.aliyun.ice20201109.Client client = Sample.createClient("accessKeyId", "accessKeySecret");
    com.aliyun.ice20201109.models.SearchMediaByFaceRequest searchMediaByFaceRequest = new com.aliyun.ice20201109.models.SearchMediaByFaceRequest()
            .setFaceSearchToken("test001")
            .setPersonImageUrl("https://****.oss-cn-shanghai.aliyuncs.com/test/testFacePic.png");
    com.aliyun.teautil.models.RuntimeOptions runtime = new com.aliyun.teautil.models.RuntimeOptions();
    client.searchMediaByFaceWithOptions(searchMediaByFaceRequest, runtime);

    Contoh respons:

    {
      "RequestId": "F0FBE61A-66FF-55C0-8900-EE816FA20B8D",
      "MediaInfoList": [
        {
          "MediaId": "92796460cd4571ed91c6e7e7c45b****"
        },
        {
          "MediaId": "b5a003f0cd3f71ed919fe7e7c45b****"
        }
      ],
      "Total": 2,
      "Code": "200",
      "Success": true
    }
  5. Cari klip aset media di pustaka konten berdasarkan gambar wajah (pencarian detail halus).

    Panggil operasi SearchMediaClipByFace dengan MediaId yang dikembalikan pada Langkah 4 untuk mengambil klip spesifik yang berisi wajah yang cocok.

    com.aliyun.ice20201109.Client client = Sample.createClient("accessKeyId", "accessKeySecret");
    com.aliyun.ice20201109.models.SearchMediaClipByFaceRequest searchMediaClipByFaceRequest = new com.aliyun.ice20201109.models.SearchMediaClipByFaceRequest()
            .setFaceSearchToken("test001")
            .setMediaId("92796460cd4571ed91c6e7e7c45b****");
    com.aliyun.teautil.models.RuntimeOptions runtime = new com.aliyun.teautil.models.RuntimeOptions();
    client.searchMediaClipByFaceWithOptions(searchMediaClipByFaceRequest, runtime);

Referensi API

Hubungi kami

Jika Anda memiliki pertanyaan atau membutuhkan dukungan teknis, bergabunglah dengan grup DingTalk untuk IMS (ID: 84650000851) untuk menghubungi kami.