ShinrAIAuf STACKIT gehostet

Kompatibilität mit Azure Language PII

Migrieren Sie unterstützte Azure-PII-Workloads für Text, Gespräche und Dokumente zu ShinrAI.

Migration von Azure Language PII

Verwenden Sie Ihren ShinrAI-API-Schlüssel in Ocp-Apim-Subscription-Key und richten Sie den Client auf die Basis-URL der ShinrAI-API. Der Text-PII-Adapter implementiert die unten unterstützten Anfrage- und Antwortverträge; Modellvorhersagen und vollständige Azure-Funktionsabdeckung sind davon getrennt.

Azure-kompatible Text-PII-Endpunkte
VertragEndpunkt
Modern synchronPOST /language/:analyze-text?api-version=2023-04-01 oder 2026-05-01
Modern asynchronPOST /language/analyze-text/jobs?api-version=2023-04-01 oder 2026-05-01
Legacy synchronPOST /text/analytics/v3.1/entities/recognition/pii
Legacy asynchronPOST /text/analytics/v3.1/analyze
curl 'https://api.shinrai.innovius.io/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"}}'
Beispielausgabe (simuliert)

Simulierter JSON-Auszug zum obigen Befehl. Erkennungen, Ersatzwerte und Ihr Guthaben können abweichen.

{
  "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.3"
  }
}

Synchrone Text-PII erlaubt bis zu 5 Dokumente mit je 5.120 Graphemclustern. Asynchrone Jobs erlauben bis zu 25 Dokumente und insgesamt 125.000 Unicode-8-Textelemente bei maximal 1 MiB pro Anfrage. Fragen Sie die zurückgegebene operation-location-URL ab. Jobzugriff und Abbruch sind auf das erstellende Konto beschränkt; verschlüsselte Jobdaten laufen 24 Stunden nach Einreichung ab.

Offset-Modi umfassen UTF-16-Codeeinheiten, Unicode-Codepunkte und Unicode-8-Textelemente. Das tatsächliche Modell ist ShinrAI 1.3; datierte Azure-Modellkennungen werden abgelehnt. Das Modell deckt nicht alle Azure-PII-Kategorien oder Modalitäten ab. Nicht unterstützte Kategorien oder Optionen führen zu expliziten Fehlern. Dies ist ein Text-PII-Adapter; weitere Details stehen in der Release-Matrix. Eine Azure-weite Funktions- oder Vorhersagegleichheit wird nicht behauptet.

Unterstützte Azure-Kategorien und Optionen

Alle unterstützten Versionen bilden Person, Organization, Email, URL, PhoneNumber, IPAddress, Address, CreditCardNumber und InternationalBankingAccountNumber ab. Legacy v3.1 und 2023-04-01 bilden Geburtsdaten auf DateTime ab; dies ist keine allgemeine Datumserkennung. Der Vertrag 2026-05-01 bildet zusätzlich City, DateOfBirth, NationalId, ZipCode und LicensePlate ab.

Für 2026-05-01 werden Kategorie-Ein-/Ausschluss, Konfidenzschwellen, Werteausnahmen und Zeichen-/Entitäts-/keine Maskierung unterstützt. Die phi-Domäne, Kontextsynonyme, Abschalten der Detektorvalidierung und Azure-Synthetic-Replacement werden abgelehnt. Native Funde ohne verifizierte Zuordnung erzeugen ShinrAIUnmappedEntityTypes -Warnungen und werden bei der Azure-Maskierung ausgelassen; nutzen Sie die native API, wenn diese Funde erhalten bleiben müssen.

Akzeptierte Sprachcodes: de en fr es it pl pt ru uk tr ar he ja ko. Akzeptanz bedeutet nicht gleiche Erkennungsqualität. Asynchrone Jobs verwenden Batch-Gewichtung, synchrone Standard; jede asynchrone Aufgabe wird separat berechnet. Abfragen und Abbruch sind kostenlos.

Lokale Python- und JavaScript-SDK-Tests bestehen für den implementierten Teilumfang. Azure-Referenzvergleich und der .NET-Client bleiben Gegenstand der Release-Verifikation. Microsofts Text-PII-Vertrag.

Record-Beispiele ansehen →