Aller au contenu

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.

Voir en MarkdownMis à jour le 2026-11-16

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

Corps de la requête

ChampTypeObligatoireDescription
textchaîneOuiTexte brut d’au moins 50 mots et d’au plus 30 000 caractères.
modelchaîneNonValeur par défaut : plagiarism-1. Accepte l’ID de modèle ou son ID d’instantané plagiarism-1-2026-11-16.
languagechaîne ou nullNonCode 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  }}
ChampTypeDescription
idchaîneID de la vérification, avec le préfixe tpl_.
objectchaîneToujours text.plagiarism.
createdentierHorodatage Unix.
modelchaîneInstantané qui a produit le résultat.
livemodebooléenfalse pour les clés de test.
languagechaîneLa langue utilisée : celle que vous avez envoyée, ou celle qui a été détectée.
wordsentierMots du texte.
scored_wordsentierMots situés hors des guillemets et de la liste de références. Dénominateur de similarity.
excluded_wordsobjetquoted 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_wordsentierMots évalués situés dans des passages correspondants, chaque mot n’étant compté qu’une fois.
similaritynombreDe 0 à 1 : matched_words divisé par scored_words. Une part de texte correspondant, et non un verdict.
sourcestableauSources 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é.
matchestableauPassages 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.
queriesentierExpressions recherchées.
pagesentierPages comparées.
versionchaîneVersion de la méthode de correspondance. Ne comparez les résultats qu’au sein d’une même version.
usageobjetcharacters é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 المراجع ont reference à true. Les deux sont exclus de similarity ; utilisez excluded_words pour 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(""));}

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_units est le nombre d’unités facturées et usage.credits le 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

CodeStatutCause
text_too_short400Moins de 50 mots.
text_too_long413Plus de 30 000 caractères. Divisez le texte en plusieurs requêtes.
unsupported_language400Le 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_type415Le corps n’est pas envoyé en application/json.
invalid_json, missing_parameter, invalid_parameter400Le 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_found404Le model est inconnu.
plan_required403L’espace de travail n’a pas encore acheté de crédits. Achetez un pack de crédits dans la Console.
insufficient_balance402Le solde ne permet pas de couvrir la requête.
spend_limit_reached402La clé a atteint sa limite de dépense mensuelle.
idempotency_mismatch, idempotency_in_progress409La Idempotency-Key a été utilisée avec un corps différent, ou sa première requête est encore en cours.
service_unavailable, analysis_failed503, 502La 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.