两类检测能力，一套接口
文本与图片共用同一套鉴权、提交、查询与计费机制，差别只在请求参数与返回结果的结构。 响应里的 provider 字段会标明本次调用的是哪一项能力。
怎么接入
- 1
创建 API Key
注册后在用户中心创建密钥。密钥只在创建时完整显示一次，请自行保存。
- 2
提交检测任务
POST 到文本或图片接口，带上 Idempotency-Key 请求头，立即返回 task_id。
- 3
轮询取结果
GET /v1/tasks/{task_id}，间隔建议不小于 1 秒，直到 status 变为 succeeded 或 failed。
提交类接口必须携带 Idempotency-Key：提交即扣费，重试时复用同一个键会直接返回原任务，不会重复扣费；每次换新键则等于重新提交一次。
# 1. 提交检测任务（提交即扣费，务必携带 Idempotency-Key）
# 幂等键任意 <=64 字符的随机串即可。这里读内核提供的 UUID，不用 uuidgen ——
# 它属于 uuid-runtime 包，最小化安装的 Debian/Ubuntu 上默认没有。
# is_merge=false 让每个段落独立出置信度（分段检测）；省略或 true 则合并为整体判定
curl -X POST https://your-domain.com/v1/text/classify \
-H "Authorization: Bearer sk-zq-你的密钥" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(cat /proc/sys/kernel/random/uuid)" \
-d '{"text":"这是一段待检测的文本","is_merge":false}'
# 2. 用返回的 task_id 轮询结果（pending / running / succeeded / failed）
curl https://your-domain.com/v1/tasks/<task_id> \
-H "Authorization: Bearer sk-zq-你的密钥"{
"code": "ok",
"data": {
"task_id": "01J8Z9K3M7X2Q4R6T8V0W1Y5BC",
"provider": "zhuque-text",
"status": "succeeded",
"cost": "0.0600",
"result": {
"status": "success",
"softmax_confidence": 0.9987,
"ratio_confidence": 0.9821,
"labels_ratio": { "0": 0.35, "1": 0.65 },
"segment_labels": [
{
"text": "前半段人工撰写的内容",
"label": 0,
"conf": 0.0121,
"order": 1,
"position": [0, 10]
},
{
"text": "后半段由模型生成的续写",
"label": 1,
"conf": 0.9976,
"order": 2,
"position": [10, 11]
}
]
},
"error_code": null,
"error_msg": null,
"latency_ms": 1832,
"created_at": "2026-10-10T15:32:14+08:00",
"finished_at": "2026-10-10T15:32:16+08:00"
}
}segment_labels[].position 是 [start, length]：第二项是段长（按 Unicode 字符计），不是结束下标。
计费方式
| 检测类型 | 计价单位 | 单价 | 最低收费 |
|---|---|---|---|
| AI 图片检测 | 每张 | ¥0.05 | ¥0.05 |
| AI 文本检测 | 每 1000 字 | ¥0.06 | ¥0.06 |
金额制（元），提交时按实际用量扣费，每次调用有最低收费封底。请求未被受理（触发限流、参数有误等） 会自动全额退款；已进入检测流程后失败的（如超时、上游异常）不退款，是否退款以资金流水里的记录为准。
常见问题
AIGC 检测 API 是什么？+
AIGC 检测 API 是一种通过 HTTP 接口判断内容是否由 AI 生成的程序化服务。本站底层接入腾讯朱雀检测模型的 zhuque-text（文本）与 zhuque-image（图片）两项能力，对外提供统一的提交、查询、鉴权与计费接口，供网站、APP、SaaS 与各类开发者系统调用。
本站和腾讯官方是什么关系？+
本站是独立的第三方接口服务，不是腾讯官方产品，也不代表官方。我们接入的是腾讯朱雀的 AIGC 检测能力，在此基础上自行实现了 API Key 鉴权、异步任务排队、按量计费与用量查询。你不需要自行开通和对接腾讯云，注册后创建 API Key 即可调用。
和直接对接上游云服务相比，用这个服务有什么不同？+
差别在接入成本与计费方式：本站把上游的同步/异步两种调用方式收敛成统一的异步任务模型，提交即返回 task_id，由服务端负责排队、重试与超时判定，调用方只需要轮询一个接口；同时提供按量计费、幂等去重（重试不会重复扣费）、未受理自动退款和用量明细。如果你的业务需要的是「按量付费、不自己维护对接」的检测能力，这个形态更省事。
怎么调用？+
三步：一、注册后在用户中心创建 API Key；二、带 Idempotency-Key 请求头 POST 提交任务，拿到 task_id；三、轮询 GET /v1/tasks/{task_id} 直到 status 变成 succeeded 或 failed。提交类接口必须带幂等键，因为它决定了重试时会不会重复扣费。
支持哪些编程语言？+
接口是标准的 HTTP + JSON，任何能发 HTTP 请求的语言都可以调用，不依赖特定 SDK。文档里提供了 cURL、Python、Node.js、Go 四种语言的完整示例（含提交与轮询）。
怎么收费？有免费额度吗？+
金额制（元），按实际用量扣费：文本按千字、图片按张，每次调用有最低收费封底，具体单价见价格区与接口文档的计费表。注册即赠体验金，可以先把全流程跑通再充值。请求未被受理（触发限流、参数有误等）会自动全额退款。
检测结果能作为最终判定依据吗？+
不建议。返回的是模型给出的概率判断（置信度），不是事实认定，任何 AI 检测服务都存在误判可能。合理用法是把它作为初筛信号：高置信度结果结合人工复核，或作为多路证据之一。用它直接做出处分、拒稿、封号这类不可逆决定，风险由调用方承担。
相关页面
注册即赠体验金，先把全流程跑通再充值