概述
论文检测开放 API 让您一次接入即可获得 AI 率、相似度与参考文献检测三类能力。本文档覆盖鉴权、接口与回调的完整口径。
基础地址
所有接口以下述前缀开头；业务响应的 HTTP 状态码恒为 200，以响应体 code 判断业务结果（code=0 成功）。唯一例外是触发频率限制时返回 429（附 Retry-After），便于客户端与网关按标准语义自动退避。
鉴权概览
所有接口走 HMAC-SHA256 共享密钥签名。平台为机构下发 appSecret（共享密钥），双方用同一密钥签名与验签；每次请求携带 4 个签名头。详见「签名机制」。
接口一览
/api/open/v1/tasks/submit提交检测任务（application/json）。公共字段（outTradeNo/checkType/title 必传，callbackUrl/sandbox 可选）在顶层，类型专属参数收在 payload 子对象：相似度/AI 传 payload.fileBase64 或 payload.fileUrl（相似度支持 .pdf/.docx/.doc，AI 率另支持 .txt，单份 ≤25MB，正文可读文本 ≥500 字符）+ payload.fileName；参考文献检测传 payload.citations 引文数组（字符串数组，≤300 条）。成功返回 taskNo。
/api/open/v1/tasks/query/{taskNo}查询任务状态与结果。status：1 待处理 / 2 处理中 / 3 成功 / 4 失败 / 5 已取消（失败后经平台取消并退费，终态）；score 含义随 checkType（AI 率 / 重复率 / 参考文献核验得分）。任务成功且报告已生成时，downloadUrl 直接给出离线 PDF 预签名下载地址（10 分钟有效，未完成为 null；地址过期再查一次即得新地址）；报告自任务完成起保留 10 天，超期后 downloadUrl 恒为 null，请及时下载存档。
/api/open/v1/tasks/online/{taskNo}获取在线报告查看地址。返回一个可直接在浏览器打开查看的在线报告 URL；在线报告未就绪时返回 report_not_ready(2015)。
/api/open/v1/tasks/aidetail/{taskNo}获取 AI 检测明细（在线报告右侧「可疑表述」面板的同一份数据），供贵方在自有页面渲染，无需打开在线报告页。返回三部分：text 正文、segments 逐段判定、phrases 可疑表述清单。数据取自该次检测已生成的结果，可反复拉取，不重复计费。仅 AI 率检测（checkType=1）提供，其他类型返回 2012；任务未成功、明细未生成或已过 10 天保留期返回 2015。
/api/open/v1/balance查询机构预存信用点余额。返回当前余额（提交任务前可据此判断额度是否充足）。