打码服务 / 图片 OCR(ImageToText)

图片 OCR(ImageToText)

图像识别  ·  ImageToTextTaskMuggle

普通图形验证码:给一张图,返回图上的英文数字。

最基础的图像识别。把图片转成 Base64 传进来即可,带不带 data:image/png;base64, 前缀都行,网关会统一处理。

4 K d 9 x
最传统的图形验证码:一张带干扰线的图片,识别上面的字母数字。

请求

POST /v1/captcha/solve?timeout=180
Authorization: Bearer arp_xxx
Content-Type: application/json

请求参数

参数类型必填说明
typestring是固定填 ImageToTextTaskMuggle
bodystring是图片的 Base64(1MB 以内,建议先压到 200KB 以下)

只传上表列出的参数即可,认证由网关自动处理。

请求示例

{
  "type": "ImageToTextTaskMuggle",
  "body": "iVBORw0KGgoAAAANSUhEUgAAAKAAAAAyCAAAAAD+Co+5AAAA4klEQVR42u3YwRKDIAwEUD7dP6+dnhZKEhCQ1dnc6ET6zCAwSR/ySAIKKODTgQcEfQUZsRkwfSPGYlZtbPyRmZWKaATiOMcSAv1lQAbEX3vW7BZgDzaeq541DRjtBlTA9q2LAIiZ8Qc2FRjjvOVfrywREOdCLCUQx2Vl6YA4/lXUm9CetA23ZKMW8NXAvvPTR866lAko4NXLgoACuk/B7WYMOLIFZ1lHHtMqeB1YiOxz6zagXSP/YF0H/K9R/Bpr229mjbb1B5eIhoB3iPqAG0QBcL/IawEzdoHV5RdQQAEXxwn8FOsjAT8powAAAABJRU5ErkJggg=="
}

响应示例

{
  "ok": true, "ready": true, "price": 10, "balance": 920,
  "solution": { "text": "4Kd9x" },
  "text": "4Kd9x"
}
怎么取结果:取 text,或 solution.text。

完整调用

curl -X POST 'https://api.xiaobaicap.com/v1/captcha/solve?timeout=180' \
  -H "Authorization: Bearer arp_xxx" \
  -H 'Content-Type: application/json' \
  -d '{
         "type": "ImageToTextTaskMuggle",
         "body": "iVBORw0KGgoAAAANSUhEUgAAAKAAAAAyCAAAAAD+Co+5AAAA4klEQVR42u3YwRKDIAwEUD7dP6+dnhZKEhCQ1dnc6ET6zCAwSR/ySAIKKODTgQcEfQUZsRkwfSPGYlZtbPyRmZWKaATiOMcSAv1lQAbEX3vW7BZgDzaeq541DRjtBlTA9q2LAIiZ8Qc2FRjjvOVfrywREOdCLCUQx2Vl6YA4/lXUm9CetA23ZKMW8NXAvvPTR866lAko4NXLgoACuk/B7WYMOLIFZ1lHHtMqeB1YiOxz6zagXSP/YF0H/K9R/Bpr229mjbb1B5eIhoB3iPqAG0QBcL/IawEzdoHV5RdQQAEXxwn8FOsjAT8powAAAABJRU5ErkJggg=="
       }'
import requests

r = requests.post(
    "https://api.xiaobaicap.com/v1/captcha/solve",
    headers={"Authorization": "Bearer arp_xxx"},
    params={"timeout": 180},
    json={
  "type": "ImageToTextTaskMuggle",
  "body": "iVBORw0KGgoAAAANSUhEUgAAAKAAAAAyCAAAAAD+Co+5AAAA4klEQVR42u3YwRKDIAwEUD7dP6+dnhZKEhCQ1dnc6ET6zCAwSR/ySAIKKODTgQcEfQUZsRkwfSPGYlZtbPyRmZWKaATiOMcSAv1lQAbEX3vW7BZgDzaeq541DRjtBlTA9q2LAIiZ8Qc2FRjjvOVfrywREOdCLCUQx2Vl6YA4/lXUm9CetA23ZKMW8NXAvvPTR866lAko4NXLgoACuk/B7WYMOLIFZ1lHHtMqeB1YiOxz6zagXSP/YF0H/K9R/Bpr229mjbb1B5eIhoB3iPqAG0QBcL/IawEzdoHV5RdQQAEXxwn8FOsjAT8powAAAABJRU5ErkJggg=="
},
    timeout=200,
)
d = r.json()
if not d.get("ok"):
    raise SystemExit(d)
print(d.get("token") or d.get("text") or d.get("objects"))

注意事项

错误

失败时返回 502,积分全额退回,可以安全重试:

{"error":"识别失败,已全额退回 10 积分:...","code":"mint_failed"}
code含义处理
insufficient_credits积分不足(402,未扣费)充值后重试
bad_request参数不合法或类型不支持(400)对照上方参数表改
mint_failed识别失败(502,已退回)退避 2~3 秒重试
rate_limited触发限流(429)按 Retry-After 退避