ShinrAIAuf STACKIT gehostet

Mit ShinrAI entwickeln

Personenbezogene Daten schützen, ohne wertvollen Kontext zu verlieren.

Beginnen Sie mit einer echten Anfrage, folgen Sie einem Praxisrezept oder prüfen Sie jeden unterstützten Kundenendpunkt.

Erste Anfrage senden API erkunden

Wählen Sie Ihre API

Ein Dienst mit denselben Modellen bedient jeden Vertrag. Wählen Sie den Vertrag, der zu Ihrem Code passt.

Native PII-API v2 Empfohlen

Ein Vertrag für die gehostete API und eine Installation in Ihrem eigenen Cluster. Die Offline-Edition bedient die native API v1, bis ihr Image v2 enthält.

Stabiler Vertrag 2.0.0: Änderungen innerhalb von 2.x sind nur Ergänzungen
Text, Tabellen, JSON und Transkripte
Bilder: OCR, Pixelboxen pro Entität und das geschwärzte Bild als Antwort
Audio: Spracherkennung, Zeitintervalle und die Aufnahme, in der jede personenbezogene Angabe überpiept ist
PDF- und DOCX-Dokumente über Jobs, mit dem geschwärzten PDF als Ergebnis
Lange Aufnahmen über Jobs
Stufen Echtzeit, Standard und Batch
Sitzungen behalten eine Ersatzzuordnung über mehrere Anfragen
Rohe Text- und Bilddaten als Body funktionieren direkt mit curl

Leitfaden zur nativen API v2 → · Funktionen im Überblick →

Kompatibel ohne Codeumbau

Behalten Sie Ihr SDK und Ihr Anfrageformat. Jede Anbieter-API hat einen eigenen Endpunkt: Ändern Sie nur den Endpunkt und verwenden Sie Ihren ShinrAI-Schlüssel.

API	Endpunkt: nur diesen ändern	Alternative auf dem API-Host
Azure AI Language PII	`https://azure.api.getshinrai.com`	`https://api.getshinrai.com/v1/azure`
Google Cloud DLP	`https://google.api.getshinrai.com`	`https://api.getshinrai.com/v1/google`
AWS Comprehend	`https://aws.api.getshinrai.com`	`https://api.getshinrai.com/v1/aws`

Azure-Clients senden den ShinrAI-Schlüssel als Subscription Key.
Google-Clients senden ihn als API-Schlüssel oder als Bearer-Token.
AWS-Clients signieren mit SigV4-Zugangsdaten, die Sie mit dem ShinrAI-Schlüssel erzeugen.

Jeder Anbieter-Endpunkt liefert sein eigenes OpenAPI-Dokument unter /openapi.json. Die Sandbox verwendet dieselben Namen mit api-sbx.

Kompatibilitäts-APIs sind für die Migration gedacht

Der Vertrag des Anbieters begrenzt, was ShinrAI zurückgeben kann: Typen, Konfidenz, Medien, Sitzungen und Jobs. Die Ergebnisse können daher schwächer sein, als ShinrAI sie liefern kann. Für volle Qualität verwenden Sie die native PII-API v2.

Leitfaden zur nativen API v2 →

Native API v1

Bestehende v1-Integrationen funktionieren weiter; neue Projekte verwenden die native API v2.

Jeder Vertrag ist als OpenAPI 3.1 veröffentlicht. Sie brauchen kein SDK: Jeder HTTP-Client funktioniert.

Native API v2 in 60 Sekunden

Setzen Sie Ihren Schlüssel einmal. Jedes Beispiel sendet ihn als Bearer-Token.

export SHINRAI_API_KEY=shr_live_...

Personenbezogene Daten in einem Text finden

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

curl 'https://azure.api.getshinrai.com/language/:analyze-text?api-version=2023-04-01' \
  -H "Ocp-Apim-Subscription-Key: $SHINRAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"kind":"PiiEntityRecognition","analysisInput":{"documents":[{"id":"1","language":"en","text":"Anna Weber, anna.weber@example.org, IBAN DE89 3704 0044 0532 0130 00"}]},"parameters":{"modelVersion":"latest","stringIndexType":"Utf16CodeUnit"}}'

Kompatibilitäts-APIs begrenzen, was ShinrAI zurückgeben kann. Für volle Qualität verwenden Sie die native PII-API v2.

# Once: create SigV4 credentials with your ShinrAI key
# curl -X POST https://aws.api.getshinrai.com/providers/aws/credentials -H "Authorization: Bearer $SHINRAI_API_KEY"
import boto3, os

