# Plagiatsprüfungen

> Finden Sie mit POST /text/plagiarism Passagen eines reinen Textes, die mit öffentlichen Webseiten und Wikipedia übereinstimmen. Felder von Anfrage und Antwort, Quellen, Übereinstimmungen, Ausschlüsse, Umfang, Limits und Abrechnung.

Quelle: https://fileverity.com/de/docs/plagiarism

`POST /text/plagiarism` prüft einen Text mit `plagiarism-1`. Der Endpunkt durchsucht öffentliche Webseiten und Wikipedia nach Passagen, die mit dem Text übereinstimmen, und liefert diese Passagen, die zugehörigen Quellen und den Anteil übereinstimmenden Textes. Der Aufruf ist synchron und dauert meist 20 bis 60 Sekunden: Halten Sie die Verbindung offen.

Die Prüfung funktioniert für Englisch, Spanisch, Französisch und Arabisch. Speichern Sie einen Text mit mindestens 50 Wörtern als `essay.txt`, um die Beispiele auszuführen.

**Anfrage: cURL**

```bash
curl https://api.fileverity.com/v1/text/plagiarism \
  -H "Authorization: Bearer $FILEVERITY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 3e8d1c1e-3b0f-4c0a-9a53-2d1c9d6b7e31" \
  --max-time 120 \
  -d "$(jq -Rs '{text: ., language: "en"}' essay.txt)"
```

**Anfrage: JavaScript**

```javascript
import { readFile } from "node:fs/promises";
import { randomUUID } from "node:crypto";

const response = await fetch("https://api.fileverity.com/v1/text/plagiarism", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.FILEVERITY_API_KEY,
    "Content-Type": "application/json",
    "Idempotency-Key": randomUUID(),
  },
  body: JSON.stringify({ text: await readFile("essay.txt", "utf8"), language: "en" }),
  signal: AbortSignal.timeout(120_000),
});
const check = await response.json();
```

**Anfrage: Python**

```python
import os
import uuid
import requests

response = requests.post(
    "https://api.fileverity.com/v1/text/plagiarism",
    headers={
        "Authorization": "Bearer " + os.environ["FILEVERITY_API_KEY"],
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={"text": open("essay.txt", encoding="utf-8").read(), "language": "en"},
    timeout=120,
)
check = response.json()
```

## Anfragetext

| Feld | Typ | Erforderlich | Beschreibung |
| --- | --- | --- | --- |
| `text` | string | Ja | Reiner Text mit mindestens 50 Wörtern und höchstens 30.000 Zeichen. |
| `model` | string | Nein | Standard ist `plagiarism-1`. Akzeptiert wird die Modell-ID oder ihre Snapshot-ID `plagiarism-1-2026-11-16`. |
| `language` | string oder null | Nein | ISO-639-1-Code: `en`, `es`, `fr`, `ar`. Wird bei Auslassung automatisch erkannt. Er bestimmt die Wikipedia-Ausgabe und die Suchsprache. |

Unbekannte Felder werden mit `invalid_parameter` abgelehnt. Ein Text in einer anderen Sprache oder mit nicht erkennbarer Sprache liefert `unsupported_language`.

## Antwort

**200 OK**

