加入并获得免费试用！

python captcha solver

Python 是一种高级解释型编程语言。它以简单易读而闻名。它是一种多功能语言，可用于 Web 开发、数据分析、人工智能更多的。

集成我们的Python验证码解决器包，以自动解决任何网站上的验证码。

轻松与验证码解决服务API 集成，以绕过 reCAPTCHA 并解决任何其他验证码

安装

使用 pip 或手动安装NextCaptcha Python SDK

PIP

要安装 NextCaptcha Python SDK，您可以使用 pip（推荐）或手动安装。

1. 使用 pip 安装（推荐）#

如果NextCaptcha SDK 在 PyPI 上发布，您可以使用以下命令安装它： 
pip install nextcaptcha-python
或者，如果它托管在 GitHub 上： 
pip install git+https://github.com/nextcaptcha/nextcaptcha-python.git

2. 手动安装#

如果您拥有 SDK 作为本地文件或 ZIP 存档，请按照以下步骤操作：

Step 1: 下载 SDK#

  • 克隆存储库： 
git clone https://github.com/nextcaptcha/nextcaptcha-python.git
cd nextcaptcha-python
或者
  • 从 GitHub 下载 ZIP，解压并导航到该文件夹。

本地安装。#

pip install .
或者，如果 SDK 不是以包的形式构建的： 
python setup.py install

验证安装#

运行 Python 并检查包是否正确导入： 
import nextcaptcha
print(nextcaptcha.__version__)
如果遇到任何问题，请确保已安装必须使用的依赖项： 
pip install -r requirements.txt

配置

使用必要的参数配置NextCaptcha Python SDK

Solver SDK 的配置

要配置 NextCaptcha Python SDK，您需要设置以下参数：
  • client_key: 来自NextCaptcha的你的API密钥
  • soft_id: 您的软件编号 （可选）
  • callback_url: 异步接收响应的 URL（如果使用回调模式）
  • open_log: 启用调试日志记录

** 配置示例**#

以下是设置和使用NextCaptcha Python SDK 的方法： 
from nextcaptcha import NextCaptchaAPI
 
# Configuration settings
config = {
    "client_key": "your_client_key_here",  # Replace with your NextCaptcha API key
    "soft_id": 12345,  # Your software ID (optional, replace if required)
    "callback_url": "https://your-callback-url.com",  # Callback URL (optional)
    "open_log": True  # Enable logging for debugging
}
 
# Initialize the NextCaptcha client
solver = NextCaptchaAPI(**config)
 
# Test request (example: solving a reCAPTCHA)
task = {
    "type": "ReCaptchaV2TaskProxyless",
    "websiteURL": "https://example.com",
    "websiteKey": "your_recaptcha_site_key"
}
 
# Send the task and get the result
try:
    task_id = solver.create_task(task)
    result = solver.get_result(task_id)
    print("Captcha solution:", result)
except Exception as e:
    print("Error:", str(e))

参数说明#

范围描述
client_key您的NextCaptcha API 密钥（必须使用）
soft_id您的软件编号 （可选）
callback_url发送结果的 URL（可选，仅适用于异步任务）
open_log如果为 True，则启用日志记录以进行调试

笔记#

  • 如果使用回调模式，解决方案将被发送到“callback_url”，因此您不需要手动获取结果。
  • 如果“open_log=True”，则会打印日志以帮助调试。
  • 确保用您的实际凭证替换占位符（“your_client_key_here”等）。

解决验证码

通过基于 Token 的方法解决 reCAPTCHA v2/v3/Enterprise

要使用 NextCaptcha 的基于 Token 的方法解决 reCAPTCHA v2、v3、Enterprise 或移动版本，请按照以下步骤操作：

1. 通过基于令牌的方法解决 reCAPTCHA#

使用基于令牌的方法来获取“g-recaptcha-response”令牌。

使用 Token 基方法解决 reCAPTCHA v2#

 
# {props.t('solve6')}
 
result = api.recaptchav2(website_url="https://example.com", website_key="SITE_KEY")

使用 Token 基方法解决 reCAPTCHA v2 Enterprise#

