---
title: "Mesure d’essai, sans compte : un texte contre trois textes de référence collés dans l’appel"
method: POST
path: "/api/v1/verdict"
tags: ["Mesure"]
---

# Mesure d’essai, sans compte : un texte contre trois textes de référence collés dans l’appel

`POST /api/v1/verdict`

## Request

- Base URL: `https://kaneme.com`
- URL: `https://kaneme.com/api/v1/verdict`
- Auth: none required

## Request body

- object
  - `samples` string[], required: Exactement 3 textes de la personne, 100 mots minimum chacun. Varie les registres — trois fois le même contexte mesure le contexte, pas l’auteur.
  - `text` string, required: Texte à attribuer (50 mots minimum, 150 pour sortir de la confiance basse).
  - `question` 'human' | 'author': human = cette personne contre une IA ; author = cette personne contre un autre humain.

## Response `200`

Succès.

- PublicVerdict
  - `measurement` object
    - `version` 'kaneme.measurement.v1', required
    - `axis` 'q1' | 'q2', required
    - `contrast` string, required
    - `display` string, nullable, required
    - `calibrationLanguage` 'fr' | 'en', required
    - `candidateLanguage` string, required
    - `engine` string, nullable
    - `model` string, required
    - `scoreVersion` string, required
    - `calibrationVersion` string, required
    - `calibrationSource` string, required
    - `limitation` string, required
  - `question` 'author' | 'human', required
  - `probability` number, nullable, required
  - `unavailable` 'self_overlap' | 'unsupported_language' | 'voice_language_mismatch' | 'mixed_language' | 'embedding_layer' | 'out_of_distribution' | 'calibration_mismatch': self_overlap — Le texte à juger est déjà, pour l’essentiel, dans la référence qui le juge : la mesure porterait sur elle-même. Juge un texte que la référence ne contient pas — ou retire-le du corpus de cette voix. · unsupported_language — Le texte ne se lit ni en français ni en anglais, même en départageant ces deux seules langues : le verdict n’est calibré que sur elles, chacune avec son propre moteur. Lis le champ `language` de la réponse avant d’appeler : hors du français et de l’anglais, ne demande pas de verdict. · voice_language_mismatch — Le texte et la voix de référence ne sont pas écrits dans la même langue : chaque moteur ne compare un texte qu’à une voix de sa langue. Juge ce texte avec une voix écrite dans sa langue — crée-la si elle n’existe pas. Ne le traduis pas pour contourner ce refus. · mixed_language — Le texte est dans la langue de la voix, mais au moins une phrase entière est dans l’autre langue servie : la mesure mêlerait deux moteurs. Corrige ou retire les passages renvoyés dans `passages` (positions dans le texte), puis relance. Les mots isolés — anglicismes, marques — et les citations entre guillemets ne déclenchent pas ce refus. · embedding_layer — La couche de mesure profonde n’a pas répondu ; sans elle, aucune probabilité n’est calibrée. Réessaie dans un instant si la couche de mesure redevient disponible. · out_of_distribution — Le panel de contraste ne couvre pas le registre de cette voix : la marge existerait, elle ne voudrait rien dire. Verse dans la voix des textes de référence plus proches du registre mesuré. · calibration_mismatch — La version du moteur ne correspond pas à une calibration validée. Attends la correction de la configuration du moteur. Ne modifie ni ne traduis le texte pour contourner ce refus.
  - `explanation` object
    - `version` string, required
    - `summary` string, required
    - `caveat` string, required
    - `factors` object[], required
      - `id` 'cadence' | 'registre' | 'structure' | 'lexique', required
      - `label` string, required
      - `status` 'aligned' | 'mixed' | 'different' | 'unmeasured', required
      - `gap` number, nullable, required
      - `detail` string, required
  - `passages` object[]: Présent uniquement avec `unavailable: "mixed_language"` : les phrases écrites dans l’autre langue, avec leurs positions (`start`, `end`) dans le texte jugé. Les corriger ou les retirer, puis relancer.
    - `text` string, required
    - `start` integer, required
    - `end` integer, required
    - `language` 'fr' | 'en', required
  - `label` string: Bande en clair, dérivée de `probability` : « Signe cette voix », « Plausiblement cette voix », « Ambigu », puis « Voix générique » (q1) ou « Voix étrangère » (q2). Avant le 12/10/2026 : « Auteur probable », « Auteur plausible », « Imposteur probable ». Absent quand `unavailable` est présent.
  - `band` 'signature' | 'plausible' | 'ambiguous' | 'foreign': La bande de `label`, en clé stable : `signature`, `plausible`, `ambiguous`, `foreign` (sur q1, `foreign` est une écriture générique ; sur q2, une autre voix). Présent exactement quand `label` l’est. Depuis le contrat 5.3.0.
  - `confidence` 'none' | 'low' | 'medium' | 'high'
  - `referenceLimited` boolean, required
  - `language` string
  - `version` string, required
  - `dimensions` object[], required: Sur quoi le texte s’écarte des références : rythme, lexique, structure, signature. Ce n’est PAS la décomposition de `probability` — ces quatre-là lisent la couche stylométrique, qui pèse 20 % du score fusionné. Servies même en abstention : ce sont des faits mesurés, pas un verdict.
    - `passages` object[]
      - `start` number, required
      - `end` number, required
      - `quote` string, required
      - `observation` string, required
      - `basis` 'reference' | 'preference' | 'observation', required
    - `id` 'rythme' | 'lexique' | 'structure' | 'signature', required
    - `label` string, required
    - `measured` boolean, required
    - `score` number, nullable, required
    - `detail` string, required
  - `dimensionsVersion` string, required

## Other responses

- `400`: Requête invalide (champ manquant, borne dépassée, curseur illisible).
- `404`: Ressource introuvable.
- `429`: Cadence dépassée (code « rate_limited »). La réponse porte X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Window et Retry-After — attends la fenêtre indiquée : un retry immédiat la prolonge. Les plafonds appliqués sont dans x-kaneme-rate-limits. Quand le refus vient d’un plafond PAR OPÉRATION (générer, créer un document ou un projet, déposer une source), ces nombres sont ceux de CETTE opération, pas ceux de la surface.
- `500`: Erreur interne.

---

[API](https://skmtc.dev/kaneme/apis/kaneme-api.md) · [All operations](https://skmtc.dev/kaneme/apis/kaneme-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kaneme/apis/kaneme-api/revisions/752895651cd0?raw)