AI 检测明细

GET/api/open/v1/tasks/aidetail/{taskNo}

获取 AI 检测明细（在线报告右侧「可疑表述」面板的同一份数据），供贵方在自有页面渲染，无需打开在线报告页。返回三部分：text 正文、segments 逐段判定、phrases 可疑表述清单。数据取自该次检测已生成的结果，可反复拉取，不重复计费。仅 AI 率检测（checkType=1）提供，其他类型返回 2012；任务未成功、明细未生成或已过 10 天保留期返回 2015。

请求头

以下签名头对所有开放 API 通用，缺失或不合法将验签失败。

名称	说明
`X-App-Id`	应用标识，平台为机构分配的 App ID。
`X-Timestamp`	毫秒级时间戳；与服务器时间偏差须在 ±300 秒内。
`X-Nonce`	一次性随机串，10 分钟内不可重复，用于防重放。
`X-Signature`	对待签内容做 HMAC-SHA256（密钥为 appSecret）后的 Base64 签名值。

路径参数

名称	类型	必填	说明
`taskNo`	`string`	是	任务号，提交接口返回的 taskNo。

响应示例

JSON

{ "code": 0, "codeMsg": "success", "data": {
  "taskNo": "20260718abc2nbausre",
  "text": "……平台从文件中解析出的正文全文，所有 start/end 均相对此文本……",
  "summary": { "ai": 53.42, "human": 46.58 },
  "segments": [
    { "start": 0, "end": 7967, "classification": 1, "probability": 0.4447 },
    { "start": 7967, "end": 19115, "classification": 2, "probability": 0.7111 }
  ],
  "phrases": [
    { "start": 15429, "end": 15453, "ai": 92.89, "human": 0.32, "proportion": 290.28, "text": "offering a more nuanced" }
  ] } }

响应字段

名称	类型	说明
`taskNo`	`string`	任务号，机构后续查询与取报告的凭据。
`text`	`string`	平台从您的文件中解析出的正文。下方所有 start/end 都是它的字符下标（按 UTF-16 计），与您上传的原文件对不上，要高亮请渲染本字段。
`summary.ai`	`number`	AI 生成占比，0~100 两位小数，与查询接口的 score 同值。
`summary.human`	`number`	人工撰写占比，0~100 两位小数。
`segments`	`object[]`	逐段判定：正文分成几大段，用于看哪一章整体可疑。段落不含正文，按 start/end 从 text 截取。
`segments[].start / end`	`int`	该段在 text 中的起止下标（左闭右开）。
`segments[].classification`	`int`	1=人工撰写，2=AI 生成。
`segments[].probability`	`number`	该段判定的置信度 0~1，不是 AI 占比。
`phrases`	`object[]`	可疑表述清单，按可疑程度降序。在线报告右侧面板展示的就是它。
`phrases[].start / end`	`int`	该表述在 text 中的起止下标（左闭右开）。
`phrases[].ai / human`	`number`	该表述每百万篇文档中的出现次数：ai 为 AI 生成文本中的次数，human 为人类撰写文本中的次数。不是概率。
`phrases[].proportion`	`number`	ai 是 human 的多少倍，越大越可疑；-1 表示 human 为 0（倍数无穷大）。
`phrases[].text`	`string`	该表述原文。只做列表展示可直接用，无需处理下标。

可能的错误码

错误码	说明
`1401`	参数缺失或不合法
`1429`	请求过于频繁（负载限流，HTTP 429）
`1449`	系统繁忙，请稍后再试
`2001`	验签失败
`2002`	时间戳超窗
`2003`	重复请求
`2004`	应用不存在或已停用
`2005`	来源IP未授权
`2012`	不支持的检测类型
`2014`	任务不存在
`2015`	报告尚未生成

查看完整错误码列表 →