教程 03

Python 验证码识别 SDK

CaptchaOCR Python SDK 提供同步、异步远程客户端和进程内识别模式。远程调用使用 API 密钥；本地模式需要安装推理引擎。

Python SDK 目前尚未发布到 PyPI，请从项目仓库安装。仅作为远程 API 调用方使用时，无需安装本地推理引擎：

pip install -e .

远程客户端

from captcha_ocr.sdk import CaptchaOcrClient

with CaptchaOcrClient("https://captchaocr.cn", api_key="ck_live_…") as client:
    result = client.recognize("captcha.png", expected_length=4)
    if result.accepted:
        use(result.text)
    else:
        retry_flow()

在 asyncio 异步程序中请使用 AsyncCaptchaOcrClient；同步客户端不适合直接在事件循环中调用。

进程内

from captcha_ocr.sdk.local import LocalOcrEngine

with LocalOcrEngine() as engine:  # 需要 pip install -e ".[engine]"
    print(engine.recognize("captcha.png").require())

远程客户端通过 HTTP API 调用服务，会受请求频率和账户积分限制；本地模式直接运行推理，不涉及 API 配额、积分或服务状态探针。远程调用积分不足时会抛出 InsufficientCreditsError，补充积分后再重试，不要按服务器错误循环重试。

需要自行发送 HTTP 请求时，可使用 Python requests 调用示例。参数范围和返回字段见验证码识别 API 参考。