CapMonster Cloud API
通过 CapMonster Cloud API 自动识别 CAPTCHA
使用 CapMonster Cloud API 识别验证码，是通过编程接口自动识别并识别验证码的过程。借助 CapMonster Cloud，您可以自动绕过 CAPTCHA，简化并加快工作流程。
工作原理
API 的验证码识别流程如下：
1. 提交请求
客户端向 API 服务器发送请求，提供 CAPTCHA 数据（图片、网站密钥、网址）。
2. 处理请求
API 服务器处理请求，识别 CAPTCHA 并开始解决过程。
3. 获取结果
API 服务器完成验证码识别，允许客户端继续其验证流程。
为什么要使用 API 来识别验证码
API（应用程序编程接口）可以自动化网站上的操作。
填写注册表单
提取和复制数据
向服务器发送各种类型的信息
通过 API 自动解决 CAPTCHA
CapMonster Cloud API 使用标准 HTTP 请求，并以 JSON 格式发送数据。
API 地址
- createTask创建 CAPTCHA 识别任务。JSON POST
https://api.capmonster.cloud/createTask - getTaskResult检查任务状态并获取结果。JSON POST
https://api.capmonster.cloud/getTaskResult - getBalance获取当前账户余额。JSON POST
https://api.capmonster.cloud/getBalance - getUserAgent提供最新的浏览器和操作系统数据。JSON POST
https://capmonster.cloud/api/useragent/actual
验证码解决算法
发送请求以创建任务
向以下地址发送 HTTP POST 请求：
https://api.capmonster.cloud/createTask在请求中包含您的API密钥和任务详情。
您的请求应如下所示：
{
"clientKey":"API_KEY",
"task": {
"type":"RecaptchaV2TaskProxyless",
"websiteURL":"https://example.com/",
"websiteKey":"6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd"
}
}服务器将返回验证码标识符（taskId）或错误代码（如果出现问题）。
获取响应创建任务后，向以下地址发送请求以获取响应：
https://api.capmonster.cloud/getTaskResult包含您的 API 密钥和任务标识符（taskId）。
您的请求应如下所示：
{
"clientKey":"API_KEY",
"taskId":12345678
}服务器将解决验证码或提供任务仍在进行中的信息。
响应示例：
{
"errorId":0,
"status":"ready",
"solution": {
"gRecaptchaResponse":"response_token"
}
}错误处理：主要类型和故障排除说明
您可能遇到的主要错误：
INVALID KEY
API 错误代码： ERROR_KEY_DOES_NOT_EXIST
此通知表示输入的 API 密钥不正确或不存在。请检查您是否输入正确并重试。
NO FUNDS
API 错误代码： ERROR_ZERO_BALANCE
此通知表示您的账户余额不足以完成任务（即余额为零）。请充值您的账户以继续解决验证码。
BIG IMAGE SIZE
API 错误代码： ERROR_TOO_BIG_CAPTCHA_FILESIZE
此通知表示验证码大小超出限制。
ZERO IMAGE SIZE
API 错误代码： ERROR_ZERO_CAPTCHA_FILESIZE
此通知表示您上传的验证码大小小于100字节。
CAPTCHA ID IS NOT FOUND
API 错误代码： ERROR_NO_SUCH_CAPCHA_ID, WRONG_CAPTCHA_ID
系统中未找到验证码（无法定位其ID）。验证码状态应在提交后的前5分钟内检查。请确保在此时间范围内检查。
CAPTCHA UNSOLVABLE
API 错误代码： ERROR_CAPTCHA_UNSOLVABLE
此类型的验证码不受服务支持，或者图像不包含可读的答案，意味着它是噪声。图像可能已损坏或渲染不正确。
CAPTCHA IS NOT READY
API 错误代码： CAPTCHA_NOT_READY
验证码尚未解决。请等待一两分钟。
REQUEST IS NOT ALLOWED FROM YOUR IP
API 错误代码： ERROR_IP_NOT_ALLOWED
此通知表示来自此 IP 地址的请求被拒绝。请打开您的个人账户 设置并将您的 IP 添加到允许列表。
IP BANNED
API 错误代码： ERROR_IP_BANNED
您使用错误的 API 密钥超出了请求限制。请检查密钥并尝试重新创建任务。
INCORRECT METHOD
API 错误代码： ERROR_NO_SUCH_METHOD
验证码类型（“type” 参数的值）不正确。请检查使用的方法是否正确。
THE TOKEN IS EXPIRED
API 错误代码： ERROR_TOKEN_EXPIRED
在识别验证码时，服务提供商注意到附加令牌已过期。请创建新任务，获取新令牌并重试请求。
NO FREE SERVERS
API 错误代码： ERROR_NO_SLOT_AVAILABLE
所有服务器均繁忙。请稍后再试。
INVALID RECAPTCHA SITEKEY
API 错误代码： ERROR_RECAPTCHA_INVALID_SITEKEY
提供了错误的 reCAPTCHA 密钥。请检查站点密钥的正确性。
RECAPTCHA TIMEOUT
API 错误代码： ERROR_RECAPTCHA_TIMEOUT
此通知表示解决 reCAPTCHA 的执行时间超过了服务器设置的允许时间，任务无法在指定时间内完成。请稍后重新提交请求。
YOUR IP IS BLOCKED
API 错误代码： ERROR_IP_BLOCKED
由于大量错误，指定IP地址的访问被禁止。请检查您的请求频率。更换您的 IP。创建任务时请考虑限制。
FAILED TO CONNECT PROXY
API 错误代码： ERROR_PROXY_CONNECT_REFUSED
服务无法通过指定的代理服务器建立连接。请检查代理设置（IP、端口、登录名、密码）的正确性和可用性。使用另一个代理。
THE PROXY IP IS BANNED
API 错误代码： ERROR_PROXY_BANNED
代理因其IP被目标验证码服务禁止。请使用另一个代理。
ERROR_TASK_ABSENT
API 错误代码： ERROR_TASK_ABSENT
未找到任务对象，或发送了无效的 JSON。请确保一切正确。检查任务执行时间是否已过期。
请始终参考文档，仅使用最新的 API 参数和方法。
重要！遇到其他错误且不知道如何解决？请参考以下指南以帮助解决问题： https://docs.capmonster.cloud/zh/docs/api/api-errors/。