Compatibilidad con Azure Language PII
Migra a ShinrAI las cargas PII compatibles de Azure para texto, conversaciones y documentos.
Migración desde Azure Language PII
Usa tu clave API de ShinrAI en Ocp-Apim-Subscription-Key y apunta el cliente a la URL base de la API de ShinrAI. El adaptador PII de texto implementa los contratos siguientes; las predicciones y la cobertura completa de Azure son cuestiones distintas.
| Contrato | Endpoint |
|---|---|
| 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://api.shinrai.innovius.io/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.3"
}
}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 real es ShinrAI 1.3; 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.