验证码识别 API 快速接入

接入 CaptchaOCR 需要完成账号验证、保存 API 密钥、上传图片和处理结果四步。以下提供首个 cURL 请求与 Python SDK 示例。

1. 创建账号和 API 密钥

注册后系统会创建一把以 ck_live_ 开头的 API 密钥。完整密钥只显示一次，请立即复制并保存在服务端；此后控制台仅显示密钥前缀。验证邮箱后才能试识别或购买积分。

2. 提交一张图片

curl -X POST https://captchaocr.cn/api/v1/recognize \
  -H "X-API-Key: ck_live_…" \
  -F "file=@captcha.png"

3. 处理识别结果

根据 accepted 判断结果是否达到置信度和长度条件。为 false 时仍可能返回 text，但不应直接将其视为可信结果；请按业务规则重试、拒绝或转人工处理。

注册账号需先验证邮箱。每次识别消耗 1 积分；余额不足时返回 402 insufficient_credits，请补充积分后再调用。未验证邮箱时返回 403 email_unverified。套餐和额度以定价页为准。429 表示超出请求频率限制，与积分余额无关。

4. Python SDK

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()

SDK 目前尚未发布到 PyPI，请从项目仓库安装：pip install -e .。仅调用远程 API 时无需安装本地推理引擎。Java、Go、Node.js 和 Rust 示例见语言接入示例。