Kompatibilität mit AWS Comprehend
Nutzen Sie AWS SDKs und SigV4-Zugangsdaten mit den unterstützten Comprehend-PII-Vorgängen von ShinrAI.
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.
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.
| API | Endpunkt: nur diesen ändern | Alternative auf dem API-Host |
|---|---|---|
| AWS Comprehend | https://aws.api.getshinrai.com | https://api.getshinrai.com/v1/aws |
| Sandbox | https://aws.api-sbx.getshinrai.com | https://api-sbx.getshinrai.com/v1/aws |
Dieser Endpunkt liefert sein eigenes OpenAPI-Dokument: OpenAPI für diese API.
Lokal widerrufbare SDK-Zugangsdaten erstellen
Aufruf POST /providers/aws/credentials auf dem AWS-Endpunkt mit Ihrem normalen ShinrAI-Bearer-Schlüssel auf. Die Antwort enthält eine für Ihr Konto abgeleitete Zugriffsschlüssel-ID und einen geheimen Zugriffsschlüssel. Wird der zugrunde liegende ShinrAI-Schlüssel widerrufen, wird das Paar ungültig.
curl -X POST https://aws.api.getshinrai.com/providers/aws/credentials \
-H "Authorization: Bearer $SHINRAI_API_KEY"Normales AWS SDK verwenden
import boto3, os
client = boto3.client(
"comprehend",
region_name="eu-central-1",
endpoint_url="https://aws.api.getshinrai.com",
aws_access_key_id=os.environ["SHINRAI_AWS_ACCESS_KEY_ID"],
aws_secret_access_key=os.environ["SHINRAI_AWS_SECRET_ACCESS_KEY"],
)
result = client.detect_pii_entities(Text="Email emma@example.com", LanguageCode="en")Unterstützte Vorgänge
Der JSON-1.1-Stammendpunkt leitet unterstützte synchrone Erkennungs- und asynchrone Auftragsvorgänge weiter über X-Amz-Target. Anfragen benötigen AWS Signature Version 4 mit dem Dienstnamen comprehend .
Der API-Explorer enthält einen lokalen SigV4-Signierer im Browser. Erzeugen Sie Zugangsdaten, autorisieren Sie die drei AWS-Felder, wählen Sie einen Vorgang und senden Sie die Anfrage. Beim Neuladen werden die Zugangsdaten gelöscht.
SigV4 signiert den Anfragepfad: / auf dem AWS-Endpunkt und /v1/aws/ auf dem API-Host. Lassen Sie den Pfad nach dem Signieren nicht von einem Reverse Proxy umschreiben.