ShinrAIHébergé sur STACKIT

Compatibilité AWS Comprehend

Utilisez les SDK AWS et des identifiants SigV4 avec les opérations PII Comprehend prises en charge par ShinrAI.

Les API de compatibilité servent à la migration

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.

Guide de l’API 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.

APIPoint de terminaison : changez uniquement celui-ciAlternative sur l’hôte de l’API
AWS Comprehendhttps://aws.api.getshinrai.comhttps://api.getshinrai.com/v1/aws
Bac à sablehttps://aws.api-sbx.getshinrai.comhttps://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.

Chemin signé

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.

Explorer les opérations AWS →