AWS Comprehend互換性
AWS SDKとSigV4認証情報で、ShinrAIが対応するComprehend PIIオペレーションを使用します。
ベンダーの契約により、ShinrAIが返せる内容（種類、信頼度、メディア、セッション、ジョブ）は制限されます。そのため、結果はShinrAI本来の性能より劣る場合があります。最高の品質にはネイティブPII API v2を使用してください。
エンドポイント
クライアントを変更しない場合は、ベンダー用エンドポイントを使います。同じアダプターはAPIホスト上のパスプレフィックスでも動作し、ベンダー形式へのShinrAI独自の拡張はまずそちらで提供されます。
| API | エンドポイント（ここだけ変更） | APIホスト上の代替パス |
|---|---|---|
| AWS Comprehend | https://aws.api.getshinrai.com | https://api.getshinrai.com/v1/aws |
| サンドボックス | https://aws.api-sbx.getshinrai.com | https://api-sbx.getshinrai.com/v1/aws |
このエンドポイントは独自のOpenAPIドキュメントを提供します： このAPIのOpenAPI.
ローカルで失効できるSDK認証情報を作成
呼び出し POST /providers/aws/credentials をAWSエンドポイントで通常のShinrAI Bearerキーを使って呼び出します。レスポンスには、アカウント用に導出されたアクセスキーIDとシークレットアクセスキーが含まれます。元のShinrAIキーを失効すると、このペアも無効になります。
curl -X POST https://aws.api.getshinrai.com/providers/aws/credentials \
-H "Authorization: Bearer $SHINRAI_API_KEY"通常のAWS SDKを使用
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")対応オペレーション
ルートのJSON 1.1エンドポイントは、対応する同期検出および非同期ジョブ操作を次の値で振り分けます X-Amz-Target。リクエストにはAWS Signature Version 4が必要で、サービス名は comprehend です。
APIエクスプローラーにはブラウザ内SigV4署名機能が含まれます。認証情報を生成し、3つのAWSフィールドを承認し、オペレーション対象を選択してリクエストを送信します。認証情報は再読み込み時に消去されます。
SigV4はリクエストパスに署名します。AWSエンドポイントでは /、APIホストでは /v1/aws/ です。署名後にリバースプロキシでパスを書き換えないでください。