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.

Kompatibilitäts-APIs sind für die Migration gedacht

Der Vertrag des Anbieters begrenzt, was ShinrAI zurückgeben kann: Typen, Konfidenz, Medien, Sitzungen und Jobs. Die Ergebnisse können daher schwächer sein, als ShinrAI sie liefern kann. Für volle Qualität verwenden Sie die native PII-API v2.

Leitfaden zur nativen API v2 →

Endpunkte

Verwenden Sie den Anbieter-Endpunkt für einen unveränderten Client. Derselbe Adapter läuft auch unter einem Pfadpräfix auf dem API-Host; ShinrAI-Erweiterungen des Anbieterformats erscheinen dort zuerst.

APIEndpunkt: nur diesen ändernAlternative auf dem API-Host
Azure AI Language PIIhttps://azure.api.getshinrai.comhttps://api.getshinrai.com/v1/azure
Sandboxhttps://azure.api-sbx.getshinrai.comhttps://api-sbx.getshinrai.com/v1/azure

Dieser Endpunkt liefert sein eigenes OpenAPI-Dokument: OpenAPI für diese API.

Migration von Azure Language PII

Richten Sie Ihren Azure-Client auf https://azure.api.getshinrai.com und senden Sie Ihren ShinrAI-API-Schlüssel als Subscription Key. Nur der Endpunkt ändert sich.

Der Text-PII-Adapter implementiert die unten genannten Anfrage- und Antwortverträge unter den Pfaden von Azure. Modellvorhersagen und der volle Azure-Funktionsumfang sind davon getrennte Fragen.

Azure-kompatible Pfade für Text-PII
VertragPfad
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://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"}}'
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.5"
  }
}

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 Standardmodell ist ShinrAI 1.5; 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 →