AIGC 检测接口文档
一、接口概述
1.1 基本信息
-
请求域名：
https://xueshu.kuaisou.com -
请求地址：
/v1/aigc-api/ai/doDetect -
请求方法：POST
-
接口功能：接收用户输入文本，通过内置模型进行 AIGC 检测，判断文本是否由 AI 生成，并返回检测结果与相关信息。
1.2 适用场景
适用于内容审核、学术论文检测、创作辅助等场景，帮助用户快速识别文本的 AI 生成属性。
二、请求参数
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| userId | int | 是 | 用户唯一标识 ID，用于身份验证、权限控制及请求日志追踪 |
| text | string | 是 | 待检测的文本内容，长度建议不超过 10000 字符，需保证内容合法合规 |
| model | string | 否 | 检测模型名称，默认值为standard；未来可扩展更多模型（如高精度模型、快速检测模型） |
| api-key | string | 是 | 用于api-key进行请求aigc接口检测 |
三、请求示例
3.1 Python 示例
import requests
url = "https://xueshu.kuaisou.com/v1/aigc-api/ai/doDetect"
data = {
"text": "待检测的文本内容"
}
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer sk-Y**********************A"
}
response = requests.post(url, json=data, headers=headers)
print(response.json())
3.2 cURL 示例
curl -X POST "https://xueshu.kuaisou.com/v1/aigc-api/ai/doDetect" \
-H "Content-Type: application/json" \
-H "Authorization:Bearer sk-Y**********************A" \
-d '{
"text": "待检测的文本内容"
}'
四、响应参数
| 字段 | 类型 | 说明 |
|---|---|---|
| data | Object | 主数据对象 |
| └─ model | String | 模型类型（值为 "standard"） |
| └─ details | Object | 详细信息对象 |
| │ └─ paragraph_result | Array[Object] | 段落结果数组（包含评分和内容） |
| │ └─ rate | Number | 段落评分（值为 16） |
| │ └─ content | String | 段落具体内容（包含目标、注意事项、用户输入等文本） |
| │ └─ ai_rate | Number | AI 评分（值为 16） |
| │ └─ user_quota | Object | 用户配额信息对象 |
| │ └─ is_vip | Boolean | 是否为 VIP 用户（值为 false） |
| │ └─ daily_quota | String | 每日总配额（值为 "50"） |
| │ └─ daily_left | Number | 每日剩余配额（值为 49） |
| │ └─ daily_used | Number | 今日已使用配额（值为 1） |
| │ └─ daily_free | Number | 每日免费配额（值为 50） |
| │ └─ daily_paid | Number | 每日付费配额（值为 500） |
| └─ timestamp | String | 时间戳（格式：YYYY-MM-DD HH:mm:ss） |
| errcode | Number | 错误码（值为 0 表示成功） |
| errmsg | String | 错误信息（值为 "检测成功"） |
| request_id | Null | 请求 ID（未提供时为 null） |
| traceId | String | 追踪 ID（唯一标识请求链路） |
| debug | Array | 调试信息数组（当前为空数组） |
说明：
-
使用 └─ 符号表示子级关系，缩进体现层级嵌套（每级缩进 4 个空格）。
-
类型 列标注 JSON 数据类型（如 Object、Array、String 等）。
-
说明 列补充字段的具体含义或取值示例。
五、响应示例
5.1 成功响应
{
"data": {
"model": "standard",
"details": {
"paragraph_result": [
{
"rate": 6,
"content": "1946年，世界上第一台通用计算机“ENIAC”在美国宾夕法尼亚大学诞生；“ENIAC”占地170平方米，重达30吨，耗电功率约150千瓦，每秒钟可进行5000次运算，这个庞然大物用于美国国防部进行弹道计算。"
},
{
"rate": 14,
"content": "在当时，计算机只是被用于了特殊部门。现如今已过60余年，人类在计算机发展进程中越走越远，技术的发展使价格越加便宜，体积也更加便于携带，计算机随之出现在了各行各业之中。在第47期《中国互联网络发展状况统计报告》中提到，截至2020年12月，中国网民数量达到9.89亿，互联网普及率达到70.4％，如此多的用户必然有着巨大的商业市场，所需要的计算机应用程序也越加多样，那么创造这些计算机应用程序就需要进行程序编写。"
},
{
"rate": 32,
"content": "在计算机中，编写程序需要使用计算机编程语言，由于种类及针对性不同，计算机语言存在上百种，那对于目前日益复杂的办公需求，到底什么语言才可以提高我们的办公效率呢？如今有了一个答案，这个热门的语言叫做 python，python 拥有着众多的第三方库，或者说这些库就是已经实现好的功能，正等着你去使用它，完成你需要的定制功能；我们只需要学会 python 基础语法，既可以在办公中提高自己的工作效率。"
},
{
"rate": 0,
"content": "————————————————"
},
{
"rate": 4,
"content": "版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。"
}
],
"ai_rate": 15,
"user_quota": {
"is_vip": false,
"daily_quota": "50",ss
"daily_left": 48,
"daily_used": 2,
"daily_free": 50,
"daily_paid": 500
}
},
"timestamp": "2025-06-03 14:12:36"
},
"errcode": 0,
"errmsg": "检测成功",
"request_id": null,
"traceId": "1e5460e6958c99f5a116314b5446b5c82e8e427faa3110f8e7d44a42dc7a5e28",
"debug": []
}
5.2 失败响应
5.2.1 参数验证失败
{
"request_id": null,
"code": 422,
"traceId": "9723c2f14835fc836765ce0542904ddfdbb085605bbc631edea2ca1f5c51995a",
"msg": "参数验证失败: 检测文本不能为空",
"debug": []
}
5.2.2 检测服务不可用
{
"code": 503,
"msg": "检测服务当前不可用，请稍后重试",
"data": []
}
六、错误码说明
| 错误码 | 错误信息 | 可能原因及解决建议 |
|---|---|---|
| 0 | 降重成功 | 正常返回结果，解析data字段获取详细信息 |
| 401 | 参数验证失败 | 检查请求参数是否完整、格式正确，确保API-KEY是正确无误得 |
| 500 | 无可用套餐 | 请您先去官方网站购买套餐之后在调取此接口 |
| 503 | 服务不可用 | 服务可能处于维护中或出现临时故障，请确保您已购买套餐稍后重试；若持续不可用，联系技术支持排查问题 |
| 其他 | 降重处理失败 | 根据msg提示排查问题，如网络异常、服务器内部错误；可尝试重新请求或联系技术支持解决 |
七、注意事项
-
数据安全：请求中的text字段可能包含敏感信息，请确保在传输过程中使用 HTTPS 协议，并对敏感数据进行加密处理。
-
频率限制：为避免服务过载，并发每分钟调用次数上限为 5 次，超出限制将返回错误，建议合理控制调用频率。
-
模型更新：model参数对应的检测模型可能会不定期更新优化，建议定期查看文档获取最新模型配置及说明。
-
结果解释：检测返回只是参考指标，并非绝对判定依据，建议结合业务场景设定合理阈值进行判断。
- 错误处理：针对服务异常错误，建议在业务逻辑中添加重试机制，设置合理的重试间隔和次数，提升系统稳定性。