Compatibilité AWS Comprehend
Utilisez les SDK AWS et des identifiants SigV4 avec les opérations PII Comprehend prises en charge par ShinrAI.
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 |
|---|---|---|
| AWS Comprehend | https://aws.api.getshinrai.com | https://api.getshinrai.com/v1/aws |
| Bac à sable | https://aws.api-sbx.getshinrai.com | https://api-sbx.getshinrai.com/v1/aws |
Ce point de terminaison publie son propre document OpenAPI : OpenAPI de cette API.
Créer des identifiants SDK révocables localement
Appel POST /providers/aws/credentials sur le point de terminaison AWS avec votre clé Bearer ShinrAI habituelle. La réponse contient un identifiant de clé d’accès et une clé secrète dérivés pour votre compte. La révocation de la clé ShinrAI sous-jacente invalide la paire.
curl -X POST https://aws.api.getshinrai.com/providers/aws/credentials \
-H "Authorization: Bearer $SHINRAI_API_KEY"
Utiliser le SDK AWS habituel
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")
Opérations prises en charge
Le point de terminaison JSON 1.1 racine répartit les opérations de détection synchrones et les traitements asynchrones pris en charge à l’aide de X-Amz-Target. Les requêtes nécessitent AWS Signature Version 4 avec le nom de service comprehend .
L’explorateur d’API comprend un signataire SigV4 local au navigateur. Générez les identifiants, autorisez les trois champs AWS, choisissez une opération et envoyez la requête. Les identifiants sont effacés au rechargement.
SigV4 signe le chemin de la requête : / sur le point de terminaison AWS et /v1/aws/ sur l’hôte de l’API. Ne laissez pas un proxy inverse réécrire le chemin après la signature.