Documentation de l’API Fileverity
Détections de plagiat
Trouvez les passages d’un texte brut qui correspondent à des pages web publiques et à Wikipédia avec POST /text/plagiarism. Champs de la requête et de la réponse, sources, correspondances, exclusions, périmètre, limites et facturation.
POST /text/plagiarism vérifie un texte avec plagiarism-1. Il recherche dans les pages web publiques et sur Wikipédia les passages qui correspondent au texte, puis renvoie les passages correspondants, les sources auxquelles ils correspondent et la part de texte correspondant. L’appel est synchrone et dure généralement de 20 à 60 secondes : gardez la connexion ouverte.
Il fonctionne en anglais, espagnol, français et arabe. Enregistrez un texte d’au moins 50 mots sous le nom essay.txt pour exécuter les exemples.
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()Corps de la requête
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
text | chaîne | Oui | Texte brut d’au moins 50 mots et d’au plus 30 000 caractères. |
model | chaîne | Non | Valeur par défaut : plagiarism-1. Accepte l’ID de modèle ou son ID d’instantané plagiarism-1-2026-11-16. |
language | chaîne ou null | Non | Code ISO 639-1 : en, es, fr, ar. Détecté automatiquement si omis. Il détermine l’édition de Wikipédia et la langue de recherche. |
Les champs inconnus sont rejetés avec invalid_parameter. Un texte rédigé dans une autre langue, ou dont la langue ne peut pas être reconnue, renvoie unsupported_language.
Réponse
{ "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 }}| Champ | Type | Description |
|---|---|---|
id | chaîne | ID de la vérification, avec le préfixe tpl_. |
object | chaîne | Toujours text.plagiarism. |
created | entier | Horodatage Unix. |
model | chaîne | Instantané qui a produit le résultat. |
livemode | booléen | false pour les clés de test. |
language | chaîne | La langue utilisée : celle que vous avez envoyée, ou celle qui a été détectée. |
words | entier | Mots du texte. |
scored_words | entier | Mots situés hors des guillemets et de la liste de références. Dénominateur de similarity. |
excluded_words | objet | quoted correspond aux mots entre guillemets et reference aux mots de la liste de références, ce qui permet de recalculer la part avec d’autres exclusions. |
matched_words | entier | Mots évalués situés dans des passages correspondants, chaque mot n’étant compté qu’une fois. |
similarity | nombre | De 0 à 1 : matched_words divisé par scored_words. Une part de texte correspondant, et non un verdict. |
sources | tableau | Sources comportant au moins un passage correspondant, de la plus importante à la moins importante. Chacune comporte id, url, title, host, words, share et partial, qui vaut true lorsque seul l’extrait de recherche de la page a pu être comparé. |
matches | tableau | Passages correspondants dans l’ordre du texte. Chacun comporte start, end (exclu), words, source (l’id de la source), excerpt (le texte correspondant dans la source, 300 caractères au plus), quoted, reference et exact. |
queries | entier | Expressions recherchées. |
pages | entier | Pages comparées. |
version | chaîne | Version de la méthode de correspondance. Ne comparez les résultats qu’au sein d’une même version. |
usage | objet | characters évalués, billed_units facturées et credits débités. |
Un texte correspondant n’est pas un verdict. Les citations, les expressions courantes et les passages correctement cités correspondent aussi, et une faible part ne prouve pas qu’un texte est original. Présentez les passages avec leurs sources à une personne qui décide en fonction du contexte.
Fonctionnement de la vérification et périmètre couvert
- Des expressions distinctives du texte sont recherchées comme expressions exactes sur le web public et dans l’édition de Wikipédia correspondant à la langue du texte. Les pages obtenues sont récupérées et comparées au texte mot à mot : une correspondance exige donc plusieurs mots dans le même ordre. Quelques mots modifiés ou insérés correspondent encore, et le passage est alors signalé avec
exactàfalse. - Sources consultées : pages web publiques et Wikipédia. Les livres, les revues payantes, les travaux d’autres étudiants, les plateformes d’apprentissage et les bases de données privées ne sont pas accessibles à la vérification. Les pages qui refusent l’accès automatisé sont comparées uniquement à partir de leur extrait de recherche (
partial). - Non retrouvés : les textes paraphrasés, les textes traduits et les textes dont la source n’est pas publique. Un texte peut avoir été copié sans qu’aucune correspondance soit renvoyée.
- Exclusions : les passages entre guillemets ont
quotedàtrue, et les passages situés après un titre tel que References, Bibliography, Références, Referencias ou المراجع ontreferenceàtrue. Les deux sont exclus desimilarity; utilisezexcluded_wordspour les inclure. - Des expressions du texte sont envoyées à Brave Search et à Wikipédia pour trouver des pages candidates. Le texte complet ne leur est jamais envoyé, et rien n’est ajouté à une base de données.
Positions
start et end de chaque correspondance sont des positions dans le texte que vous avez envoyé, comptées en points de code Unicode, et non en octets ni en unités UTF-16. Les chaînes JavaScript sont indexées en UTF-16 : découpez donc d’abord le texte en points de code :
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"]])Facturation
- Une détection de plagiat coûte 1 crédit par tranche de 1 000 caractères, comptés en points de code Unicode. Chaque requête est arrondie à l’unité supérieure, avec un minimum d’une unité.
usage.billed_unitsest le nombre d’unités facturées etusage.creditsle nombre de crédits débités. Exemple : 5 120 caractères comptent pour 6 unités, soit 6 crédits.- Une vérification qui ne trouve aucune source correspondante est tout de même facturée : la recherche a bien été effectuée. Les requêtes rejetées avant l’évaluation ne sont pas facturées, et une vérification qui échoue dans le service (
service_unavailable) n’est pas facturée : les crédits réservés sont libérés. - Un nombre de crédits insuffisant renvoie
insufficient_balance(402). Via l’API, les détections de plagiat sont ouvertes aux espaces de travail qui ont acheté des crédits et utilisent toujours des crédits ; sur le site et dans la Console, elles font partie de la formule Pro.
Ce qui est conservé
Une copie du texte est conservée chiffrée pendant 3 ans au plus pour entraîner et évaluer les modèles de détection de Fileverity ; voir Conservation des données et sécurité. Fileverity conserve le résultat (sources, positions des correspondances avec de courts extraits des sources, compteurs et utilisation) pendant 7 jours, afin que la Console puisse l’afficher et que l’utilisation puisse être facturée et auditée. Les pages récupérées sont comparées en mémoire et ne sont pas conservées. Une nouvelle tentative avec la même Idempotency-Key reçoit le résultat enregistré pendant 24 heures. Les détections de plagiat sont synchrones : elles n’apparaissent pas dans GET /analyses et n’envoient pas d’événements webhook. Les clés de test n’enregistrent rien. Voir Conservation des données et sécurité.
Erreurs
| Code | Statut | Cause |
|---|---|---|
text_too_short | 400 | Moins de 50 mots. |
text_too_long | 413 | Plus de 30 000 caractères. Divisez le texte en plusieurs requêtes. |
unsupported_language | 400 | Le texte n’est pas rédigé en anglais, espagnol, français ou arabe, ou sa langue n’a pas pu être reconnue. Envoyez language pour en choisir une. |
unsupported_media_type | 415 | Le corps n’est pas envoyé en application/json. |
invalid_json, missing_parameter, invalid_parameter | 400 | Le corps n’est pas un objet JSON, text est absent, un champ a un type incorrect ou un champ inconnu a été envoyé. |
model_not_found | 404 | Le model est inconnu. |
plan_required | 403 | L’espace de travail n’a pas encore acheté de crédits. Achetez un pack de crédits dans la Console. |
insufficient_balance | 402 | Le solde ne permet pas de couvrir la requête. |
spend_limit_reached | 402 | La clé a atteint sa limite de dépense mensuelle. |
idempotency_mismatch, idempotency_in_progress | 409 | La Idempotency-Key a été utilisée avec un corps différent, ou sa première requête est encore en cours. |
service_unavailable, analysis_failed | 503, 502 | La recherche ou la comparaison n’a pas pu aboutir. Aucune facturation ; réessayez. service_unavailable s’accompagne d’un en-tête retry-after. |
Envoyez une Idempotency-Key pour qu’une nouvelle tentative après un délai dépassé ne soit pas facturée deux fois. Voir Idempotence.