# {props.t('solve6')}
result = api.recaptchav2enterprise(website_url="https://example.com", website_key="SITE_KEY")

使用高分 Token 库方法解决 reCAPTCHA v2 Enterprise#

result = api.recaptchav2hs_enterprise(website_url="https://example.com", website_key="SITE_KEY")

使用 Token 基方法解决 reCAPTCHA v3 或 v3 Enterprise#

result = api.recaptchav3(website_url="https://example.com", website_key="SITE_KEY")

使用高分 Token 基础方法解决 reCAPTCHA v3 或 v3 Enterprise#

result = api.recaptchav3hs(website_url="https://example.com", website_key="SITE_KEY")

使用 Token 基方法解决 reCAPTCHA Mobile#

result = api.recaptcha_mobile(app_key="APP_KEY", app_package_name="com.example.app", app_action="APP_ACTION", app_device="ios")

3. 使用代币#

收到`g-recaptcha-response` token后，将其注入到网站的表单中并提交。 
<input type="hidden" name="g-recaptcha-response" value="your_token_here" />

参数说明#

范围描述
website_urlreCAPTCHA 所在网站的 URL
website_keyreCAPTCHA 的 sitekey
page_action用于 reCAPTCHA 的操作参数
api_domainreCAPTCHA API 的域（如果与默认域不同）
website_info关于目标网站的详细 reCAPTCHA 配置

关键注释#

✅ 支持 reCAPTCHA v2、v3、企业版和移动版

✅ Proxyless 模式可用（如果网站需要特定 IP，请使用代理）

✅ Token-based 方法可以无缝绕过验证码。

其他方法

要检查您的 NextCaptcha帐户余额，请使用以下方法：

获取余额示例#

# Get account balance
balance = api.get_balance()
print(f"Account balance: {balance}")

关键注释#

✅ 以美元检索您的可用余额。

✅ 确保你的API密钥有效以获取正确的余额。

错误处理

如果在解决验证码时发生错误，SDK 将返回包含错误信息的字典。您可以 检查状态字段以确定请求是否成功。如果状态为“就绪”，则验证码已 成功解决，解决方案将在解决方案字段中提供。如果状态为“失败”，则错误字段 将包含错误的描述。
编号代码描述
0-没有错误发生
1ERROR_KEY_DOES_NOT_EXIST你的API密钥不正确，请确保您已正确设置并从控制面板中的客户端或开发者模式复制它
10ERROR_ZERO_BALANCE您的账户余额为零
11ERROR_IP_NOT_ALLOWED请求来自不在您的信任 IP 列表中的 IP 地址
12ERROR_CAPTCHA_UNSOLVABLE验证码无法正常被解决,可能遇到代理,或者网络各种原因解决失败,一般情况可以重新请求尝试
14ERROR_NO_SUCH_METHOD请求了 API 中不存在的方法
15ERROR_IMAGE_TYPE_NOT_SUPPORTED由于图像格式或大小不正确，或图像已损坏，无法处理图像。请检查您请求中的图像
16ERROR_NO_SUCH_CAPCHA_ID您提供的验证码 ID 不正确
21ERROR_IP_BLOCKED由于不当使用 API，您的 IP 地址已被禁止
22ERROR_TASK_ABSENT您没有在 createTask方法调用中包含任务属性
23ERROR_TASK_NOT_SUPPORTED您的 createTask方法调用中的任务属性包含我们的API 不支持的任务类型，或者类型属性不正确。
31ERROR_RECAPTCHA_INVALID_SITEKEY您提供的 reCAPTCHA sitekey 值无效
55ERROR_ACCOUNT_SUSPENDED您的帐户因不当使用 API 而被暂停。请联系我们支持团队联系以解决此问题
130ERROR_BAD_PROXY代理参数不正确，或无法通过代理建立连接
110ERROR_BAD_PARAMETERS您的请求中缺少所需的验证码参数，或参数格式不正确。请确保您的请求负载格式适合所选的任务类型
500ERROR_UNKNOWN未知错误,可能是系统出现了意料之外的错误,可以将错误发送的管理员联系解决问题