Skip to main content
POST
Check page for AI-sounding prose
此端点会扫描 MDX 或 Markdown 页面中读起来像 AI 生成的文案,并返回按行号定位的被标记段落,同时可选地给出人类风格的改写建议。可用于在内容上线前捕获 AI 起草的内容,或从 CI 流水线或内部工具中运行与 mint deslop CLI 相同的检查。 评分前会去除 frontmatter、围栏代码块和行内代码,因此仅对文案本身进行分析。

积分

每次对一个页面评分会从与 AI 助手共享的 AI 积分池中扣除 1 个 AI 积分。少于 50 个词的页面会在积分检查之前被免费跳过 (skipped: "too_short")。

使用方法

授权

Authorization
string
header
必填

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 in your dashboard.

路径参数

projectId
string
必填

Your project ID. Can be copied from the API keys page in your dashboard.

请求体

application/json
path
string
必填

Identifier for the page being checked. Echoed back in the response and used to key results when checking multiple pages.

Minimum string length: 1
content
string
必填

Raw MDX or Markdown content of the page. Frontmatter, code blocks, and inline code are stripped before scoring so only prose is analyzed.

Maximum string length: 1000000

响应

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.

path
string

Echo of the path from the request.

skipped
string | null

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
enum<string>

Short label for the overall verdict. One of Human, AI-Assisted, Mixed, or AI.

可用选项:
Human,
AI-Assisted,
Mixed,
AI
fractionAi
number

Fraction of prose (0-1) that reads as fully AI-written.

fractionAiAssisted
number

Fraction of prose (0-1) that reads as AI-assisted.

fractionHuman
number

Fraction of prose (0-1) that reads as human-written.

windows
object[]

Flagged passages with line ranges from the original page and optional rewrite suggestions.

creditsCharged
integer

AI credits charged for this request. 1 for scored pages, 0 for skipped pages.