Zum Inhalt springen

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.

Als Markdown ansehenAktualisiert am 2026-11-16

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)"

Anfragetext

FeldTypErforderlichBeschreibung
textstringJaReiner Text mit mindestens 50 Wörtern und höchstens 30.000 Zeichen.
modelstringNeinStandard ist plagiarism-1. Akzeptiert wird die Modell-ID oder ihre Snapshot-ID plagiarism-1-2026-11-16.
languagestring oder nullNeinISO-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  }}
FeldTypBeschreibung
idstringID der Prüfung mit dem Präfix tpl_.
objectstringImmer text.plagiarism.
createdintegerUnix-Zeitstempel.
modelstringSnapshot, der das Ergebnis erzeugt hat.
livemodebooleanfalse bei Testschlüsseln.
languagestringDie verwendete Sprache: die von Ihnen gesendete oder die erkannte.
wordsintegerWörter im Text.
scored_wordsintegerWörter außerhalb von Anführungszeichen und Literaturverzeichnis. Der Nenner von similarity.
excluded_wordsobjectquoted Wörter in Anführungszeichen und reference Wörter im Literaturverzeichnis, damit Sie den Anteil mit anderen Ausschlüssen neu berechnen können.
matched_wordsintegerGewertete Wörter in übereinstimmenden Passagen, jedes Wort einmal gezählt.
similaritynumberVon 0 bis 1: matched_words geteilt durch scored_words. Ein Anteil übereinstimmenden Textes, kein Urteil.
sourcesarrayQuellen 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.
matchesarrayÜ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.
queriesintegerGesuchte Wortfolgen.
pagesintegerVerglichene Seiten.
versionstringVersion des Abgleichverfahrens. Vergleichen Sie Ergebnisse nur innerhalb einer Version.
usageobjectcharacters 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 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:

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

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. 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

CodeStatusUrsache
text_too_short400Weniger als 50 Wörter.
text_too_long413Mehr als 30.000 Zeichen. Teilen Sie den Text auf mehrere Anfragen auf.
unsupported_language400Der 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_type415Der Anfragetext wird nicht als application/json gesendet.
invalid_json, missing_parameter, invalid_parameter400Der Anfragetext ist kein JSON-Objekt, text fehlt, ein Feld hat den falschen Typ oder es wurde ein unbekanntes Feld gesendet.
model_not_found404Das model ist unbekannt.
plan_required403Der Workspace hat noch keine Credits gekauft. Kaufen Sie ein Credit-Paket in der Konsole.
insufficient_balance402Das Guthaben reicht für die Anfrage nicht aus.
spend_limit_reached402Der Schlüssel hat sein monatliches Ausgabenlimit erreicht.
idempotency_mismatch, idempotency_in_progress409Der Idempotency-Key wurde mit einem anderen Anfragetext verwendet, oder seine erste Anfrage läuft noch.
service_unavailable, analysis_failed503, 502Die 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.