Tous les produits
Search
Centre de documentation

Intelligent Media Services:Recherche faciale sur un grand nombre de ressources multimédias

Dernière mise à jour :Aug 11, 2026

Intelligent Media Services (IMS) permet d'effectuer des recherches faciales sur les ressources multimédias d'une bibliothèque de contenu. En appelant les opérations OpenAPI, vous pouvez localiser des personnes spécifiques ou filtrer les contenus sensibles.

Prérequis

Le SDK serveur Intelligent Media Services (IMS) est installé. Pour plus d'informations, consultez la rubrique Installation du SDK.

Procédure

  1. Définissez la configuration de l'analyse intelligente du contenu.

    Appelez l'opération CreateSearchIndex pour activer l'analyse intelligente automatique du contenu lors de l'enregistrement des ressources multimédias et définissez le type d'index sur 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. Enregistrez une ressource de la bibliothèque de contenu.

    Appelez l'opération RegisterMediaInfo pour ajouter une ressource multimédia à la bibliothèque de contenu. La recherche faciale est disponible pour les images et les vidéos.

    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. Récupérez les informations sur la ressource multimédia.

    Appelez l'opération GetMediaInfo pour confirmer que la ressource multimédia a bien été ajoutée à la bibliothèque de contenu.

    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);

    Si la valeur de AiRoughData.Status dans la réponse est SaveSuccess, la ressource multimédia a bien été ajoutée à la bibliothèque de contenu.

  4. Recherchez des ressources multimédias dans la bibliothèque de contenu par image de visage (recherche approximative).

    Appelez l'opération SearchMediaByFace avec l'URL d'une image de visage pour trouver les ressources multimédias contenant le visage correspondant.

    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);

    Exemple de réponse :

    {
      "RequestId": "F0FBE61A-66FF-55C0-8900-EE816FA20B8D",
      "MediaInfoList": [
        {
          "MediaId": "92796460cd4571ed91c6e7e7c45b****"
        },
        {
          "MediaId": "b5a003f0cd3f71ed919fe7e7c45b****"
        }
      ],
      "Total": 2,
      "Code": "200",
      "Success": true
    }
  5. Recherchez des extraits de ressources multimédias dans la bibliothèque de contenu par image de visage (recherche fine).

    Appelez l'opération SearchMediaClipByFace avec le paramètre MediaId renvoyé à l'étape Étape 4 pour récupérer les extraits spécifiques contenant le visage correspondant.

    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);

Référence API

Contactez-nous

Pour toute question ou demande d'assistance technique, rejoignez le groupe DingTalk dédié à IMS (ID : 84650000851) afin de nous contacter.