client = boto3.client(
    "comprehend",
    region_name="eu-central-1",
    endpoint_url="https://aws.api.getshinrai.com",
    aws_access_key_id=os.environ["SHINRAI_AWS_ACCESS_KEY_ID"],
    aws_secret_access_key=os.environ["SHINRAI_AWS_SECRET_ACCESS_KEY"],
)
print(client.detect_pii_entities(Text="Anna Weber, anna.weber@example.org, IBAN DE89 3704 0044 0532 0130 00", LanguageCode="en"))

Kompatibilitäts-APIs begrenzen, was ShinrAI zurückgeben kann. Für volle Qualität verwenden Sie die native PII-API v2.

curl 'https://google.api.getshinrai.com/v2/projects/my-project/locations/global/content:inspect' \
  -H "x-goog-api-key: $SHINRAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"item":{"value":"Anna Weber, anna.weber@example.org, IBAN DE89 3704 0044 0532 0130 00"},"inspectConfig":{"includeQuote":true}}'

Kompatibilitäts-APIs begrenzen, was ShinrAI zurückgeben kann. Für volle Qualität verwenden Sie die native PII-API v2.

Eine Textdatei unverändert senden und den geschützten Text zurückerhalten

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

# Azure returns the masked text as redactedText.
curl 'https://azure.api.getshinrai.com/language/:analyze-text?api-version=2023-04-01' \
  -H "Ocp-Apim-Subscription-Key: $SHINRAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"kind":"PiiEntityRecognition","analysisInput":{"documents":[{"id":"1","language":"en","text":"Anna Weber, anna.weber@example.org"}]},"parameters":{"modelVersion":"latest","stringIndexType":"Utf16CodeUnit"}}'

Kompatibilitäts-APIs begrenzen, was ShinrAI zurückgeben kann. Für volle Qualität verwenden Sie die native PII-API v2.

curl 'https://google.api.getshinrai.com/v2/projects/my-project/locations/global/content:deidentify' \
  -H "x-goog-api-key: $SHINRAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"item":{"value":"Anna Weber, anna.weber@example.org"},"deidentifyConfig":{"infoTypeTransformations":{"transformations":[{"primitiveTransformation":{"replaceWithInfoTypeConfig":{}}}]}}}'

Kompatibilitäts-APIs begrenzen, was ShinrAI zurückgeben kann. Für volle Qualität verwenden Sie die native PII-API v2.

Den geschwärzten Screenshot zurückerhalten

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

Einen Job für einen großen Stapel starten

Laden Sie zuerst eine JSONL-Datei mit einer Eingabe pro Zeile hoch. Die Antwort auf den Upload enthält die ID für den 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"]}}'

Leitfaden zur nativen API v2 · Vollständige v2-Referenz (Markdown) · API-Explorer (Swagger) · OpenAPI 3.1 für v2 · OpenAPI 3.1 für alle APIs

Einstieg wählen

1

Anfrage senden

Erstellen Sie einen Schlüssel und erkennen Sie personenbezogene Daten in einer synthetischen Nachricht.

2

Praxisablauf nachvollziehen

Schützen Sie Supportnachrichten, CRM-Datensätze, KI-Kontext und Dokumente.

3

Tools verbinden

Nutzen Sie gepflegte Anleitungen für n8n, Onyx, Dify, Nextcloud und weitere Produkte.

Lokaler Open-Source-Testbereich

Hello ShinrAI lokal ausführen

Testen und untersuchen Sie den vollständigen Schutzablauf in einem Browser-Arbeitsbereich. Für Texte, Dateien, Scans und Kompatibilitäts-APIs benötigen Sie einen ShinrAI-Schlüssel; einen LLM-Schlüssel brauchen Sie nur für den geschützten Chat.

Installieren Sie uv einmal und starten Sie dann die geprüfte Version:

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

Verwenden Sie die Bereiche Text, Dateien, Chat, Azure-Vergleich und API-Explorer. Schlüssel verbleiben im lokalen Prozess, sofern Sie sie nicht ausdrücklich im Anmeldedatenspeicher Ihres Betriebssystems speichern.

Repository und Einrichtungsanleitung öffnen Anleitung zur lokalen App lesen

Geprüfte Version: v0.1.4. Ändern Sie für ein Upgrade beide Versionsangaben in der Wheel-URL.

API-Referenz

Anfragen an die echte API senden

Der Explorer wird vom ShinrAI-Gateway bereitgestellt und aus dessen registrierten Kundenrouten erstellt. Skripte und Stile liegen im Backend.

Swagger öffnen