Détections de texte

POST /text/detections lance une vérification de texte. Elle classe un texte brut avec fvdoc-3-text et renvoie les passages rédigés par IA. Elle est synchrone : le résultat se trouve dans la réponse.

Les exemples lisent le texte dans un fichier : enregistrez donc d’abord un passage de 100 mots ou plus sous le nom essay.txt. Le Démarrage rapide contient une commande qui écrit un exemple.

curl https://api.fileverity.com/v1/text/detections \  -H "Authorization: Bearer $FILEVERITY_API_KEY" \  -H "Content-Type: application/json" \  -H "Idempotency-Key: 6b9d1c1e-3b0f-4c0a-9a53-2d1c9d6b7e11" \  -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/detections", {  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" }),});const detection = await response.json();

import osimport uuidimport requests response = requests.post(    "https://api.fileverity.com/v1/text/detections",    headers={        "Authorization": "Bearer " + os.environ["FILEVERITY_API_KEY"],        "Idempotency-Key": str(uuid.uuid4()),    },    json={"text": open("essay.txt", encoding="utf-8").read(), "language": "en"},)detection = response.json()

Corps de la requête#

Les champs inconnus sont rejetés avec invalid_parameter. Lors du contrôle du minimum de 100 mots, environ deux caractères chinois comptent pour un mot.

Réponse#

{  "id": "tdet_8Hk2pQ4vN9sL1xR7cW3mY6zB",  "object": "text.detection",  "created": 1793664000,  "model": "fvdoc-3-text-2026-11-03",  "livemode": true,  "language": "en",  "verdict": "mixed",  "score": 0.97,  "ai_fraction": 0.41,  "segments": [    {      "start": 212,      "end": 433,      "score": 0.97    },    {      "start": 579,      "end": 790,      "score": 0.93    }  ],  "usage": {    "characters": 1412,    "free_characters": 0,    "billed_units": 2  }}

La détection de texte renvoie une estimation statistique, et non une preuve de l’identité de l’auteur. Les limites des segments sont approximatives. Considérez-la comme un élément parmi d’autres d’un examen humain et ne vous appuyez pas uniquement dessus pour prendre une décision concernant une personne.

Positions des segments#

start et end 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 limites des segments sont approximatives et peuvent inclure des phrases adjacentes. 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 } of detection.segments) {  console.log(points.slice(start, end).join(""));}

for segment in detection["segments"]:    print(text[segment["start"]:segment["end"]])

Les chaînes Python sont déjà indexées par point de code.

Facturation#

• Le texte est facturé 0,14 $ US 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é.
• Les caractères de texte de votre démarrage gratuit sont utilisés en premier et indiqués dans usage.free_characters. usage.billed_units est le nombre d’unités facturées une fois ces caractères déduits : le coût est donc billed_units multiplié par 0,14 $ US. Exemple : 1 412 caractères sans caractères gratuits restants représentent 2 unités, soit 0,28 $ US.
• Les requêtes rejetées avant l’évaluation ne sont pas facturées : paramètres non valides, texte trop court ou trop long, langues non prises en charge, etc. Une vérification qui échoue au sein du service (service_unavailable) est libérée et n’est pas facturée.
• Un solde insuffisant renvoie insufficient_balance (402).

Ce qui est conservé#

Le texte est évalué puis supprimé. Il n’est jamais conservé et ne peut donc pas être récupéré ultérieurement.

Fileverity conserve le résultat, sans le texte (verdict, scores, positions des passages et utilisation), pendant 7 jours, afin que la Console puisse l’afficher et que l’utilisation puisse être facturée et auditée. Une nouvelle tentative avec la même Idempotency-Key reçoit le résultat enregistré pendant 24 heures. Les détections de texte 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#

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.