Modérer du texte à partir de la console d’API

Utilisez l’API Modération de texte dans Azure Content Moderator pour analyser votre contenu de texte à la recherche de propos injurieux et le comparer aux listes personnalisées et partagées.

Obtenir votre clé API

Avant de pouvoir tester l’API dans la console en ligne, vous avez besoin de votre clé d’abonnement. Elle se trouve sous l’onglet Paramètres, dans la zone Ocp-Apim-Subscription-Key. Pour plus d’informations, consultez What is Content Moderator? (Présentation de Content Moderator).

Accéder aux informations de référence sur l’API

Accédez aux Informations de référence sur l’API Modération du texte.

La page Text - Screen (Texte - Passer au crible) s’ouvre.

Ouvrir la console d’API

Pour l’option Open API testing console (Ouvrir la console de test d’API), sélectionnez la région qui décrit le mieux votre emplacement.

La console d’API Text - Screen (Texte - Passer au crible) s’ouvre.

Sélectionner les entrées

Paramètres

Sélectionnez les paramètres de requête que vous voulez utiliser dans le passage au crible de votre texte. Pour cet exemple, utilisez la valeur par défaut pour le paramètre language. Vous pouvez également le laisser vide, car l’opération détecte automatiquement la langue probable dans le cadre de son exécution.

Notes

Pour le paramètre langue, attribuez eng ou laissez-le vide pour voir la réponse de la classification assistée par ordinateur (fonctionnalité en préversion). Cette fonctionnalité prend en charge uniquement l’anglais.

Pour la détection des termes injurieux, utilisez le code ISO 639-3 des langues prises en charge répertoriées dans cet article, ou laissez le paramètre vide.

Pour les paramètres autocorrect, PII et classify (préversion), sélectionnez true. Laissez le champ ListId vide.

Type de contenu

Pour Content-Type, sélectionnez le type de contenu à passer au crible. Pour cet exemple, utilisez le type de contenu text/plain par défaut. Dans la zone Ocp-Apim-abonnement-Key, entrez votre clé d’abonnement.

Exemple de texte à analyser

Dans la zone Request body (Corps de la requête), entrez du texte. L’exemple suivant montre une faute de frappe intentionnelle dans le texte.

Is this a grabage or <offensive word> email abcdef@abcd.com, phone: 4255550111, IP: 
255.255.255.255, 1234 Main Boulevard, Panapolis WA 96555.

Analyser la réponse

La réponse suivante montre les différentes informations fournies par l’API. Elle contient les propos injurieux potentiels, les données personnelles, la classification (préversion) et la version corrigée automatiquement.

Notes

La fonctionnalité « Classification » assistée par ordinateur est en préversion et prend en charge uniquement l’anglais.

{
   "original_text":"Is this a grabage or <offensive word> email abcdef@abcd.com, phone: 
   6657789887, IP: 255.255.255.255, 1 Microsoft Way, Redmond, WA 98052.",
   "normalized_text":"   grabage  <offensive word> email abcdef@abcd.com, phone: 
   6657789887, IP: 255.255.255.255, 1 Microsoft Way, Redmond, WA 98052.",
   "auto_corrected_text":"Is this a garbage or <offensive word> email abcdef@abcd.com, phone: 
   6657789887, IP: 255.255.255.255, 1 Microsoft Way, Redmond, WA 98052.",
   "status":{
      "code":3000,
      "description":"OK"
   },
   "pii":{
      "email":[
         {
            "detected":"abcdef@abcd.com",
            "sub_type":"Regular",
            "text":"abcdef@abcd.com",
            "index":32
         }
      ],
      "ssn":[

      ],
      "ipa":[
         {
            "sub_type":"IPV4",
            "text":"255.255.255.255",
            "index":72
         }
      ],
      "phone":[
         {
            "country_code":"US",
            "text":"6657789887",
            "index":56
         }
      ],
      "address":[
         {
            "text":"1 Microsoft Way, Redmond, WA 98052",
            "index":89
         }
      ]
   },
   "language":"eng",
   "terms":[
      {
         "index":12,
         "original_index":21,
         "list_id":0,
         "term":"<offensive word>"
      }
   ],
   "tracking_id":"WU_ibiza_65a1016d-0f67-45d2-b838-b8f373d6d52e_ContentModerator.
   F0_fe000d38-8ecd-47b5-a8b0-4764df00e3b5"
}

Pour obtenir une explication détaillée de toutes les sections de la réponse JSON, reportez-vous au guide conceptuel Modération du texte.

Étapes suivantes

Utilisez l’API REST dans votre code ou suivez le Démarrage rapide du kit SDK .NET pour l’intégrer à votre application.