Praxisnahe API-Beispiele
Probieren Sie sofort synthetische Beispiele aus oder führen Sie dieselben Abläufe mit der echten ShinrAI-API aus.
Standardmäßig synthetisch
Ablauf vor Verwendung eines Schlüssels ansehen
Jedes Szenario beginnt mit einem aufgezeichneten synthetischen Ergebnis und stellt keine API-Anfrage. Wechseln Sie in den Live-Modus, wenn Sie Ihren eigenen Schlüssel und Ihr Kontingent verwenden möchten.
Ihr Schlüssel bleibt im Speicher dieser Seite und wird beim Neuladen gelöscht. Erfolgreiche Live-Anfragen verbrauchen Records.
Supportnachricht schützen
Ersetzen Sie die Identität eines Kunden, bevor Sie den Fall an einen externen Assistenten senden, und stellen Sie die Antwort lokal wieder her.
Original→Protected→Restored reply{"protected":"Nora Winter needs help with order 4815.","restored_reply":"Emma Weber can reset order 4815."}Selbst ausführen
Voraussetzungen
Setzen Sie SHINRAI_API_KEY und optional SHINRAI_API_URL. Verwenden Sie beim Testen nur synthetische Supporttexte.
Befehl
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}'Erwartetes Ergebnis
Die Antwort enthält geschützten Text, eine lokale Zuordnung, erkannte Entitäten und Nutzungsdaten. Verwenden Sie die Zuordnung in Ihrer Anwendung, um die Antwort des Assistenten wiederherzustellen.
Fehlerbehebung
Eine fehlgeschlagene Schutzantwort muss die Weitergabe stoppen. Prüfen Sie den Fehlerumschlag auf ungültige Zugangsdaten, Kontingent, Nutzlastgröße oder nicht verfügbare Verarbeitung.
CRM-Datensätze konsistent schützen
Verwenden Sie eine Zuordnung pro Anfrage, damit dieselbe Person in allen Datensätzen denselben Ersatz erhält.
{"texts":["Nora Winter owns account A-17.","Email Nora Winter at nora@example.net"],"mapping":{"Emma Weber":"Nora Winter"}}Selbst ausführen
Voraussetzungen
Setzen Sie SHINRAI_API_KEY; exportieren Sie während der Evaluierung nur synthetische CRM-Zeilen.
Befehl
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}'Erwartetes Ergebnis
Beide Ergebnisse verwenden denselben Ersatz für Emma Weber. Die Antwort liefert eine anfragebezogene Zuordnung und die Gesamtnutzung.
Fehlerbehebung
Senden Sie zusammengehörige Datensätze in einem Stapel. Getrennte Anfragen bleiben nur konsistent, wenn Ihre Anwendung die frühere Zuordnung mitsendet.
Kontext vor einer KI-Anfrage schützen
Senden Sie geschützten Retrieval-Kontext an das Modell und behalten Sie die Ersetzungszuordnung in Ihrer Anwendung.
Retrieved context→ShinrAI→AI→Local restore{"model_input":"Summarize Nora Winter's account.","restored_reply":"Emma Weber's account is ready for review."}Selbst ausführen
Voraussetzungen
Setzen Sie den ShinrAI-Schlüssel sowie MODEL_ENDPOINT, MODEL_NAME und MODEL_API_KEY für einen OpenAI-kompatiblen Endpunkt.
Befehl
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.pyErwartetes Ergebnis
Das Skript gibt die geschützte Modelleingabe und eine lokal wiederhergestellte Antwort aus. Die Ersetzungszuordnung gelangt nie in die Modellanfrage.
Fehlerbehebung
Wenn der Schutz fehlschlägt, beendet sich das Skript vor dem Modellaufruf. Prüfen Sie beide Endpunkte und Zugangsdaten einzeln und versuchen Sie es erneut mit synthetischem Kontext.
Leitfaden zum Textschutz · API-Vorgang · Python-Beispiel · JavaScript-Beispiel · Open WebUI
Dokument schützen
Laden Sie eine synthetische TXT-, PDF- oder DOCX-Datei hoch, verfolgen Sie den Auftrag und rufen Sie die geschützten Artefakte ab.
{"status":"succeeded","artifacts":{"text":"/v1/documents/jobs/demo/artifacts/text","pdf":"/v1/documents/jobs/demo/artifacts/pdf"}}Selbst ausführen
Voraussetzungen
Erstellen Sie eine synthetische TXT-, PDF- oder DOCX-Datei und setzen Sie SHINRAI_API_KEY.
Befehl
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.txtErwartetes Ergebnis
Eine 202-Antwort liefert die Auftrags-ID und Location. Fragen Sie diese URL bis zum Status succeeded ab und laden Sie dann die aufgeführten Artefakte herunter.
Fehlerbehebung
Beachten Sie Retry-After beim Abfragen. Eine Bereitstellung kann nicht unterstützte Datei- oder Artefaktformate ablehnen; prüfen Sie vor einem neuen Versuch den Auftragsfehler.
Vollständigen KI-Ablauf lokal ausführen
Die herunterladbaren Beispiele rufen ShinrAI auf, übergeben nur geschützten Text an einen OpenAI-kompatiblen Modellendpunkt und stellen die Antwort lokal wieder her. Modell- und ShinrAI-Zugangsdaten stammen aus Umgebungsvariablen.