```json
{
  "id": "tpl_8Hk2pQ4vN9sL1xR7cW3mY6zB",
  "object": "text.plagiarism",
  "created": 1794787200,
  "model": "plagiarism-1-2026-11-16",
  "livemode": true,
  "language": "en",
  "words": 812,
  "scored_words": 744,
  "excluded_words": {
    "quoted": 23,
    "reference": 45
  },
  "matched_words": 61,
  "similarity": 0.082,
  "sources": [
    {
      "id": 1,
      "url": "https://en.wikipedia.org/wiki/Photosynthesis",
      "title": "Photosynthesis",
      "host": "en.wikipedia.org",
      "words": 38,
      "share": 0.051,
      "partial": false
    },
    {
      "id": 2,
      "url": "https://example.org/biology/light-reactions",
      "title": "The light reactions of photosynthesis",
      "host": "example.org",
      "words": 23,
      "share": 0.031,
      "partial": false
    }
  ],
  "matches": [
    {
      "start": 1022,
      "end": 1288,
      "words": 38,
      "source": 1,
      "excerpt": "Photosynthesis is a system of biological processes by which photopigment-bearing autotrophic organisms, such as most plants, algae and cyanobacteria, convert light energy into the chemical energy necessary to fuel their metabolism.",
      "quoted": false,
      "reference": false,
      "exact": true
    },
    {
      "start": 2410,
      "end": 2566,
      "words": 23,
      "source": 2,
      "excerpt": "In the light-dependent reactions, one molecule of the pigment chlorophyll absorbs one photon and loses one electron.",
      "quoted": false,
      "reference": false,
      "exact": false
    },
    {
      "start": 3105,
      "end": 3230,
      "words": 19,
      "source": 1,
      "excerpt": "The term photosynthesis usually refers to oxygenic photosynthesis, a process that releases oxygen as a byproduct.",
      "quoted": true,
      "reference": false,
      "exact": true
    }
  ],
  "queries": 12,
  "pages": 9,
  "version": "2026.11-p1",
  "usage": {
    "characters": 5120,
    "billed_units": 6,
    "credits": 6
  }
}
```

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `id` | string | ID der Prüfung mit dem Präfix `tpl_`. |
| `object` | string | Immer `text.plagiarism`. |
| `created` | integer | Unix-Zeitstempel. |
| `model` | string | Snapshot, der das Ergebnis erzeugt hat. |
| `livemode` | boolean | `false` bei Testschlüsseln. |
| `language` | string | Die verwendete Sprache: die von Ihnen gesendete oder die erkannte. |
| `words` | integer | Wörter im Text. |
| `scored_words` | integer | Wörter außerhalb von Anführungszeichen und Literaturverzeichnis. Der Nenner von `similarity`. |
| `excluded_words` | object | `quoted` Wörter in Anführungszeichen und `reference` Wörter im Literaturverzeichnis, damit Sie den Anteil mit anderen Ausschlüssen neu berechnen können. |
| `matched_words` | integer | Gewertete Wörter in übereinstimmenden Passagen, jedes Wort einmal gezählt. |
| `similarity` | number | Von 0 bis 1: `matched_words` geteilt durch `scored_words`. Ein Anteil übereinstimmenden Textes, kein Urteil. |
| `sources` | array | Quellen mit mindestens einer übereinstimmenden Passage, die größte zuerst. Jede enthält `id`, `url`, `title`, `host`, `words`, `share` und `partial`; Letzteres ist `true`, wenn nur der Suchauszug der Seite verglichen werden konnte. |
| `matches` | array | Übereinstimmende Passagen in Textreihenfolge. Jede enthält `start`, `end` (exklusiv), `words`, `source` (die `id` der Quelle), `excerpt` (der übereinstimmende Text in der Quelle, bis zu 300 Zeichen), `quoted`, `reference` und `exact`. |
| `queries` | integer | Gesuchte Wortfolgen. |
| `pages` | integer | Verglichene Seiten. |
| `version` | string | Version des Abgleichverfahrens. Vergleichen Sie Ergebnisse nur innerhalb einer Version. |
| `usage` | object | `characters` ausgewertet, `billed_units` berechnet und `credits` belastet. |

> **Hinweis.** Übereinstimmender Text ist kein Urteil. Auch Zitate, geläufige Wendungen und korrekt belegte Passagen stimmen überein, und ein niedriger Anteil belegt nicht, dass ein Text eigenständig ist. Zeigen Sie die Passagen mit ihren Quellen einer Person, die im Zusammenhang entscheidet.

## So arbeitet die Prüfung und was sie abdeckt

- Markante Wortfolgen des Textes werden als exakte Wortfolgen im öffentlichen Web und in der Wikipedia-Ausgabe der Textsprache gesucht. Die gefundenen Seiten werden abgerufen und Wort für Wort mit dem Text verglichen; eine Übereinstimmung braucht daher mehrere Wörter in derselben Reihenfolge. Einige geänderte oder eingefügte Wörter werden trotzdem erkannt; die Passage wird dann mit `exact` auf `false` gemeldet.
- Durchsuchte Quellen: öffentliche Webseiten und Wikipedia. Bücher, kostenpflichtige Fachzeitschriften, Arbeiten anderer Studierender, Lernplattformen und private Datenbanken sind für die Prüfung nicht sichtbar. Seiten, die automatisierten Zugriff verweigern, werden nur über ihren Suchauszug verglichen (`partial`).
- Nicht gefunden werden: umformulierter Text, übersetzter Text und Text, dessen Quelle nicht öffentlich ist. Ein Text kann kopiert sein und trotzdem keine Übereinstimmung liefern.
- Ausschlüsse: Bei Passagen in Anführungszeichen ist `quoted` auf `true` gesetzt, bei Passagen nach einer Überschrift wie References, Bibliography, Références, Referencias oder المراجع ist `reference` auf `true` gesetzt. Beide bleiben in `similarity` unberücksichtigt; über `excluded_words` können Sie sie einbeziehen.
- Wortfolgen des Textes werden an Brave Search und an Wikipedia gesendet, um mögliche Quellseiten zu finden. Der vollständige Text wird nie an sie gesendet, und es wird nichts in eine Datenbank übernommen.

## Offsets

