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ámetro | Significado |
|---|---|
text / texts | Una cadena o una matriz de cadenas. Envía solo uno de estos campos. |
tier | standard, batch o realtime |
model | shinrai-latest o shinrai-v1.3. Los alias de nivel pueden añadir -batch o -realtime. |
threshold | Umbral de confianza de 0 a 1; valor predeterminado: 0,7. |
merge_persons | Fusionar 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.