需通过教育机构授权获取API权限，构造含Bearer Token的POST请求调用https://www.pigai.org/api/v2/check/ai接口，提交UTF-8文本并解析JSON响应中的total、details等字段，禁用浏览器直连，须经后端代理。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您希望将批改网的AI检测能力集成到自己的系统或脚本中，而非仅通过网页端手动提交，需调用其官方提供的检测接口。该接口接受文本输入并返回结构化检测结果（含总分、各维度评分及详细分析）。以下是完成API调用的具体步骤：
一、获取合法调用权限
批改网未公开开放注册式API服务，实际可用接口需通过教育机构合作授权或已接入的校内平台获取有效Token或临时密钥。部分高校教务系统已预置批改网检测模块，其后端调用即基于此接口。未经授权直接抓包或复用网页请求头可能触发风控拦截。
1、确认所在单位是否已与批改网签署教学服务协议；
2、联系学校教务处或信息化办公室，申请获取API访问白名单IP地址及授权Bearer Token；
3、若为开发者测试用途，可使用批改网公开示例中的模拟调用方式（如文档中提供的checkGTP2函数），但该方式仅限前端调试，不适用于生产环境。
二、构造合规HTTP请求
批改网AI检测接口采用标准POST方法，请求体为JSON格式，必须携带认证信息与待检文本。请求头需包含Content-Type和Authorization字段，否则返回401错误。
1、设置请求URL为https://www.pigai.org/api/v2/check/ai（以实际文档为准，此为典型路径）；
2、在Header中添加Authorization: Bearer {your_token}，其中{your_token}为上一步获取的有效令牌；
3、在Header中设置Content-Type: application/json；
4、在Body中提交JSON对象，结构必须包含text字段（纯文本内容，UTF-8编码，长度限制通常≤5000字符）及可选lang字段（值为"zh"或"en"）；
三、处理响应数据
成功调用后，接口返回标准JSON响应，含total（总分）、info（各子项得分说明）、details（逐句AI特征标记）等字段。响应状态码为200表示检测完成，非200需依据message字段排查原因。
1、检查HTTP状态码是否为200，否则记录error_code与message；
2、解析JSON响应，提取result.total字段作为最终AI生成概率得分；
3、若需定位高风险句段，遍历result.details数组，筛选ai_score > 0.8的sentence条目；
4、对result.info中每个键（如"logic_coherence"、"lexical_diversity"）对应值做归一化处理，用于生成可视化雷达图。
四、规避常见调用失败
高频失败源于请求签名失效、文本编码异常或跨域限制。批改网接口不支持浏览器直接发起CORS请求，必须经由后端代理转发，且原始请求头中的Origin、Cookie等字段不可透传。
1、禁用浏览器直接fetch调用，改用Node.js或Python后端服务中转；
2、确保text字段内不含控制字符（如\x00-\x08, \x0B, \x0C, \x0E-\x1F），建议执行text.replace(/[\u0000-\u0008\u000B\u000C\u000E-\u001F]/g, '')清洗；
3、若返回{"code":403,"msg":"invalid signature"}，说明Token过期或签名算法不匹配，需重新申请；
4、当响应体为空或含"data":null时，立即检查请求Body是否为合法JSON字符串，而非JSON对象字面量。
五、本地模拟验证方式
在无法获取正式Token时，可借助批改网网页端已加载的全局函数进行轻量级验证。该方式依赖页面上下文，仅适用于Chrome DevTools控制台临时调试，不可用于自动化流程。
1、打开批改网作文提交页，确保已登录且文本框中填入待测内容；
2、在Console中粘贴并执行const testText = "您的待测英文段落"; checkGTP2(testText, function(res){console.log(res);});；
3、观察控制台输出的res.total值，该数值与网页端显示的AI检测总分一致；
4、注意该函数调用会触发真实检测请求，同一文本1小时内不可重复调用超3次，否则IP将被临时限制。
