ShinrAIAlojado en STACKIT

Detecta, sustituye y restaura datos personales

Usa las API de texto nativas para detectar y sustituir de forma reversible y coherente.

Detectar datos personales

POST /v1/analyze acepta un campo text o una matriz texts . Las posiciones nativas cuentan puntos de código Unicode desde cero; endIndex es exclusivo.

Parámetros de detección nativa
ParámetroSignificado
text / textsUna cadena o una matriz de cadenas. Envía solo uno de estos campos.
tierstandard, batch o realtime
modelshinrai-latest o shinrai-v1.3. Los alias de nivel pueden añadir -batch o -realtime.
thresholdUmbral de confianza de 0 a 1; valor predeterminado: 0,7.
merge_personsFusionar detecciones de personas adyacentes; true por defecto.

GET /v1/models enumera los modelos y niveles de API disponibles para tu clave. OpenAPI es la referencia nativa legible por máquina.

¿Qué es el cifrado semántico?

ShinrAI llama cifrado semántico a la sustitución reversible que conserva el contexto. Es una forma de seudonimización: los valores sensibles se sustituyen por alternativas útiles y su aplicación puede restaurarlos mediante su correspondencia.

Proteja la correspondencia como dato sensible y no la incluya en los prompts. Las sustituciones realistas no significan que cada palabra esté cifrada criptográficamente ni que el texto sea automáticamente anónimo.

Idiomas y categorías de datos · Historial de modelos · Comparar ShinrAI

Sustituir datos personales y conservar la correspondencia

POST /v1/redact devuelve el texto transformado. Elige replace para valores de sustitución realistas y coherentes, mask para ocultar caracteres, o label para etiquetas de entidades como [PERSON].

curl https://api.shinrai.innovius.io/v1/redact \
  -H "Authorization: Bearer $SHINRAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Contact Emma at emma@example.com","mode":"replace"}'
Ejemplo de respuesta (simulado)

Extracto JSON simulado para el comando anterior. Las detecciones, los valores de sustitución y tu saldo pueden variar.

{
  "mode": "replace",
  "tier": "standard",
  "text": "Contact Nora at nora@example.net",
  "mapping": {
    "Emma": "Nora",
    "emma@example.com": "nora@example.net"
  },
  "usage": {
    "records": 1,
    "weighted_records": 1.0,
    "tier": "standard",
    "balance_after": 9998.0
  }
}

Guarda la mapping devuelta de forma segura en tu aplicación si necesitas restaurar el texto. Envía known_replacements para reutilizar sustituciones entre llamadas; reserved_replacements excluye los valores que no deben generarse. mask_char controla el enmascaramiento y usa por defecto *.

Revisa las detecciones con documentos representativos. El texto seudonimizado y las correspondencias de restauración pueden seguir siendo sensibles; la transformación no garantiza el anonimato.

Mantener sustituciones coherentes en un lote

Use POST /v1/redact/batch cuando varios registros pertenecen al mismo flujo. ShinrAI mantiene un único mapa de sustitución para la solicitud y puede reutilizar los mapas enviados en known_replacements.

{"texts":["Emma owns the case.","Email Emma at emma@example.com"],"mode":"replace","include_mapping":true}

Los mapas devueltos contienen valores originales. Guárdalos como datos sensibles de la aplicación y no los incluyas en las instrucciones del modelo.