SDK 与代码示例

官方 SDK

目前唯一的第一方 SDK。安装与用法见 Python SDK 专页，这里给出最快路径：

Python已发布

aigc-detect

提交、自动轮询、幂等重试与错误分类的完整封装，MIT 开源，Python 3.8+，仅依赖 requests。

pip install aigc-detect

PyPI 包页 →GitHub 仓库 →

不用 SDK，直接调 HTTP

接口就是普通的 REST HTTP：提交（POST）返回 task_id，轮询（GET）直到终态。以下示例覆盖文本检测的完整流程，图片检测只是换接口与入参—— 各语言的详细参数见接口文档。

# 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 字符计），不是结束下标。

无论用哪种语言，两条规则不变：提交类接口必须携带 Idempotency-Key（重试时复用同一个值，否则重复扣费）；轮询超时后不要重新提交，拿 task_id 继续查询即可。用 Python SDK 时这两条由 SDK 自动处理。

常见问题

目前有哪些官方 SDK？+

Python：aigc-detect，已发布到 PyPI，源码托管在 GitHub，安装命令 pip install aigc-detect。其他语言暂时没有官方 SDK——但接口是普通的 REST HTTP，任何支持 HTTP 的语言都能直接调用，本页下方提供了 cURL / Python / Node.js / Go 四种语言的调用示例。

SDK 本身收费吗？+

SDK 是 MIT 协议的开源代码，免费使用。检测本身按量计费（文本按千字、图片按张），费用产生在 API 调用上，与是否使用 SDK 无关。

用 SDK 和直接调 HTTP 接口有区别吗？+

功能上没有区别，SDK 只是把提交后的轮询循环、幂等键的生成与重试复用、错误码到异常类型的映射封装好了。自己调 HTTP 也完全可以做到同样的事——幂等键在重试时复用同一个值、轮询超时后不要重新提交而是继续查询，这两条是所有语言接入时都要遵守的规则，无论用不用 SDK。

遇到问题去哪里反馈？+

SDK 的使用问题（安装失败、异常行为）提到 GitHub 仓库的 Issues；接口本身的问题（错误码含义、计费疑问、结果字段口径）以本站接口文档为准，可在文档页查看错误码与退款规则。

官方 SDK

不用 SDK，直接调 HTTP

常见问题

相关页面