授权测试 · REST API
面向授权自动化测试与浏览器集成的验证码 API
在有权测试的站点与业务流程中,创建任务、轮询结果、提交 token 或 Cookie。SolveHub 通过同一个 JSON 接口处理 Cloudflare Turnstile 与拦截页、DataDome、Akamai Bot Manager、PerimeterX / HUMAN、Imperva、AWS WAF、阿里云验证码、Arkose FunCaptcha 与图片验证码。
新用户注册并绑定 Telegram 即可获得 0.10 USD 试用余额,无需充值、永不过期,可覆盖 1 个并发任务。立即领取试用余额 · 了解试用规则
- 10+验证码与人机验证类型
- 1个 REST 接口覆盖全部类型
- USD按成功任务计费
- 3种控制台语言:中文、英文、日文
支持的验证码类型
每种类型都有独立指南:请求字段、cURL 示例、结果格式与错误码。
- 图像文字识别使用 SolveHub OCR API 识别图片文字验证码:将 Base64 图片提交到 POST /v1/tasks,返回识别文本。字段限制、cURL 示例、结果格式与错误码。
- Cloudflare Turnstile通过 SolveHub API 解决 Cloudflare Turnstile:提交 websiteURL 与 websiteKey,可选 cdata/action 与代理,轮询任务获取响应 token。请求字段、cURL 示例与错误码。
- Cloudflare Interstitial通过 SolveHub API 通过 Cloudflare 5 秒盾拦截页,复用返回的 clearance Cookie、User-Agent 与同一代理。请求字段、cURL 示例与错误码。
- PerimeterX / HUMAN通过 SolveHub API 处理 PerimeterX / HUMAN 人机验证:应用 ID、目标站点、代理与浏览器 Cookie。了解需要提交的字段以及如何使用返回的 Cookie。
- DataDome通过 SolveHub API 解决 DataDome 验证:提交挑战 URL 与代理,轮询任务获得 datadome Cookie,配合相同 IP 与 User-Agent 使用。字段、cURL 与错误码。
- Akamai Bot Manager通过 SolveHub API 获取 Akamai Bot Manager 浏览器会话 Cookie(_abck、bm_sz)。请求字段、代理要求、cURL 示例、结果格式与错误码。
- 阿里云验证码 2.0通过 SolveHub API 解决阿里云验证码 2.0:场景 ID、身份前缀与需要回传目标站点的验证载荷。请求字段、cURL 示例与错误码。
- Imperva / Incapsula通过 SolveHub API 处理 Imperva / Incapsula 防护,支持 reese84 与 UT.mvc 两种模式。各模式请求字段、代理要求、cURL 示例、结果 Cookie 与错误码。
- AWS WAF通过 SolveHub API 解决 AWS WAF 挑战与验证码:挑战脚本 URL、可选验证码脚本与代理,返回 aws-waf-token。请求字段、cURL 示例与错误码。
- Arkose FunCaptcha通过 SolveHub API 解决 Arkose Labs FunCaptcha:公钥、站点 URL、挑战上下文(blob)、浏览器信息与代理。请求字段、cURL 示例、结果 token 与故障排查。
接入流程
- 获取 API Key注册并验证邮箱,自助服务开放时可开通并取得首把 Key,也可绑定已签发的 Key;按控制台提供的方式充值。
- 创建任务带验证码类型与参数调用 POST /v1/tasks,附上 Idempotency-Key,重试不会产生重复任务。
- 轮询并使用结果每 2–3 秒请求 GET /v1/tasks/{taskId},直到 completed,然后读取 solution:token、Cookie 集或识别文本。
一次请求创建任务
curl -sS -X POST 'https://www.tiam.codes/v1/tasks' \
-H 'Authorization: Bearer sh_REPLACE_ME' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: order-12345' \
-d '{"type":"turnstile","task":{"websiteURL":"https://example.com","websiteKey":"SITE_KEY"}}'
# → 202 {"taskId":"…","status":"queued","priceMicros":200,…}
curl -sS -H 'Authorization: Bearer sh_REPLACE_ME' 'https://www.tiam.codes/v1/tasks/TASK_ID'
# → {"status":"completed","solution":{"value":"0.EXAMPLE_TOKEN"},…}为什么选择 SolveHub
- 只为成功任务付费每个任务按创建时冻结的价格扣费。失败或取消的任务自动退回预占金额。
- 幂等且可追溯每个请求都支持 Idempotency-Key,并返回 traceId 与 X-Request-ID,重试和排障都安全快捷。
- 实时可用性与价格GET /v1/prices 公开且始终最新;协议价客户可通过 GET /v1/me/prices 查看自己的生效单价。
- 控制台:用量、Webhook 与工单管理 API Key、查看用量与消费、通过 Webhook 接收任务回调、提交工单,支持中文、英文与日文。
按次计费,价格透明
仅对成功完成的任务计费,所有价格均以美元结算。
| 类型 | 状态 | 单次(USD) | 每 1,000 次 |
|---|---|---|---|
| 图像文字识别 | 可用 | $0.0002 | $0.20 |
| Cloudflare Turnstile | 可用 | $0.0002 | $0.20 |
| Cloudflare Interstitial | 可用 | $0.0004 | $0.40 |
| PerimeterX / HUMAN | 可用 | $0.001 | $1.00 |
| DataDome | 可用 | $0.0012 | $1.20 |
| Akamai Bot Manager | 可用 | $0.0008 | $0.80 |
| 阿里云验证码 2.0 | 可用 | $0.0004 | $0.40 |
| Imperva / Incapsula | 可用 | $0.0016 | $1.60 |
| AWS WAF | 可用 | $0.001 | $1.00 |
| Arkose FunCaptcha | 可用 | $0.002 | $2.00 |
价格快照取自 2026-11-04 07:18(UTC)的 GET /v1/prices;页面脚本执行后会用实时价格覆盖。
当前显示 2026-11-04 07:18(UTC)的价格快照
常见问题
SolveHub 支持哪些验证码类型?
Cloudflare Turnstile、Cloudflare 拦截页(Interstitial)、DataDome、Akamai Bot Manager、PerimeterX / HUMAN、Imperva / Incapsula、AWS WAF、阿里云验证码 2.0、Arkose Labs FunCaptcha 以及图片文字验证码(OCR)。各类型的实时可用性见 GET /v1/prices。
SolveHub 如何计费?
按任务以美元计费。每个任务的价格在创建时冻结,只在任务成功完成时扣费;失败或取消的任务退回预占金额。充值方式以控制台实际提供的选项为准。
需要 SDK 吗?
不需要。接口是纯 HTTPS + JSON:POST /v1/tasks 创建任务,GET /v1/tasks/{taskId} 查询结果。任何带 HTTP 客户端的语言都可以调用,文档提供 cURL 与 Python 示例。
需要提供代理吗?
视类型而定。DataDome、Akamai、PerimeterX、Imperva 等基于 Cookie 的防护通常需要你自己的代理,以保证返回的 Cookie 与后续使用的 IP 一致;Turnstile 与 OCR 不需要。
任务需要多长时间?
每种类型有 90–180 秒的软处理时限,超时后任务可能进入 uncertain 状态;请继续查询同一个 taskId,不要新建任务。
如何获取 API Key?
注册并验证邮箱后,自助服务开放时可开通并获得首把 Key,也可绑定 SolveHub 团队为你签发的 Key。Key 具有权限范围(tasks、billing、account)和有效期,可在控制台管理。