`start` und `end` jeder Übereinstimmung sind Offsets in den Text, den Sie gesendet haben, gezählt in Unicode-Codepoints, nicht in Bytes und nicht in UTF-16-Einheiten. JavaScript-Strings werden nach UTF-16 indiziert; zerlegen Sie den Text daher zuerst in Codepoints:

**Eine Übereinstimmung ausschneiden: JavaScript**

```javascript
const points = Array.from(text);
for (const { start, end, source } of check.matches) {
  console.log(source, points.slice(start, end).join(""));
}
```

**Eine Übereinstimmung ausschneiden: Python**

```python
for match in check["matches"]:
    print(match["source"], text[match["start"]:match["end"]])
```

## Abrechnung

- Eine Plagiatsprüfung kostet 1 Credit pro 1.000 Zeichen, gezählt in Unicode-Codepoints. Jede Anfrage wird auf ganze Einheiten aufgerundet, mindestens eine Einheit.
- `usage.billed_units` ist die Anzahl der berechneten Einheiten und `usage.credits` die berechneten Credits. Beispiel: 5.120 Zeichen ergeben 6 Einheiten, 6 Credits.
- Eine Prüfung, die keine übereinstimmende Quelle findet, wird dennoch berechnet: Die Suche wurde ausgeführt. Anfragen, die vor der Auswertung abgelehnt werden, werden nicht berechnet, ebenso wenig eine Prüfung, die im Dienst fehlschlägt (`service_unavailable`); sie wird freigegeben.
- Reichen die Credits nicht aus, wird `insufficient_balance` (402) zurückgegeben. Über die API stehen Plagiatsprüfungen Workspaces offen, die Credits gekauft haben, und verbrauchen immer Credits; auf der Website und in der Konsole gehören sie zum Pro-Tarif.

## Was gespeichert wird

Eine Kopie des Textes wird bis zu 3 Jahre lang verschlüsselt aufbewahrt, um die Erkennungsmodelle von Fileverity zu trainieren und zu bewerten; siehe [Datenaufbewahrung und Sicherheit](https://fileverity.com/de/docs/security.md#retention). Fileverity speichert das Ergebnis (Quellen, Offsets der Übereinstimmungen mit kurzen Quellauszügen, Zählwerte und die Nutzung) 7 Tage lang, damit die Konsole es anzeigen und die Nutzung abgerechnet und geprüft werden kann. Eine wiederholte Anfrage mit demselben `Idempotency-Key` erhält 24 Stunden lang das gespeicherte Ergebnis. Abgerufene Seiten werden im Arbeitsspeicher verglichen und nicht gespeichert. Plagiatsprüfungen sind synchron: Sie erscheinen nicht in `GET /analyses` und senden keine Webhook-Ereignisse. Testschlüssel speichern nichts. Siehe [Datenaufbewahrung und Sicherheit](https://fileverity.com/de/docs/security.md).

## Fehler

| Code | Status | Ursache |
| --- | --- | --- |
| `text_too_short` | 400 | Weniger als 50 Wörter. |
| `text_too_long` | 413 | Mehr als 30.000 Zeichen. Teilen Sie den Text auf mehrere Anfragen auf. |
| `unsupported_language` | 400 | Der Text ist nicht auf Englisch, Spanisch, Französisch oder Arabisch verfasst, oder seine Sprache konnte nicht erkannt werden. Senden Sie `language`, um eine Sprache festzulegen. |
| `unsupported_media_type` | 415 | Der Anfragetext wird nicht als `application/json` gesendet. |
| `invalid_json`, `missing_parameter`, `invalid_parameter` | 400 | Der Anfragetext ist kein JSON-Objekt, `text` fehlt, ein Feld hat den falschen Typ oder es wurde ein unbekanntes Feld gesendet. |
| `model_not_found` | 404 | Das `model` ist unbekannt. |
| `plan_required` | 403 | Der Workspace hat noch keine Credits gekauft. Kaufen Sie ein Credit-Paket in der Konsole. |
| `insufficient_balance` | 402 | Das Guthaben reicht für die Anfrage nicht aus. |
| `spend_limit_reached` | 402 | Der Schlüssel hat sein monatliches Ausgabenlimit erreicht. |
| `idempotency_mismatch`, `idempotency_in_progress` | 409 | Der `Idempotency-Key` wurde mit einem anderen Anfragetext verwendet, oder seine erste Anfrage läuft noch. |
| `service_unavailable`, `analysis_failed` | 503, 502 | Die Suche oder der Vergleich konnte nicht abgeschlossen werden. Es wird nichts berechnet; versuchen Sie es erneut. Bei `service_unavailable` enthält die Antwort den Header `retry-after`. |

> **Hinweis.** Senden Sie einen `Idempotency-Key`, damit ein erneuter Versuch nach einem Timeout nicht doppelt berechnet wird. Siehe [Idempotenz](https://fileverity.com/de/docs/idempotency.md).

