Skip to main content
POST
检测页面中 AI 风格的文本
此端点分析文档页面中是否存在 AI 生成的文本,并返回被标记的段落以及建议的人类风格改写。 使用管理员 API 密钥进行身份验证。

积分

  • 每检查一个页面消耗 1 个 AI 积分。
  • 少于 50 个词的页面会被跳过,不计费。响应中会返回 skipped: "too_short",且 creditsCharged: 0
  • 如果检测暂时不可用,端点会返回 503,不扣除积分。

响应

已检查的页面会返回判定结果(predictionShort)、AI 撰写和人类撰写的比例,以及包含被标记段落的 windows 数组。每个 window 包含一个行号范围和建议的改写。

用法

授权

Authorization
string
header
必填

Authorization 请求头需要使用 Bearer 令牌。请使用管理员 API 密钥。这是仅供服务端使用的机密密钥。你可以在控制台的 API 密钥页面 中生成一个。

路径参数

projectId
string
必填

你的项目 ID。可从你的控制台中的 API keys 页面复制。

请求体

application/json
path
string
必填

页面的仓库相对路径,仅用于报告。

Minimum string length: 1
content
string
必填

要检查的页面的原始 MDX 或 Markdown 内容。

Minimum string length: 1

响应

页面已被检查,或因过短而被跳过。

path
string
必填

请求中传入的 path。

skipped
enum<string> | null
必填

页面被跳过的原因;如果页面已被检查则为 null。too_short 表示页面正文少于 50 个词,且未被计费。

可用选项:
too_short,
null
creditsCharged
integer
必填

本次请求扣除的 AI 积分数(被跳过时为 0)。

predictionShort
enum<string>

页面的整体判定结果。仅在页面已被检查时出现。

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

被识别为 AI 生成的页面比例(0-1)。

fractionAiAssisted
number

被识别为 AI 辅助的比例(0-1)。

fractionHuman
number

被识别为人类撰写的比例(0-1)。

windows
object[]

被标记的(非人类)段落。仅在页面已被检查时出现。