Python SDK

安装

pip install aigc-detect

支持 Python 3.8+，仅依赖 requests。密钥在 用户中心 创建（形如 sk-zq-…），注册即有体验金。

想先验证 SDK 行为再接入：clone 仓库后 pip install -e .，再跑 python -m unittest discover -s tests -v——单元测试全部 mock 网络，不需要密钥与余额。

快速开始

文本与图片各一次调用，SDK 自动提交并轮询到出结果。字段语义（labels_ratio 的标签占比、 position 是段长不是结束下标）见 文本检测专题页。

from aigc_detect import AigcDetectClient

client = AigcDetectClient(api_key="sk-zq-你的密钥")

# 文本检测：自动轮询到出结果，无需手写 while 循环
task = client.detect_text("把待检测的文本粘在这里，支持中英文混排。", is_merge=False)
result = task.text_result()

print(f"整体 AI 置信度: {result.softmax_confidence}")
print(f"标签占比: {result.labels_ratio}")   # "0" 人工 / "1" AI / "2" 疑似 AI
for seg in result.segment_labels:
    start, length = seg.position          # [起始位置, 段长]
    print(f"[{seg.label_name}] {seg.text}")

# 图片检测：image_url 与 image_base64 二选一
task = client.detect_image(image_url="https://example.com/a.png")
print(task.image_result().confidence)      # AI 生成置信度

方法一览

文本上限 20000 字符（按 Unicode 字符计）；图片需大于 300×300 像素且不超过 10MB， 支持 jpg / png / webp——与直接调 HTTP 接口的限制一致，见 接口文档。

错误处理

错误码映射为异常类型，按业务场景分别捕获。最关键的一条：轮询超时≠任务失败， 任务仍在服务端，继续查询即可。

from aigc_detect import (
    AigcDetectClient, TaskFailedError, TaskTimeoutError,
)

client = AigcDetectClient(api_key="sk-zq-你的密钥")

try:
    task = client.detect_text("待检测文本")
except TaskFailedError as e:
    print(e.task_id, e.code)               # 如 "timeout"，退款以资金流水为准
except TaskTimeoutError as e:
    ...                                     # 任务没丢：稍后 client.get_task(e.task_id)

# 不想让 failed 终态抛异常？传 raise_on_failure=False 自己处理

资源