提交任务

checkType 取值与各产品的稿件要求见检测产品类型

POST/api/open/v1/tasks/submitapplication/json

提交检测任务（application/json）。公共字段（outTradeNo/checkType/title 必传，callbackUrl/sandbox 可选）在顶层，类型专属参数收在 payload 子对象：文件类检测传 payload.fileBase64 或 payload.fileUrl（支持的格式与大小上限随 checkType，见下方「检测产品类型」）+ payload.fileName；参考文献风险检测传 payload.citations 引文数组（字符串数组，≤300 条），或传稿件（payload.fileBase64 或 payload.fileUrl，pdf/docx）由平台自动提取参考文献（两者都传以 citations 为准）。参考文献风险检测、论文工厂检测、图片查重与综合检测可附 payload.lang 指定报告语种。成功返回 taskNo。

请求头

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

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

请求体字段（JSON）

请求体为 application/json；公共字段为顶层键，类型专属参数收在 payload 子对象（文件以 base64 内联在 payload.fileBase64）。

名称		类型	必填	说明
`outTradeNo`		`string`	是	机构侧订单号，机构内唯一，≤36 字符；重复提交返回 2011。
`checkType`		`int`	是	数字检测类型码（必填），取值、各类型所需参数与稿件要求见下方「检测产品类型」。
`title`		`string`	是	稿件标题（必传，≤255 字符）。随任务落库，并作为提交给服务商的稿件标题。
`callbackUrl`		`string`	否	本单回调地址（可选），覆盖机构默认回调配置；长度 ≤255 字符，超长直接拒收。
`sandbox`		`boolean`	否	沙箱（测试）模式（可选，默认 false）：用于联调，不计费、不消耗信用点，返回示例报告；请求与响应格式同正式接口。
`payload`	`fileBase64`	`string`	否	payload.fileBase64：待检测文件字节的 Base64 字符串（内联在 JSON），文件类检测与参考文献风险检测（稿件代抽引文）用；与 fileUrl 二选一。支持的格式随 checkType（见下方「检测产品类型」），单份大小上限 25MB；需要正文的类型须能解析出 ≥500 字符，否则按 2018 拒收。
	`fileName`	`string`	否	payload.fileName：文件名（含扩展名，如 paper.pdf），配合 fileBase64 用于识别文件类型。
	`fileUrl`	`string`	否	payload.fileUrl：文件下载地址（http/https），平台服务端拉取，文件类检测用；与 fileBase64 二选一。支持的格式、大小上限与最少字符数同 fileBase64。
	`citations`	`string[]`	否	payload.citations：引文数组（参考文献风险检测，checkType=3），每项一条，≤300 条。也可改传 pdf/docx 稿件（fileBase64 或 fileUrl）由平台代抽引文，两者都传以引文为准；抽不到或不规范按 2018 拒收，不扣费。
	`lang`	`string`	否	payload.lang：报告语种（可选）：zh=中文（默认）、en=英文，不区分大小写；其他取值按 1401 拒收。适用于参考文献风险检测（3）、论文工厂检测（4）、图片查重（5）与综合检测（51/52，整份汇总报告按该语种出具）。其余检测类型忽略该字段。

检测产品类型

checkType	产品	说明
`1`	AIGC 文本检测	识别稿件中由 AI 生成或改写的文本，给出全文 AI 特征值。稿件要求：.pdf / .docx / .doc，≤25MB，正文 ≥500 字符
`3`	参考文献风险检测	逐条核验引文真实性，识别虚构/伪造、存疑、元数据矛盾与已撤稿文献。稿件要求：传引文数组（≤300 条），或 .pdf / .docx 稿件（≤25 MB）由平台代抽引文
`4`	论文工厂检测	筛查 AI 提示词残留、学术文本规范表述、ORCID 有效性、机构归属与 papermill 关联性。稿件要求：.pdf / .docx，≤25MB，正文 ≥500 字符
`5`	图片查重	检测稿件中图片的完全重复、局部复用与视觉相似。稿件要求：.pdf / .docx，≤25MB
`51`	综合检测（含图片）	一次提交完成参考文献风险、AIGC 文本、论文工厂、图片查重四项检测，交付一份汇总报告。稿件要求：.pdf / .docx，≤25MB，正文 ≥500 字符，须含参考文献章节
`52`	综合检测（不含图片）	一次提交完成参考文献风险、AIGC 文本、论文工厂三项检测，交付一份汇总报告。稿件要求：.pdf / .docx，≤25MB，正文 ≥500 字符，须含参考文献章节

提交参数：参考文献风险检测（3）传 payload.citations 引文数组（字符串数组，≤300 条），或传 pdf/docx 稿件由平台代抽引文（都传以引文为准）；其余产品均传 payload.fileBase64 或 payload.fileUrl（二选一）+ payload.fileName。参考文献风险检测、论文工厂检测（4）、图片查重（5）与综合检测（51/52）可附 payload.lang 指定报告语种。
结果 score：AIGC 文本检测为 AI 特征值（0~100），参考文献风险检测为核验得分；其余产品不返回分值，结果见报告。
更多检测产品持续开放中，如需开通其他产品，请联系商务对接。

请求体示例

JSON

{
  "outTradeNo": "OT20260718001",
  "checkType": 2,
  "title": "论文标题",
  "payload": {
    "fileName": "paper.pdf",
    "fileBase64": "JVBERi0xLjcK…（文件字节的 Base64）"
  }
}

响应示例

JSON

{ "code": 0, "codeMsg": "success", "data": { "taskNo": "20260718abc2nbausre" } }

响应字段

名称	类型	说明
`taskNo`	`string`	任务号，机构后续查询与取报告的凭据。
`sandbox`	`boolean?`	是否为沙箱（测试）任务。

可能的错误码

错误码	说明
`1401`	参数缺失或不合法
`1429`	请求过于频繁（负载限流，HTTP 429）
`1449`	系统繁忙，请稍后再试
`2001`	验签失败
`2002`	时间戳超窗
`2003`	重复请求
`2004`	应用不存在或已停用
`2005`	来源IP未授权
`2006`	信用点余额不足
`2011`	订单号重复
`2012`	不支持的检测类型
`2013`	文件缺失或不合法
`2016`	文件拉取失败
`2017`	检测类型未开通
`2018`	文件可读文本不足 500 字符（疑似扫描件/加密/损坏）

查看完整错误码列表 →