> ## Documentation Index
> Fetch the complete documentation index at: https://tomee-mintlify-99ed5a6d.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Vérifier une page pour détecter la prose de style IA
> Scan an MDX page for AI-sounding prose and return line-mapped flagged passages with optional human-style rewrite suggestions. Pages under 50 words are skipped for free. Each checked page charges 1 AI credit from the shared AI credits pool used by the assistant.
Authenticate with an admin API key.
Ce point de terminaison analyse une page MDX ou Markdown à la recherche de prose qui semble générée par IA et renvoie les passages signalés avec leurs plages de lignes, ainsi que des suggestions optionnelles de réécriture au style humain. Utilisez-le pour repérer le contenu rédigé par IA avant qu'il n'atteigne la production, ou pour exécuter les mêmes vérifications que la CLI [`mint deslop`](/fr/cli/commands#mint-deslop) depuis un pipeline CI ou un outil interne.
Le frontmatter, les blocs de code délimités et le code en ligne sont supprimés avant l'évaluation, de sorte que seule la prose est analysée.
## Crédits
Chaque page évaluée consomme 1 crédit IA du pool partagé de crédits IA également utilisé par l'assistant. Les pages de moins de 50 mots sont ignorées gratuitement (`skipped: "too_short"`) avant la vérification des crédits.
## Utilisation
```bash theme={null}
curl -X POST https://api.mintlify.com/v1/deslop/{projectId} \
-H "Authorization: Bearer mint_xxxxx" \
-H "Content-Type: application/json" \
-d '{
"path": "docs/guide.mdx",
"content": "# Getting started\n\nWelcome to our platform..."
}'
```
## OpenAPI
````yaml admin-openapi.json POST /v1/deslop/{projectId}
openapi: 3.0.1
info:
title: Mintlify Admin API
description: >-
An API for administrative operations including documentation updates and
agent management.
version: 2.0.0
servers:
- url: https://api.mintlify.com
security:
- bearerAuth: []
paths:
/v1/deslop/{projectId}:
post:
summary: Check page for AI-sounding prose
description: >-
Scan an MDX page for AI-sounding prose and return line-mapped flagged
passages with optional human-style rewrite suggestions. Pages under 50
words are skipped for free. Each checked page charges 1 AI credit from
the shared AI credits pool used by the assistant.
Authenticate with an admin API key.
parameters:
- name: projectId
in: path
required: true
schema:
type: string
description: >-
Your project ID. Can be copied from the [API
keys](https://app.mintlify.com/settings/organization/api-keys) page
in your dashboard.
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- path
- content
properties:
path:
type: string
minLength: 1
description: >-
Identifier for the page being checked. Echoed back in the
response and used to key results when checking multiple
pages.
content:
type: string
maxLength: 1000000
description: >-
Raw MDX or Markdown content of the page. Frontmatter, code
blocks, and inline code are stripped before scoring so only
prose is analyzed.
responses:
'200':
description: >-
Page checked successfully. `skipped` is `null` for scored pages, or
a reason string (for example, `too_short`) when the page was not
scored. Scored pages include the AI-written fractions, per-window
flagged passages with line ranges, and any rewrite suggestions.
content:
application/json:
schema:
oneOf:
- type: object
properties:
path:
type: string
description: Echo of the `path` from the request.
skipped:
type: string
nullable: true
description: >-
Reason the page was skipped without scoring, such as
`too_short` when the page is under 50 words. `null`
when the page was scored.
predictionShort:
type: string
description: >-
Short label for the overall verdict. One of `Human`,
`AI-Assisted`, `Mixed`, or `AI`.
enum:
- Human
- AI-Assisted
- Mixed
- AI
fractionAi:
type: number
description: >-
Fraction of prose (0-1) that reads as fully
AI-written.
fractionAiAssisted:
type: number
description: Fraction of prose (0-1) that reads as AI-assisted.
fractionHuman:
type: number
description: Fraction of prose (0-1) that reads as human-written.
windows:
type: array
description: >-
Flagged passages with line ranges from the original
page and optional rewrite suggestions.
items:
type: object
properties:
text:
type: string
description: The flagged passage as it appears in the page.
label:
type: string
description: >-
Passage-level verdict (for example, `AI` or
`AI-Assisted`).
aiAssistanceScore:
type: number
description: >-
Score (0-1) indicating how AI-written the
passage is.
confidence:
oneOf:
- type: string
- type: number
description: Detector confidence for this passage.
startLine:
type: integer
description: >-
1-indexed start line of the passage in the
original page.
endLine:
type: integer
description: >-
1-indexed end line of the passage in the
original page.
rewrites:
type: array
description: Optional human-style rewrite candidates.
items:
type: object
properties:
text:
type: string
description: Suggested replacement prose.
rationale:
type: string
description: >-
Short explanation of why the rewrite reads
as more human.
creditsCharged:
type: integer
description: >-
AI credits charged for this request. `1` for scored
pages, `0` for skipped pages.
- type: object
description: Response shape when the page was skipped without scoring.
properties:
path:
type: string
skipped:
type: string
description: >-
Reason the page was skipped (for example,
`too_short`).
creditsCharged:
type: integer
description: Always `0` for skipped pages.
'400':
description: Invalid request body. The `path` and `content` fields are required.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: >-
Your organization is out of AI credits. Top up credits or upgrade
your plan and retry.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: Rate limit exceeded.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'503':
description: >-
The AI-prose detection service or quota service is temporarily
unavailable. No credits are charged. Retry with backoff.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
components:
schemas:
Error:
type: object
properties:
error:
type: string
description: Error message.
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: >-
The Authorization header expects a Bearer token. Use an admin API key.
This is a server-side secret key. Generate one on the [API keys
page](https://app.mintlify.com/settings/organization/api-keys) in your
dashboard.
````