ShinrAIAlojado en STACKIT

Desarrolla con ShinrAI

Protege los datos personales sin perder el contexto útil.

Empieza con una solicitud real, sigue una receta de producción o revisa cada endpoint de cliente compatible.

Envía tu primera solicitudExplorar la API

Elija su API

Un solo servicio y los mismos modelos atienden cada contrato. Elija el contrato que encaje con su código.

API PII nativa v2 Recomendado

Un solo contrato para la API alojada y una instalación en su propio clúster. La edición sin conexión ofrece la API nativa v1 hasta que su imagen incluya la v2.

  • Contrato estable 2.0.0: los cambios dentro de 2.x solo añaden elementos
  • Texto, tablas, JSON y transcripciones
  • Imágenes: OCR, recuadros en píxeles por entidad y la imagen censurada como respuesta
  • Audio: reconocimiento de voz, intervalos de tiempo y la grabación con cada dato personal cubierto con un pitido
  • Documentos PDF y DOCX mediante trabajos, con el PDF censurado de vuelta
  • Grabaciones largas mediante trabajos
  • Niveles en tiempo real, estándar y por lotes
  • Las sesiones mantienen un mapa de reemplazos entre solicitudes
  • Los cuerpos de texto e imagen sin envoltorio funcionan directamente con curl
Guía de la API nativa v2 → · Funciones de un vistazo →
Compatibilidad directa

Mantenga su SDK y su formato de solicitud. Cada API de proveedor tiene su propio endpoint: cambie solo el endpoint y use su clave de ShinrAI.

APIEndpoint: cambie solo esteAlternativa en el host de la API
Azure AI Language PIIhttps://azure.api.getshinrai.comhttps://api.getshinrai.com/v1/azure
Google Cloud DLPhttps://google.api.getshinrai.comhttps://api.getshinrai.com/v1/google
AWS Comprehendhttps://aws.api.getshinrai.comhttps://api.getshinrai.com/v1/aws
  • Los clientes de Azure envían la clave de ShinrAI como clave de suscripción.
  • Los clientes de Google la envían como clave de API o como token Bearer.
  • Los clientes de AWS firman con credenciales SigV4 que usted crea con la clave de ShinrAI.

Cada endpoint de proveedor publica su propio documento OpenAPI en /openapi.json. El entorno de pruebas usa los mismos nombres con api-sbx.

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 →

API nativa v1

Las integraciones v1 existentes siguen funcionando; los proyectos nuevos usan la API nativa v2.

Cada contrato se publica como OpenAPI 3.1. No necesita ningún SDK: cualquier cliente HTTP funciona.

La API nativa v2 en 60 segundos

Defina su clave una vez. Cada ejemplo la envía como token Bearer.

export SHINRAI_API_KEY=shr_live_...

Encontrar datos personales en un texto

curl -s https://api.getshinrai.com/v2/detect -H "Authorization: Bearer $SHINRAI_API_KEY" \
  -H "Content-Type: application/json" -d '{"text": "Anna Weber, anna.weber@example.org, IBAN DE89 3704 0044 0532 0130 00"}'

Enviar un archivo de texto tal cual y recibir el texto protegido

curl -s "https://api.getshinrai.com/v2/protect?preset=label" -H "Authorization: Bearer $SHINRAI_API_KEY" \
  -H "Content-Type: text/plain" -H "Accept: text/plain" --data-binary @letter.txt

Recibir la captura de pantalla censurada

curl -s https://api.getshinrai.com/v2/protect -H "Authorization: Bearer $SHINRAI_API_KEY" \
  -H "Content-Type: image/png" -H "Accept: image/png" --data-binary @screenshot.png -o redacted.png

Iniciar un trabajo para un lote grande

Primero suba un archivo JSONL con una entrada por línea. La respuesta de la subida contiene el ID para el trabajo.

curl -s https://api.getshinrai.com/v2/jobs \
  -H "Authorization: Bearer $SHINRAI_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: rows-2026-09-28" \
  -d '{"kind": "text_batch",
       "inputs": [{"kind": "file", "source": {"upload": "up_..."}}],
       "output": {"artifacts": ["protected", "entities"]}}'

Guía de la API nativa v2 · Referencia completa de v2 (Markdown) · Explorador de API (Swagger) · OpenAPI 3.1 para v2 · OpenAPI 3.1 para todas las API

Elige por dónde empezar

1

Enviar una solicitud

Obtén una clave y detecta datos personales en un mensaje sintético.

 2

Seguir un flujo real

Protege mensajes de soporte, registros de CRM, contexto de IA y documentos.

 3

Conectar tus herramientas

Usa las guías mantenidas para n8n, Onyx, Dify, Nextcloud y más.
Entorno de pruebas local de código abierto

Ejecutar Hello ShinrAI localmente

Pruebe y depure todo el flujo de protección en un espacio de trabajo del navegador. Use una clave de ShinrAI para texto, archivos, escaneos y API compatibles; añada una clave de LLM solo para el chat protegido.

Instale uv una vez y ejecute la versión verificada:

uvx --from https://github.com/Innovius-ai/hello-shinrai/releases/download/v0.1.4/hello_shinrai-0.1.4-py3-none-any.whl hello-shinrai

Use los espacios Texto, Archivos, Chat, Comparación con Azure y Explorador de API. Las claves permanecen en el proceso local salvo que decida guardarlas expresamente en el almacén de credenciales del sistema operativo.

Abrir el repositorio y la guía de instalaciónLeer la guía de la aplicación local

Versión verificada: v0.1.4. Para actualizar, cambie ambos valores de versión en la URL del wheel.

Referencia de la API

Ejecuta solicitudes en la API real

El explorador lo sirve la pasarela ShinrAI y se genera a partir de sus rutas de cliente registradas. Sus scripts y estilos se alojan con el backend.

Abrir Swagger