Anonymisierung

Text-Anonymisierung

Maskiere personenbezogene Daten (PII) in beliebigem Text automatisch.

Sende den zu anonymisierenden Text im Body mit.

Beispiel-Request

1curl -X POST https://app.anymize.ai/api/anonymize \
2  -H "Authorization: Bearer YOUR_API_KEY" \
3  -H "Content-Type: application/json" \
4  -d '{
5    "text": "Max Mustermann wohnt in Berlin und seine E-Mail ist max@example.com",
6    "language": "de"
7  }'

Beispiel-Antwort

Der anonymisierte Text enthält Platzhalter für erkannte Entitäten.

{
  "job_id": "11111111-1111-4111-8111-111111111111",
  "status": "processing",
  "message": "Job created. Use /api/status/{job_id} to check status.",
  "zdr": false
}

Endpoint

Lade Dokumente oder Bilder hoch, um sie per OCR zu verarbeiten und automatisch zu anonymisieren.

Unterstützte Formate

Die folgenden Dateiformate werden für die OCR-Verarbeitung unterstützt.

Parameter

Beispiel-Request

1curl -X POST https://app.anymize.ai/api/ocr \
2  -H "Authorization: Bearer YOUR_API_KEY" \
3  -F "file=@document.pdf"

Antwort

Gibt eine Job-ID zurück. Die Verarbeitung läuft asynchron – prüfe den Status mit der Status-API.

{
  "job_id": "11111111-1111-4111-8111-111111111111",
  "status": "processing",
  "message": "Document submitted for OCR and anonymization. Use /api/status/{job_id} to check status."
}

Verarbeitungs-Pipeline

Die Datei-Anonymisierung durchläuft eine 3-Schritt-Pipeline.

Endpunkt

Kombiniere Chat und Anonymisierung in einem einzigen Request — deine Daten werden vor dem Modell maskiert.

Ablauf

So verarbeitet der anonyme Chat deine Anfrage:

Parameter

Gleiche Parameter wie Chat Completions plus Anonymisierungs-Optionen.

Platzhalter-Handling

Beim anonymen Chat werden personenbezogene Daten automatisch durch Platzhalter im Format [[Typ-HASH]] ersetzt. Damit die De-Anonymisierung funktioniert, muss das Modell diese Platzhalter exakt beibehalten.

Ohne den richtigen System-Prompt schreibt das Modell oft 'eine anonymisierte Person' oder '[Name anonymisiert]' statt den Platzhalter [[Person-ABC123]] zu verwenden. Das macht die De-Anonymisierung unmöglich.

1## CRITICAL RULE: ANONYMIZATION PLACEHOLDERS
2
3THIS IS THE MOST IMPORTANT RULE. VIOLATING IT MAKES YOUR RESPONSE USELESS.
4
5The user's messages contain anonymized placeholders shaped [[<Type>-<HASH>]],
6where <Type> is the PII category (person, email, iban, telephone_number,
7address, ...) and <HASH> is a short random code.
8
9FORBIDDEN:
10- Writing "[Name anonymisiert]" or "[anonymized]"
11- Describing WHAT the placeholder is instead of USING it
12- Writing a double-bracket token that was NOT in the user's message — the hash
13  is a database key, so an invented one resolves to nothing. Never copy a hash
14  out of these instructions.
15
16REQUIRED:
17- Copy each placeholder character-for-character from the user's message
18- Use it inline like the real value: "Herr <placeholder> hat..."
19- Need a value the user never gave you? Use SINGLE brackets ([Name]).
20
21WHY: After your response, placeholders get replaced with real values.
22BEFORE RESPONDING: Check that every double-bracket token also appears, character-for-character, in the user's message.

Beispiel-Request

1curl -X POST https://app.anymize.ai/api/v1/llm-anonymous/chat/completions \
2  -H "Authorization: Bearer YOUR_API_KEY" \
3  -H "Content-Type: application/json" \
4  -d '{
5    "model": "fountain-1.0",
6    "messages": [
7      {"role": "user", "content": "Schreibe eine E-Mail an Max Mustermann, max@example.com, wegen dem Termin am 15. Januar."}
8    ],
9    "language": "de",
10  }'

Antwort

