Fileverity-API-Dokumentation
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.
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.
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)"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();import osimport uuidimport 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
{ "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. |
Ü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
exactauffalsegemeldet. - 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
quotedauftruegesetzt, bei Passagen nach einer Überschrift wie References, Bibliography, Références, Referencias oder المراجع istreferenceauftruegesetzt. Beide bleiben insimilarityunberücksichtigt; überexcluded_wordskö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:
const points = Array.from(text);for (const { start, end, source } of check.matches) { console.log(source, points.slice(start, end).join(""));}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_unitsist die Anzahl der berechneten Einheiten undusage.creditsdie 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. 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.
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. |
Senden Sie einen Idempotency-Key, damit ein erneuter Versuch nach einem Timeout nicht doppelt berechnet wird. Siehe Idempotenz.