Compatibilidad con AWS Comprehend
Usa los SDK de AWS y credenciales SigV4 con las operaciones PII de Comprehend compatibles con ShinrAI.
El contrato del proveedor limita lo que ShinrAI puede devolver: tipos, confianza, medios, sesiones y trabajos. Por eso, los resultados pueden ser más débiles de lo que ShinrAI puede ofrecer. Para obtener la calidad completa, use la API PII nativa v2.
Endpoints
Use el endpoint del proveedor para un cliente sin cambios. El mismo adaptador también funciona con un prefijo de ruta en el host de la API; las extensiones de ShinrAI al formato del proveedor aparecen allí primero.
| API | Endpoint: cambie solo este | Alternativa en el host de la API |
|---|---|---|
| AWS Comprehend | https://aws.api.getshinrai.com | https://api.getshinrai.com/v1/aws |
| Entorno de pruebas | https://aws.api-sbx.getshinrai.com | https://api-sbx.getshinrai.com/v1/aws |
Este endpoint publica su propio documento OpenAPI: OpenAPI de esta API.
Crear credenciales SDK revocables localmente
Llamada POST /providers/aws/credentials en el endpoint de AWS con su clave Bearer habitual de ShinrAI. La respuesta contiene un ID de clave de acceso y una clave secreta derivados para su cuenta. Revocar la clave de ShinrAI subyacente invalida el par.
curl -X POST https://aws.api.getshinrai.com/providers/aws/credentials \
-H "Authorization: Bearer $SHINRAI_API_KEY"Usar el SDK de AWS habitual
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")Operaciones compatibles
El endpoint raíz JSON 1.1 dirige las operaciones compatibles de detección síncrona y trabajos asíncronos mediante X-Amz-Target. Las solicitudes requieren AWS Signature Version 4 con el nombre de servicio comprehend .
El explorador de API incluye un firmante SigV4 local en el navegador. Genera credenciales, autoriza los tres campos de AWS, elige una operación y envía la solicitud. Las credenciales se borran al recargar.
SigV4 firma la ruta de la solicitud: / en el endpoint de AWS y /v1/aws/ en el host de la API. No deje que un proxy inverso reescriba la ruta después de firmar.