API REST v1

Deux nombres, deux questions

/score mesure une fidélité de style : ce texte sonne-t-il travaillé et personnel ? Il ne dit pas qui a écrit — un texte de quelqu'un d'autre peut obtenir 90. /verify répond à la question d'auteur, et rend une probabilité calibrée plutôt qu'un score : question="q1" (ta voix vs celle de l'IA, la mesure principale, posée par défaut quand question est omise) ou question="q2" (toi vs un autre humain, mesuré seulement si tu le demandes ; lecture indicative en français, signature au-dessus du seuil scellé en anglais). Un même score ne vaut pas la même probabilité selon la question. Comparée à des imitations IA des auteurs du banc, réalisées à partir de leurs textes de référence.

C'est un indice, jamais une preuve opposable : face à un texte machine retravaillé pour passer, le moteur servi n'a pas encore été remesuré, et on ne recopie pas le chiffre de l'ancien (détail sur /methode).

Sur q2, la réponse porte aussi explanation : quatre écarts observés — cadence, registre, structure et lexique. Chaque facteur donne une direction lisible, jamais un sous-score causal. Ces observations éclairent la décision ; elles ne décomposent pas la probabilité produite surtout par la couche profonde.

Écrire, ou améliorer ce qui existe déjà

/generate PART d'un sujet et rédige dans ta voix. /improve PART d'un texte déjà écrit — celui que ton agent vient de produire — et le réécrit dans ta voix : « améliore ce contenu avec ma voix ». C'est une passe corrective bornée (elle corrige les défauts constatés, préserve le fond et la longueur) et renvoie le texte + le score avant/après. Rien à corriger ? Le texte revient inchangé, sans débit.

/compare répond à « ce texte est-il de la même main que celui-ci ? » contre une référence que TU fournis — un autre auteur collé, ou une autre de tes voix. Même honnêteté que /verify : probabilité calibrée, abstention si la mesure ne tranche pas, plancher hors de ton genre.

Le Coffre — et pourquoi une preuve s'atteste

Deux endroits différents, à ne pas confondre : /sources nourrit la mémoire d'un projet (ce dont tu parles), et /voice/assets est le Coffre d'une voix : ce avec quoi tu étayes tes idées.

kind est requis et fermé (preuve · cas_client · temoignage · resultat · histoire) — c'est lui qui distingue une preuve d'une note. Sur les quatre types de preuve, provenance:"human" est exigée : cette matière sera citée comme vérifiable, donc elle doit être réelle. Un agent n'invente pas un cas client à ta place.

Tes convictions et tes sous-voix se lisent, mais ne s'écrivent pas depuis l'API : une conviction posée par un agent n'est pas une conviction, et activer une sous-voix change tous tes textes sur ce canal. Ces deux gestes restent les tiens, dans l'app.

Créer une voix — et pourquoi la provenance compte

POST /api/v1/voices compile une nouvelle voix depuis de vrais textes déjà écrits, 100 mots au moins. Ils deviennent la cadence de référence de la voix, réinjectée à chaque génération. Un entretien ne crée pas de voix : sous 100 mots, demande davantage de textes.

L'appel exige provenance:"human". Ce n'est pas une formalité : une voix ancrée sur de l'IA n'est plus ta voix, c'est une IA-en-voix qui se mesurerait elle-même. Un agent ne doit jamais y coller un texte qu'il vient de générer. Sans l'attestation, l'appel est refusé, pas dégradé en silence. L'ancien mode:"interview" est refusé de la même façon (samples_required).

Puis l'entretien. Les textes disent comment tu écris, pas pour qui, ni ce que tu défends ou refuses. POST /api/v1/voice/interview (interview_voice côté MCP) complète une voix qui existe, quand tu veux après sa création : avec le seul profileId, il rend les huit questions et l'état de la séance ; avec answers, il prépare une synthèse sans toucher la voix ; avec applyPreviewId et ownerApproved:true, il l'applique. C'est la même séance que dans l'app ; les convictions restent des propositions que tu confirmes toi-même. Gratuit.

Une voix = une langue. Chaque moteur ne mesure que la sienne : une voix écrit en français ou en anglais. Passe language:"fr" ou "en" pour la choisir, sinon elle est lue sur les textes. Un texte de l'autre langue — ou qui en porte une phrase entière — est refusé en 422, avant tout débit, avec les passages à corriger. Une citation entre guillemets ne compte pas : citer n'est pas changer de langue. Chaque voix rendue porte language et languageSource. Pour confirmer ou corriger la langue d'une voix existante — seule issue d'une ancienne voix mêlée (voice_language_required) — POST /api/v1/voice/language, avec ownerApproved:true : la langue est le choix de l'auteur.

Un projet, sa mémoire, sa preuve

/projects crée un projet relié à une voix ; /sources y verse ce que ton agent a trouvé (recherche web, notes) — le texte est vectorisé et récupéré ensuite par le RAG. Il suffit alors de passer projectId à /generate pour écrire en héritant de cette mémoire.

/certify émet la page publique d'un document — « ce texte signe ma voix ». Elle n'est délivrée que si la paternité est réellement mesurée et affirmée : sinon le certificat est refusé, sans débit. Le public ne voit qu'une bande (label + affirmation), jamais de score. À n'appeler que sur ta demande : ça publie.