mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
802368c3e2
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
39 lines
1.3 KiB
Plaintext
39 lines
1.3 KiB
Plaintext
---
|
||
title: "检测 AI 风格的文本"
|
||
openapi: /zh/admin-openapi.json POST /v1/deslop/{projectId}
|
||
keywords: ["deslop", "AI 检测", "slop", "文本", "内容质量"]
|
||
---
|
||
|
||
此端点分析文档页面中是否存在 AI 生成的文本,并返回被标记的段落以及建议的人类风格改写。
|
||
|
||
使用[管理员 API 密钥](/zh/api/introduction#admin-api-key)进行身份验证。
|
||
|
||
<div id="credits">
|
||
## 积分
|
||
</div>
|
||
|
||
- 每检查一个页面消耗 1 个 AI 积分。
|
||
- 少于 50 个词的页面会被跳过,不计费。响应中会返回 `skipped: "too_short"`,且 `creditsCharged: 0`。
|
||
- 如果检测暂时不可用,端点会返回 `503`,不扣除积分。
|
||
- 该端点针对每个客户端 IP 地址每分钟最多接受 30 个请求。
|
||
|
||
<div id="response">
|
||
## 响应
|
||
</div>
|
||
|
||
已检查的页面会返回判定结果(`predictionShort`)、AI 撰写和人类撰写的比例,以及包含被标记段落的 `windows` 数组。每个 window 包含一个行号范围,并可包含一到三条建议的改写。
|
||
|
||
<div id="usage">
|
||
## 用法
|
||
</div>
|
||
|
||
```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..."
|
||
}'
|
||
```
|