ShinrAIHébergé sur STACKIT

Développez avec ShinrAI

Protégez les données personnelles sans perdre le contexte utile.

Commencez par une requête réelle, suivez une recette de production ou inspectez chaque point de terminaison client pris en charge.

Envoyer votre première requêteExplorer l’API

Choisir votre API

Un seul service et les mêmes modèles servent chaque contrat. Choisissez le contrat adapté à votre code.

API PII native v2 Recommandé

Un seul contrat pour l’API hébergée et une installation dans votre propre cluster. L’édition hors ligne sert l’API native v1 jusqu’à ce que son image inclue la v2.

  • Contrat stable 2.0.0 : les changements en 2.x sont uniquement des ajouts
  • Texte, tableaux, JSON et transcriptions
  • Images : OCR, cadres en pixels par entité et image caviardée en retour
  • Audio : reconnaissance vocale, intervalles de temps et enregistrement avec chaque donnée personnelle masquée par un bip
  • Documents PDF et DOCX via des jobs, avec le PDF caviardé en retour
  • Enregistrements longs via des jobs
  • Niveaux temps réel, standard et lot
  • Les sessions conservent une table de remplacement entre les requêtes
  • Les corps bruts texte et image fonctionnent directement avec curl
Guide de l’API native v2 → · Fonctionnalités en bref →
Compatibilité sans réécriture

Conservez votre SDK et votre format de requête. Chaque API fournisseur a son propre point de terminaison : changez uniquement le point de terminaison et utilisez votre clé ShinrAI.

APIPoint de terminaison : changez uniquement celui-ciAlternative sur l’hôte de l’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
  • Les clients Azure envoient la clé ShinrAI comme clé d’abonnement.
  • Les clients Google l’envoient comme clé d’API ou comme jeton Bearer.
  • Les clients AWS signent avec des identifiants SigV4 que vous créez avec la clé ShinrAI.

Chaque point de terminaison fournisseur publie son propre document OpenAPI à /openapi.json. Le bac à sable utilise les mêmes noms avec api-sbx.

Les API de compatibilité servent à la migration

Le contrat du fournisseur limite ce que ShinrAI peut renvoyer : types, confiance, médias, sessions et jobs. Les résultats peuvent donc être inférieurs à ce que ShinrAI peut fournir. Pour une qualité complète, utilisez l’API PII native v2.

Guide de l’API native v2 →

API native v1

Les intégrations v1 existantes continuent de fonctionner ; les nouveaux projets utilisent l’API native v2.

Chaque contrat est publié en OpenAPI 3.1. Aucun SDK n’est nécessaire : tout client HTTP fonctionne.

L’API native v2 en 60 secondes

Définissez votre clé une seule fois. Chaque exemple l’envoie comme jeton Bearer.

export SHINRAI_API_KEY=shr_live_...

Trouver des données personnelles dans un texte

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"}'

Envoyer un fichier texte tel quel et recevoir le texte protégé

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

Recevoir la capture d’écran caviardée

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

Lancer un job pour un lot volumineux

Téléversez d’abord un fichier JSONL avec une entrée par ligne. La réponse du téléversement contient l’ID pour le job.

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"]}}'

Guide de l’API native v2 · Référence v2 complète (Markdown) · Explorateur d’API (Swagger) · OpenAPI 3.1 pour v2 · OpenAPI 3.1 pour toutes les API

Choisissez par où commencer

1

Envoyer une requête

Obtenez une clé et détectez les données personnelles dans un message synthétique.

 2

Suivre un flux concret

Protégez les messages d’assistance, les fiches CRM, le contexte d’IA et les documents.

 3

Connecter vos outils

Utilisez les guides maintenus pour n8n, Onyx, Dify, Nextcloud et d’autres produits.
Espace de test local open source

Exécuter Hello ShinrAI en local

Testez et déboguez tout le parcours de protection dans un espace de travail du navigateur. Une clé ShinrAI suffit pour le texte, les fichiers, les scans et les API compatibles ; ajoutez une clé LLM uniquement pour le chat protégé.

Installez uv une fois, puis lancez la version vérifiée :

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

Utilisez les espaces Texte, Fichiers, Chat, Comparaison Azure et Explorateur d’API. Les clés restent dans le processus local, sauf si vous choisissez explicitement de les enregistrer dans le gestionnaire d’identifiants du système.

Ouvrir le dépôt et le guide d’installationLire le guide de l’application locale

Version vérifiée : v0.1.4. Pour effectuer une mise à niveau, modifiez les deux valeurs de version dans l’URL du wheel.

Référence API

Exécutez des requêtes sur l’API réelle

L’explorateur est servi par la passerelle ShinrAI et généré à partir de ses routes client enregistrées. Ses scripts et styles sont hébergés avec le backend.

Ouvrir Swagger