Compatibilité Azure Language PII
Migrez vers ShinrAI les charges PII Azure prises en charge pour le texte, les conversations et les documents.
Le contrat du fournisseur limite ce que ShinrAI peut renvoyer : types, confiance, médias, sessions et jobs. Les résultats peuvent donc être inférieurs à ce que ShinrAI peut fournir. Pour une qualité complète, utilisez l’API PII native v2.
Points de terminaison
Utilisez le point de terminaison du fournisseur pour un client inchangé. Le même adaptateur fonctionne aussi sous un préfixe de chemin sur l’hôte de l’API ; les extensions ShinrAI du format fournisseur y apparaissent en premier.
| API | Point de terminaison : changez uniquement celui-ci | Alternative sur l’hôte de l’API |
|---|---|---|
| Azure AI Language PII | https://azure.api.getshinrai.com | https://api.getshinrai.com/v1/azure |
| Bac à sable | https://azure.api-sbx.getshinrai.com | https://api-sbx.getshinrai.com/v1/azure |
Ce point de terminaison publie son propre document OpenAPI : OpenAPI de cette API.
Migration depuis Azure Language PII
Orientez votre client Azure vers https://azure.api.getshinrai.com et envoyez votre clé d’API ShinrAI comme clé d’abonnement. Seul le point de terminaison change.
L’adaptateur PII texte implémente les contrats de requête et de réponse ci-dessous, aux chemins d’Azure. Les prédictions du modèle et la couverture complète des fonctions Azure sont des sujets distincts.
| Contrat | Chemin |
|---|---|
| Moderne synchrone | POST /language/:analyze-text?api-version=2023-04-01 ou 2026-05-01 |
| Moderne asynchrone | POST /language/analyze-text/jobs?api-version=2023-04-01 ou 2026-05-01 |
| Historique synchrone | POST /text/analytics/v3.1/entities/recognition/pii |
| Historique asynchrone | POST /text/analytics/v3.1/analyze |
curl 'https://azure.api.getshinrai.com/language/:analyze-text?api-version=2023-04-01' \
-H "Ocp-Apim-Subscription-Key: $SHINRAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"kind":"PiiEntityRecognition","analysisInput":{"documents":[{"id":"1","language":"en","text":"Email emma@example.com"}]},"parameters":{"modelVersion":"latest","stringIndexType":"Utf16CodeUnit"}}'
Exemple de réponse (simulé)
Extrait JSON simulé pour la commande ci-dessus. Les détections, les valeurs de remplacement et votre solde peuvent différer.
{
"kind": "PiiEntityRecognitionResults",
"results": {
"documents": [
{
"id": "1",
"redactedText": "Email ****************",
"entities": [
{
"text": "emma@example.com",
"category": "Email",
"offset": 6,
"length": 16,
"confidenceScore": 1.0
}
],
"warnings": []
}
],
"errors": [],
"modelVersion": "shinrai-v1.5"
}
}Le PII texte synchrone accepte jusqu’à 5 documents de 5.120 groupes de graphèmes chacun. Les tâches asynchrones acceptent jusqu’à 25 documents et 125.000 éléments de texte Unicode 8 au total, avec une limite de 1 MiB par requête. Interrogez l’URL operation-location renvoyée. L’accès et l’annulation sont réservés au compte créateur ; les données chiffrées expirent 24 heures après soumission.
Les positions peuvent utiliser les unités UTF-16, les points de code Unicode ou les éléments de texte Unicode 8. Le modèle par défaut est ShinrAI 1.5 ; les identifiants Azure datés sont rejetés. Le modèle ne couvre pas toutes les catégories ou modalités Azure PII. Les options ou catégories non prises en charge échouent explicitement. Cet adaptateur concerne le PII texte ; consultez la matrice de version. Il ne garantit pas la parité des fonctions ou prédictions avec tout Azure.
Catégories et options Azure prises en charge
Toutes les versions prises en charge mappent Person, Organization, Email, URL, PhoneNumber, IPAddress, Address, CreditCardNumber et InternationalBankingAccountNumber. Les versions v3.1 et 2023-04-01 mappent les dates de naissance à DateTime, sans détection générale des dates. Le contrat 2026-05-01 ajoute City, DateOfBirth, NationalId, ZipCode et LicensePlate.
Pour 2026-05-01, les contrôles incluent l’inclusion/exclusion de catégories, les seuils de confiance, les exclusions de valeurs et le masquage par caractère, entité ou sans masque. Le domaine phi, les synonymes contextuels, la désactivation de validation et le remplacement synthétique Azure sont rejetés. Les détections natives sans correspondance vérifiée produisent des avertissements ShinrAIUnmappedEntityTypes et sont omises du masquage Azure ; utilisez l’API native pour les conserver.
Codes de langue acceptés : de en fr es it pl pt ru uk tr ar he ja ko. L’acceptation ne garantit pas une qualité égale. Les tâches asynchrones utilisent le coefficient Batch, les synchrones Standard ; chaque tâche asynchrone est facturée séparément. Consultation et annulation sont gratuites.
Les tests SDK locaux Python et JavaScript réussissent pour le sous-ensemble implémenté. La comparaison avec Azure et le client .NET restent à vérifier pour la version. Contrat PII texte de Microsoft.