---
title: "Émet le certificat PUBLIC d’un document (« ce texte signe ma voix »)"
method: POST
path: "/api/v1/certify"
tags: ["Mesure"]
---

# Émet le certificat PUBLIC d’un document (« ce texte signe ma voix »)

`POST /api/v1/certify`

## Request

- Base URL: `https://kaneme.com`
- URL: `https://kaneme.com/api/v1/certify`
- Auth: HTTP bearer

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `documentId` string, required: Document à certifier.
  - `displayName` string: Nom affiché sur le certificat.

## Response `200`

Succès.

- CertificatePublished
  - `ok` true, required
  - `token` string, required
  - `path` string, required
  - `certificateUrl` string, uri, required
  - `verificationUrl` string, uri, required
  - `badgeSvgUrl` string, uri, required
  - `badge` object, required
    - `band` 'signature' | 'plausible' | 'ambiguous' | 'foreign', required
    - `label` string, required
    - `claim` string, required
  - `calibrated` object, required
    - `author` object, required
      - `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
      - `label` string: Bande en clair, dérivée de `probability` pour la question posée : « 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.
      - `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.
      - `language` string
      - `score` number, required
      - `version` string, required
      - `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
    - `human` object, required
      - `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
      - `label` string: Bande en clair, dérivée de `probability` pour la question posée : « 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.
      - `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.
      - `language` string
      - `score` number, required
      - `version` string, required
      - `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
  - `creditsUsed` integer, required

## Other responses

- `400`: Requête invalide (champ manquant, borne dépassée, curseur illisible).
- `401`: Clé absente, invalide ou révoquée.
- `402`: Crédits insuffisants, OU surface non ouverte à ce compte. code = "subscription_required" : L’API et le MCP se paient en crédits, et ce compte n’en a plus. Recharge ton solde pour réactiver ta clé. code = "credits_exhausted" : lire `window` pour savoir quoi faire (recharger, attendre la période, demander à un admin de relever le budget, relever le plafond de la clé).
- `404`: Ressource introuvable.
- `409`: Conflit d’état ou de clé d’idempotence.
- `422`: Le moteur s’abstient ou le corpus est insuffisant.
- `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.
- `503`: Service ou compteur temporairement indisponible.

---

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