Die Antwort enthält den de-anonymisierten Text und Metadaten.

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "model": "fountain-1.0",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Sehr geehrter Herr Max Mustermann,\n\nich schreibe Ihnen bezüglich unseres Termins am 15. Januar..."
      },
      "finish_reason": "stop"
    }
  ],
  "_anymize": {
    "anonymized": true,
    "job_id": "44444444-4444-4444-8444-444444444444",
    "language": "de"
  }
}

Credit-Verbrauch

Anonymer Chat verbraucht Credits für zwei Leistungen:

• •LLM-Credits für die Modellnutzung (wie beim normalen Chat).
• •Anonymisierungs-Credits für die PII-Maskierung.

Übersicht

Ersetze Platzhalter durch die Originaldaten — kehre die Anonymisierung um.

Parameter

Sende den anonymisierten Text und die Job-ID, um die Originaldaten wiederherzustellen.

Beispiel-Request

1curl -X POST https://app.anymize.ai/api/deanonymize \
2  -H "Authorization: Bearer YOUR_API_KEY" \
3  -H "Content-Type: application/json" \
4  -d '{
5    "text": "Sehr geehrter [[Person-QSEZB6]], Ihre Adresse [[Adress-NT9DQE]] wurde aktualisiert."
6  }'

Antwort

Der de-anonymisierte Text enthält die Originaldaten an Stelle der Platzhalter.

{
  "text": "Sehr geehrter Max Mustermann, Ihre Adresse Berliner Str. 42, 10115 Berlin wurde aktualisiert.",
  "replacements": 2
}

Einschränkungen

• •Die Job-ID muss existieren und darf nicht abgelaufen sein.
• •Der ursprüngliche Job darf nicht mit ZDR erstellt worden sein.
• •Nur der Nutzer, der den Job erstellt hat, kann de-anonymisieren.

Fehlerfälle

Häufige Fehler bei der De-Anonymisierung und ihre Bedeutung.

{
  "error": {
    "message": "No hash pairs found for the given placeholders",
    "type": "not_found_error",
    "code": "hash_pairs_not_found"
  }
}

Endpunkt

Rufe die Zuordnungstabelle zwischen Platzhaltern und Originaldaten ab.

Parameter

Antwort

Die Antwort enthält ein Array von Paaren mit Platzhalter und Originalwert.

{
  "job_id": "11111111-1111-4111-8111-111111111111",
  "count": 6,
  "hash_pairs": [
    {
      "original": "Max Mustermann",
      "hash": "A1B2C3",
      "prefix_name": "Person",
      "placeholder": "[[Person-A1B2C3]]"
    },
    {
      "original": "Berlin",
      "hash": "D4E5F6",
      "prefix_name": "Location",
      "placeholder": "[[Location-D4E5F6]]"
    },
    {
      "original": "Acme GmbH",
      "hash": "G7H8I9",
      "prefix_name": "Organization",
      "placeholder": "[[Organization-G7H8I9]]"
    },
    {
      "original": "15.03.1990",
      "hash": "J1K2L3",
      "prefix_name": "Date",
      "placeholder": "[[Date-J1K2L3]]"
    },
    {
      "original": "max@example.com",
      "hash": "M4N5P6",
      "prefix_name": "Email",
      "placeholder": "[[Email-M4N5P6]]"
    },
    {
      "original": "+49 170 1234567",
      "hash": "Q7R8S9",
      "prefix_name": "Phone",
      "placeholder": "[[Phone-Q7R8S9]]"
    }
  ]
}

Entitätstypen

Platzhalter werden nach Typ kategorisiert: PERSON, ADRESSE, TELEFON, E_MAIL usw.

Einschränkungen

Beispiel-Request

1curl https://app.anymize.ai/api/status/11111111-1111-4111-8111-111111111111/strings \
2  -H "Authorization: Bearer YOUR_API_KEY"

Anwendungsfälle

Typische Szenarien, in denen Hash-Paare nützlich sind:

• •Qualitätsprüfung der Anonymisierung — kontrolliere, was maskiert wurde.
• •Teilweise De-Anonymisierung — ersetze nur bestimmte Platzhalter.
• •Audit und Compliance — dokumentiere, welche Daten anonymisiert wurden.