ShinrAIAlojado en STACKIT

Compatibilidad con Azure Language PII

Migra a ShinrAI las cargas PII compatibles de Azure para texto, conversaciones y documentos.

Las API de compatibilidad son para la migración

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.

Guía de la API 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.

APIEndpoint: cambie solo esteAlternativa en el host de la API
Azure AI Language PIIhttps://azure.api.getshinrai.comhttps://api.getshinrai.com/v1/azure
Entorno de pruebashttps://azure.api-sbx.getshinrai.comhttps://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.

Rutas de PII de texto compatibles con Azure
ContratoRuta
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://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.

Ver ejemplos de unidades →