Compatibilidad con Azure Language PII
Migra a ShinrAI las cargas PII compatibles de Azure para texto, conversaciones y documentos.
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 |
|---|---|---|
| Azure AI Language PII | https://azure.api.getshinrai.com | https://api.getshinrai.com/v1/azure |
| Entorno de pruebas | https://azure.api-sbx.getshinrai.com | https://api-sbx.getshinrai.com/v1/azure |
Este endpoint publica su propio documento OpenAPI: OpenAPI de esta API.
Migración desde Azure Language PII
Apunte su cliente de Azure a https://azure.api.getshinrai.com y envíe su clave de API de ShinrAI como clave de suscripción. Solo cambia el endpoint.
El adaptador de PII de texto implementa los contratos de solicitud y respuesta indicados abajo, en las rutas propias de Azure. Las predicciones del modelo y la cobertura completa de funciones de Azure son asuntos aparte.
| Contrato | Ruta |
|---|---|
| Moderno síncrono | POST /language/:analyze-text?api-version=2023-04-01 o 2026-05-01 |
| Moderno asíncrono | POST /language/analyze-text/jobs?api-version=2023-04-01 o 2026-05-01 |
| Heredado síncrono | POST /text/analytics/v3.1/entities/recognition/pii |
| Heredado asíncrono | POST /text/analytics/v3.1/analyze |
curl 'https://azure.api.getshinrai.com/language/:analyze-text?api-version=2023-04-01' \
-H "Ocp-Apim-Subscription-Key: $SHINRAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"kind":"PiiEntityRecognition","analysisInput":{"documents":[{"id":"1","language":"en","text":"Email emma@example.com"}]},"parameters":{"modelVersion":"latest","stringIndexType":"Utf16CodeUnit"}}'
Ejemplo de respuesta (simulado)
Extracto JSON simulado para el comando anterior. Las detecciones, los valores de sustitución y tu saldo pueden variar.
{
"kind": "PiiEntityRecognitionResults",
"results": {
"documents": [
{
"id": "1",
"redactedText": "Email ****************",
"entities": [
{
"text": "emma@example.com",
"category": "Email",
"offset": 6,
"length": 16,
"confidenceScore": 1.0
}
],
"warnings": []
}
],
"errors": [],
"modelVersion": "shinrai-v1.5"
}
}El PII de texto síncrono admite hasta 5 documentos de 5.120 grupos de grafemas cada uno. Los trabajos asíncronos admiten hasta 25 documentos y 125.000 elementos de texto Unicode 8 en total, con un límite de 1 MiB por solicitud. Consulta la URL operation-location devuelta. Solo la cuenta creadora puede acceder o cancelar; los datos cifrados caducan 24 horas después del envío.
Las posiciones admiten unidades UTF-16, puntos de código Unicode y elementos de texto Unicode 8. El modelo predeterminado es ShinrAI 1.5; se rechazan los identificadores de modelo Azure fechados. El modelo no cubre todas las categorías ni modalidades de Azure PII. Las opciones o categorías no admitidas fallan explícitamente. Es un adaptador PII de texto; consulta la matriz de versión. No implica paridad de funciones o predicciones con todo Azure.
Categorías y opciones de Azure admitidas
Todas las versiones admitidas asignan Person, Organization, Email, URL, PhoneNumber, IPAddress, Address, CreditCardNumber e InternationalBankingAccountNumber. v3.1 y 2023-04-01 asignan fechas de nacimiento a DateTime; no es detección general de fechas. El contrato 2026-05-01 añade City, DateOfBirth, NationalId, ZipCode y LicensePlate.
Para 2026-05-01 se admiten inclusión/exclusión de categorías, umbrales de confianza, exclusiones de valores y ocultación por carácter, entidad o sin máscara. Se rechazan el dominio phi, sinónimos contextuales, desactivar la validación y la sustitución sintética de Azure. Las detecciones nativas sin correspondencia verificada generan avisos ShinrAIUnmappedEntityTypes y se omiten de la ocultación de Azure; usa la API nativa si necesitas conservarlas.
Códigos de idioma admitidos: de en fr es it pl pt ru uk tr ar he ja ko. La aceptación no implica igual calidad. Los trabajos asíncronos usan el factor Batch y los síncronos Standard; cada tarea asíncrona se factura por separado. Las consultas y cancelaciones son gratuitas.
Las pruebas locales de SDK Python y JavaScript pasan para el subconjunto implementado. La comparación con Azure y el cliente .NET siguen pendientes de verificación de versión. Contrato PII de texto de Microsoft.