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

Source : https://fileverity.com/fr/docs/plagiarism

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

**Requête: 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)"
```

**Requête: 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();
```

**Requête: 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()
```

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

**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
  }
}
```

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

> **Remarque.** 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 :

**Extraire une correspondance: JavaScript**

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

**Extraire une correspondance: Python**

```python
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_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é](https://fileverity.com/fr/docs/security.md#retention). 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é](https://fileverity.com/fr/docs/security.md).

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

> **Remarque.** 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](https://fileverity.com/fr/docs/idempotency.md).

