Skip to main content
POST
Détecter la prose qui sonne comme de l'IA dans une page
Cet endpoint analyse une page de documentation à la recherche de prose générée par IA et renvoie les passages signalés ainsi que des suggestions de réécriture au style humain. Authentifiez-vous avec une clé d’API admin.

Crédits

  • Consomme 1 crédit IA par page vérifiée.
  • Les pages de moins de 50 mots sont ignorées et non facturées. La réponse renvoie skipped: "too_short" avec creditsCharged: 0.
  • Si la détection est temporairement indisponible, l’endpoint renvoie 503 et aucun crédit n’est facturé.

Réponse

Les pages vérifiées renvoient un verdict (predictionShort), des fractions IA et humaine, ainsi qu’un tableau windows des passages signalés. Chaque fenêtre comprend une plage de lignes et une suggestion de réécriture.

Utilisation

Autorisations

Authorization
string
header
requis

L'en-tête Authorization requiert un jeton Bearer. Utilisez une clé d'API administrateur. Il s'agit d'une clé secrète côté serveur. Générez-en une depuis la page des clés d'API de votre Dashboard.

Paramètres de chemin

projectId
string
requis

L'identifiant de votre projet. Il peut être copié depuis la page Clés d'API de votre tableau de bord.

Corps

application/json
path
string
requis

Chemin de la page relatif au dépôt, utilisé uniquement pour le rapport.

Minimum string length: 1
content
string
requis

Le contenu MDX ou Markdown brut de la page à vérifier.

Minimum string length: 1

Réponse

La page a été vérifiée, ou ignorée parce qu'elle était trop courte.

path
string
requis

Le chemin fourni dans la requête.

skipped
enum<string> | null
requis

Raison pour laquelle la page a été ignorée, ou null lorsque la page a été vérifiée. too_short signifie que la page contenait moins de 50 mots de prose et n'a pas été facturée.

Options disponibles:
too_short,
null
creditsCharged
integer
requis

Crédits IA facturés pour cette requête (0 lorsque la page est ignorée).

predictionShort
enum<string>

Verdict global pour la page. Présent uniquement lorsque la page a été vérifiée.

Options disponibles:
AI,
AI-Assisted,
Human,
Mixed
fractionAi
number

Fraction de la page détectée comme générée par IA (0-1).

fractionAiAssisted
number

Fraction détectée comme assistée par IA (0-1).

fractionHuman
number

Fraction détectée comme rédigée par un humain (0-1).

windows
object[]

Passages signalés (non humains). Présent uniquement lorsque la page a été vérifiée.