Exemples d’API concrets
Essayez immédiatement des exemples synthétiques ou exécutez les mêmes flux avec l’API ShinrAI réelle.
Synthétique par défaut
Voir le flux avant d’utiliser une clé
Chaque scénario commence par un résultat synthétique enregistré et n’effectue aucune requête API. Passez en mode réel pour utiliser votre propre clé et votre quota.
Votre clé reste en mémoire sur cette page et est effacée au rechargement. Les requêtes réelles réussies consomment des unités.
Protéger un message d’assistance
Remplacez l’identité du client avant d’envoyer le dossier à un assistant externe, puis restaurez la réponse localement.
Original→Protected→Restored reply{"protected":"Nora Winter needs help with order 4815.","restored_reply":"Emma Weber can reset order 4815."}L’exécuter vous-même
Prérequis
Définissez SHINRAI_API_KEY et, si nécessaire, SHINRAI_API_URL. Utilisez uniquement des messages d’assistance synthétiques pendant les tests.
Commande
curl "${SHINRAI_API_URL:-https://api.shinrai.innovius.io}/v1/redact" -H "Authorization: Bearer $SHINRAI_API_KEY" -H "Content-Type: application/json" -d '{"text":"Emma Weber needs help with order 4815.","mode":"replace","include_mapping":true}'Résultat attendu
La réponse contient le texte protégé, une table locale, les entités détectées et l’utilisation. Utilisez la table dans votre application pour restaurer la réponse de l’assistant.
Dépannage
Un échec de protection doit interrompre tout envoi ultérieur. Consultez l’enveloppe d’erreur pour les identifiants, le quota, la taille de charge ou un traitement indisponible.
Guide de protection du texte · Opération API · Secure AI Suite
Protéger les fiches CRM de manière cohérente
Utilisez une table propre à la requête afin qu’une même personne reçoive le même remplacement dans tous les enregistrements.
{"texts":["Nora Winter owns account A-17.","Email Nora Winter at nora@example.net"],"mapping":{"Emma Weber":"Nora Winter"}}L’exécuter vous-même
Prérequis
Définissez SHINRAI_API_KEY ; exportez uniquement des lignes CRM synthétiques pendant l’évaluation.
Commande
curl "${SHINRAI_API_URL:-https://api.shinrai.innovius.io}/v1/redact/batch" -H "Authorization: Bearer $SHINRAI_API_KEY" -H "Content-Type: application/json" -d '{"texts":["Emma Weber owns A-17.","Email Emma Weber at emma@example.com."],"mode":"replace","include_mapping":true}'Résultat attendu
Les deux résultats réutilisent le même remplacement pour Emma Weber. La réponse renvoie une table propre à la requête et l’utilisation totale.
Dépannage
Envoyez les enregistrements liés dans un même lot. Des requêtes séparées ne restent cohérentes que si votre application fournit la table précédente.
Protéger le contexte avant une requête d’IA
Envoyez au modèle le contexte de recherche protégé et conservez la table de remplacement dans votre application.
Retrieved context→ShinrAI→AI→Local restore{"model_input":"Summarize Nora Winter's account.","restored_reply":"Emma Weber's account is ready for review."}L’exécuter vous-même
Prérequis
Définissez la clé ShinrAI ainsi que MODEL_ENDPOINT, MODEL_NAME et MODEL_API_KEY pour un point de terminaison compatible OpenAI.
Commande
curl -O https://shinrai.innovius.io/downloads/examples/shinrai-ai-workflow-python.py
SHINRAI_API_KEY=... MODEL_ENDPOINT=https://model.example/v1 MODEL_NAME=your-model MODEL_API_KEY=... python shinrai-ai-workflow-python.pyRésultat attendu
Le script affiche l’entrée protégée du modèle et une réponse restaurée localement. La table de remplacement n’entre jamais dans la requête au modèle.
Dépannage
Si la protection échoue, le script s’arrête avant d’appeler le modèle. Vérifiez séparément les deux points de terminaison et leurs identifiants, puis réessayez avec un contexte synthétique.
Guide de protection du texte · Opération API · Exemple Python · Exemple JavaScript · Open WebUI
Protéger un document
Importez un fichier synthétique TXT, PDF ou DOCX, suivez son traitement et récupérez les artefacts protégés.
{"status":"succeeded","artifacts":{"text":"/v1/documents/jobs/demo/artifacts/text","pdf":"/v1/documents/jobs/demo/artifacts/pdf"}}L’exécuter vous-même
Prérequis
Créez un fichier TXT, PDF ou DOCX synthétique et définissez SHINRAI_API_KEY.
Commande
curl -i -X POST "${SHINRAI_API_URL:-https://api.shinrai.innovius.io}/v1/documents/jobs?mode=replace&include_mapping=true" -H "Authorization: Bearer $SHINRAI_API_KEY" -H "Content-Type: text/plain" --data-binary @sample.txtRésultat attendu
Une réponse 202 renvoie l’identifiant du traitement et Location. Interrogez cette URL jusqu’à succeeded, puis téléchargez les artefacts indiqués.
Dépannage
Respectez Retry-After pendant l’interrogation. Un déploiement peut refuser certains types de fichiers ou formats d’artefacts ; consultez l’erreur du traitement avant de réessayer.
Exécuter le flux d’IA complet localement
Les exemples téléchargeables appellent ShinrAI, transmettent uniquement le texte protégé à un point de terminaison de modèle compatible OpenAI et restaurent la réponse localement. Les identifiants du modèle et de ShinrAI proviennent de variables d’environnement.