mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
Ethan Palm
33 lines
1.2 KiB
Plaintext
33 lines
1.2 KiB
Plaintext
---
|
|
title: "Detect AI-sounding prose"
|
|
openapi: /admin-openapi.json POST /v1/deslop/{projectId}
|
|
keywords: ["deslop", "AI detection", "slop", "prose", "content quality"]
|
|
---
|
|
|
|
This endpoint analyzes a documentation page for AI-generated prose and returns flagged passages with suggested human rewrites.
|
|
|
|
Authenticate with an [admin API key](/api/introduction#admin-api-key).
|
|
|
|
## Credits
|
|
|
|
- Consumes 1 AI credit per checked page.
|
|
- The endpoint skips pages under 50 words and does not charge for them. The response returns `skipped: "too_short"` with `creditsCharged: 0`.
|
|
- If detection is temporarily unavailable, the endpoint returns `503` and doesn't consume a credit.
|
|
- The endpoint accepts up to 30 requests per minute per client IP address.
|
|
|
|
## Response
|
|
|
|
Checked pages return a verdict (`predictionShort`), AI and human fractions, and a `windows` array of flagged passages. Each window includes a line range and can include one to three suggested rewrites.
|
|
|
|
## Usage
|
|
|
|
```bash
|
|
curl -X POST https://api.mintlify.com/v1/deslop/{projectId} \
|
|
-H "Authorization: Bearer mint_xxxxx" \
|
|
-H "Content-Type: application/json" \
|
|
-d '{
|
|
"path": "guides/quickstart.mdx",
|
|
"content": "# Quickstart\n\nWelcome to our comprehensive documentation..."
|
|
}'
|
|
```
|