ShinrAIAlojado en STACKIT

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.

Endpoints PII de texto compatibles con Azure
ContratoEndpoint
Moderno síncronoPOST /language/:analyze-text?api-version=2023-04-01 o 2026-05-01
Moderno asíncronoPOST /language/analyze-text/jobs?api-version=2023-04-01 o 2026-05-01
Heredado síncronoPOST /text/analytics/v3.1/entities/recognition/pii
Heredado asíncronoPOST /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.

Ver ejemplos de unidades →