注册

API 文档

验证码处理服务 API 使用指南

v2.1

使用必读

支持包月和按次两种计费方式，包月套餐不限请求量。
所有请求都需要你自己提供代理（proxy），不支持无代理模式。
代理质量直接影响成功率，建议使用高质量住宅代理。
所有请求需在 Header 中携带 x-api-key 进行认证。 前往 API Key 管理 获取你的密钥。

提交任务

调用流程分为三步：提交任务 → 获取结果（轮询或任务回调） → 使用返回数据。展开每一步查看详情。

提交验证码处理任务，返回 task_id 用于轮询结果。

请求参数

请求示例 (hCaptcha)

POST /task/submit HTTP/1.1
Host: www.passxapi.com
Content-Type: application/json
x-api-key: YOUR_API_KEY

{
  "task_type": "hcaptcha",
  "proxy": "http://user:pass@ip:port",
  "target_url": "https://example.com/login",
  "site_key": "your-site-key"
}

响应

{
  "ok": true,
  "task_id": "abc123-def456"}

方式一：轮询

根据 task_id 主动查询任务结果，建议每 1-2 秒轮询一次，适合大多数场景。

状态说明

示例代码

GET /task/result/abc123-def456 HTTP/1.1
Host: www.passxapi.com
x-api-key: YOUR_API_KEY

成功响应示例

{
  "status": "SUCCESS",
  "result": {
    "token": "P0_eyJ...",
    "ua": "Mozilla/5.0 ...",
    "cookies": { "cf_clearance": "xxx"}
  }
}

使用返回数据

任务成功后，result 中会返回 token、cookies、ua 等字段，直接将它们带入你的目标网站请求即可。

# result 包含 token / cookies / ua，直接用于目标请求
import requests

result = {
    "token": "P0_eyJ...",
    "ua": "Mozilla/5.0 ...",
    "cookies": {"cf_clearance": "xxx"}
}

# 将获取到的 token 用于目标网站请求
resp = requests.post(
    "https://example.com/login",
    headers={
        "User-Agent": result["ua"],
        "Content-Type": "application/x-www-form-urlencoded"
    },
    cookies=result.get("cookies", {}),
    data={
        "username": "your_username",
        "password": "your_password",
        "captcha_token": result["token"]
    }
)

print(resp.status_code, resp.text[:200])

方式二：回调

提交任务时传入你的接口地址，任务完成后系统自动把结果推送过去，不用再轮询。

使用方法

提交任务时多传一个 callback_url，填你自己的接口地址：

POST /task/submit
{
  "task_type": "hcaptcha",
  "proxy": "http://user:pass@ip:port",
  "target_url": "https://example.com/login",
  "site_key": "your-site-key",
  "callback_url": "https://yoursite.com/webhook/captcha"}

回调请求格式

任务完成后，系统会自动往你的接口 POST 以下 JSON 数据：

成功时的回调内容

JSON
{
  "taskId": "abc123-def456-...",
  "status": "ready",
  "errorId": 0,
  "solution": {
    "token": "P0_eyJ...",
    "cookies": {
      "cf_clearance": "xxx"},
    "userAgent": "Mozilla/5.0 ..."}
}

失败时的回调内容

JSON
{
  "taskId": "abc123-def456-...",
  "status": "failed",
  "errorId": 1,
  "errorCode": "ERROR_CAPTCHA_UNSOLVABLE",
  "errorDescription": "Task failed"}

重试机制

你的接口正常响应（HTTP 200）即视为推送成功。如果返回 404 或连接超时（10 秒），系统会自动重试最多 3 次，间隔 5秒 → 30秒 → 120秒。

注意事项

  • 接口地址必须是公网可访问的 HTTP/HTTPS 地址
  • 你的接口要在 10 秒内返回，否则算超时
  • 回调和轮询可以同时用，互不影响
  • 同一个任务推送成功后不会重复发
  • 建议用 taskId 做幂等校验，避免重复处理

错误码

FCFuncaptcha 无感funcaptcha$1/1k▶
单价$1 / 1000次
平均耗时~5s
成功率98%

请求参数

请求示例

POST /task/submit
{
  "task_type": "funcaptcha",
  "proxy": "http://username:password@ip:port",
  "target_url": "https://login.coinbase.com/signup",
  "custom_api_host": "ark.coinbase.com",
  "public_key": "32FBE3BC-228C-4967-9D76-8B27B3EBCF08"}

注意事项

如果你的网站包含blob, 则需要使用与生成blob请求ip一致的代理。
仅支持无感模式, 不支持图像验证

SBAkamai sbsd/bm_scsbsd$1/1k▶
单价$1 / 1000次
平均耗时~5s
成功率98%

请求参数

请求示例

POST /task/submit
{
  "task_type": "sbsd",
  "proxy": "http://username:password@ip:port",
  "target_url": "https://aswbe-i.ana.co.jp/rei12e/international_asw/pages/award/search/roundtrip/award_search_roundtrip_result_owd.xhtml",
  "sbsd_js_url": "https://aswbe-i.ana.co.jp/NAOAvP/g/p/QDWF9UmqEw/rcYOS6b93wYa/M25MIQ0C/K18aV/SB9Vy0C?v=70653420-b257-2e52-8195-fcb561c117d5&t=633180829",
  "init_cookies": {
    "bm_s": "xxx",
    "bm_sc": "xxx"}
}
FTForter Tokenforter$1/1k▶
单价$1 / 1000次
平均耗时~5s
成功率98%

请求参数

请求示例

POST /task/submit
{
  "task_type": "forter",
  "proxy": "http://username:password@ip:port",
  "target_url": "https://arcteryx.com/ca/en/checkout/",
  "forter_js_url": "https://scripts.arcteryx.com/js/forter.js",
  "site_id": "cbf12a88ccce"}
DDDataDome 设备检测datadome-device-check$1/1k▶
单价$1 / 1000次
平均耗时~4s
成功率98%

请求参数

请求示例

POST /task/submit
{
  "task_type": "datadome-device-check",
  "proxy": "http://username:password@ip:port",
  "target_url": "https://www.cma-cgm.com/",
  "target_method": "GET"}
CACastle Tokencastle$1/1k▶
单价$1 / 1000次
平均耗时~5s
成功率98%

请求参数

请求示例

POST /task/submit
{
  "task_type": "castle",
  "proxy": "http://username:password@ip:port",
  "target_url": "https://signin.rockstargames.com/create/date-of-birth",
  "config_json": {
    "pk": "pk_1Tt6Yzr1WFzxrJCh7WzMZzY1rHpaPudN",
    "wUrl": "https://s.rsg.sc/auth/js/20250915bgbb/build/cw.js",
    "swUrl": "https://s.rsg.sc/auth/js/20250915bgbb/build/csw.js",
    "avoidCookies": true
  }
}
KSKasada cdkasada_cd$1/1k▶
单价$1 / 1000次
平均耗时~6s
成功率98%

请求参数

请求示例

POST /task/submit
{
  "task_type": "kasada_cd",
  "ct": "0b3jqi5b3LjWE63tZoPso14738QbuA0PA2x9D83CqbZerMQyjGMAVQoNxO7FPTzFEGui72xxAd6ewGAmBKx1tfs5BSXVnNDU83WzSfqnJCX8vZCqmxE7s24XJgWs77sPSl6fTtzbj1n1yf6GIvntSJYA0lkQxmm9F6UAzciBvvZ",
  "st": "1756879688265",
  "fc": "eyJmZWF0dXJlRmxhZ3MiOnsicmVtb3RlLWNvbmZpZ3VyYXRpb25zIjp0cnVlLCJyZW1vdGUtbG9nZ2luZyI6ZmFsc2V9LCJkeW5hbWljQ29uZmlnIjp7ImZyb250ZW5kIjp7ImNyeXB0b0NoYWxsZW5nZSI6eyJjdXJyZW50UGFyYW1ldGVycyI6eyJkaWZmaWN1bHR5IjoxMCwic3ViY2hhbGxlbmdlQ291bnQiOjIsInNlZWRTdWZmaXgiOiIifX0sImxvZ0xldmVsIjo1MH19fQ==",
  "site": "arcteryx"}

注意事项

目前支持十余个网站，如需添加新网站请联系管理员。
累计使用$300积分的kasada ct任务后请联系管理员开通免费cd接口的权限
账户余额大于100,000积分($100)时此接口自动免费

RCreCaptcha V3recaptchav3$1/1k▶
单价$1 / 1000次
平均耗时~5s
成功率98%

请求参数

请求示例

POST /task/submit
{
  "task_type": "recaptchav3",
  "proxy": "http://username:password@ip:port",
  "target_url": "https://2captcha.com/demo/recaptcha-v3",
  "site_key": "6Lcyqq8oAAAAAJE7eVJ3aZp_hnJcI6LgGdYD8lge",
  "action": "demo_action",
  "title": "Google reCAPTCHA V3 demo: Sample Form with Google reCAPTCHA V3",
  "enterprise": false
}

注意事项

暂不支持带s值的reCAPTCHA。
插件显示的site_key有误，且未显示action参数，请自行在html寻找。

TMThreatMetrixthreatmetrix$1/1k▶
单价$1 / 1000次
平均耗时~5s
成功率98%

请求参数

请求示例

POST /task/submit
{
  "task_type": "threatmetrix",
  "proxy": "http://username:password@ip:port",
  "target_url": "https://www.kleinanzeigen.de/m-einloggen.html",
  "org_id": "181rzcrc",
  "page_id": "94",
  "session_id": "3029471b-4b25-41cd-8d78-46598448325e",
  "custom_domain": "dfme.kleinanzeigen.de",
  "title": "Login - Anmelden bei Kleinanzeigen"}
AWAwsWafToken 无感aws$1/1k▶
单价$1 / 1000次
平均耗时~4s
成功率98%

请求参数

请求示例

POST /task/submit
{
  "task_type": "aws",
  "proxy": "http://username:password@ip:port",
  "target_url": "https://sportsbook.caesars.com/us/ia/bet/",
  "aws_js_url": "https://b470c5d1aeb4.edge.sdk.awswaf.com/b470c5d1aeb4/06faba802dee/challenge.js"}

注意事项

仅支持无感模式，不支持点选验证。

VCVercel Challengevercel$1/1k▶
单价$1 / 1000次
平均耗时~4s
成功率98%

请求参数

请求示例

POST /task/submit
{
  "task_type": "vercel",
  "proxy": "http://username:password@host:port",
  "target_url": "https://packdraw.com/"}
DDDataDome 滑块检测datadome-slider$1/1k▶
单价$1 / 1000次
平均耗时~5s
成功率98%

请求参数

请求示例

POST /task/submit
{
  "task_type": "datadome-slider",
  "proxy": "http://username:password@ip:port",
  "target_url": "https://mygift.giftcardmall.com/api/card/getCardBalanceSummary",
  "target_method": "POST",
  "init_cookies": {
    "datadome": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"}
}
CFCaptchaFoxcaptchafox$1/1k▶
单价$1 / 1000次
平均耗时~3s
成功率98%

请求参数

请求示例

POST /task/submit
{
  "task_type": "captchafox",
  "proxy": "http://username:password@ip:port",
  "target_url": "https://web.de/",
  "site_key": "sk_7R1vL5RIKvHgmNWpqbC9ppWKOfODF"}
UTIncapsula _utmvcutmvc$1/1k▶
单价$1 / 1000次
平均耗时~4s
成功率98%

请求参数

请求示例

POST /task/submit
{
  "task_type": "utmvc",
  "proxy": "http://username:password@ip:port",
  "utmvc_js_url": "https://www.thaiairways.com/_Incapsula_Resource?SWJIYLWA=719d34d31c8e3a6e6fffd425f7e032f3&ns=2&cb=1558987183",
  "incap_cookie": {
    "nlbi_1584510": "Mv20CSpoRh/WQODNRk7kTwAAAACRz85+N7F/WQIGhC...",
    "visid_incap_1584510": "o/UvTkB5QueTUtQBoLdWYVGWS2gAAAAAQU...",
    "incap_ses_958_1584510": "WZSQFuVAs3NDeHYpMIBLDVuWS2gAAAAAX..."}
}
AKAkamai sec_cptsec_cpt$1/1k▶
单价$1 / 1000次
平均耗时~6s
成功率98%

请求参数

请求示例

POST /task/submit
{
  "task_type": "sec_cpt",
  "sec_cpt": "ADE36B02B21573BDBB5BFBF91F336959~1~....",
  "sec_json": {
    "count": 10,
    "nonce": "30cc8a4637ca...",
    "token": "AAQAAAAL_____...",
    "timestamp": 1758097163,
    "difficulty": 5000
  }
}

注意事项

返回用于/verify API的answers数组, 网页端每秒验证一次，实际使用可以difficulty/1000秒后验证

KSKasada ctkasada$1/1k▶
单价$1 / 1000次
平均耗时~5s
成功率98%

请求参数

请求示例

POST /task/submit
{
  "task_type": "kasada",
  "proxy": "http://username:password@ip:port",
  "target_url": "https://arcteryx.com/",
  "protected_api_domain": "arcteryx.com",
  "kasada_js_domain": "arcteryx.com"}

注意事项

如需要proxyless功能(直接返回/tl请求的payload)，请联系管理员获取。

PXPerimeterX 无感perimeterx_invisible$3/1k▶
单价$3 / 1000次
平均耗时~5s
成功率98%

请求参数

请求示例

POST /task/submit
{
  "task_type": "perimeterx_invisible",
  "proxy": "http://username:password@ip:port",
  "target_url": "https://www.walmart.com/",
  "perimeterx_js_url": "https://www.walmart.com/px/PXu6b0qd2S/init.js",
  "pxAppId": "PXu6b0qd2S"}

注意事项

暂不支持app端与微软邮箱注册。

HHCaptcha2hcaptcha_pro$7/1k▶
单价$7 / 1000次
平均耗时~5s

请求参数

请求示例

POST /task/submit
{
  "task_type": "hcaptcha_pro",
  "proxy": "http://username:password@ip:port",
  "target_url": "https://www.wolt.com/",
  "site_key": "85fed6af-162f-4a66-a7ab-8822a7d81f72"}

注意事项

暂不支持动态js的hcaptcha和rqData。

CFCloudflare Turnstileturnstile$1/1k▶
单价$1 / 1000次
平均耗时~3s
成功率98%

请求参数

请求示例

POST /task/submit
{
  "task_type": "turnstile",
  "proxy": "http://username:password@ip:port",
  "target_url": "https://peet.ws/turnstile-test/managed.html",
  "site_key": "0x4AAAAAAABS7TtLxsNa7Z2e"}
TLTLS 转发tls_forward$1/1k▶
单价$1 / 1000次
平均耗时~3s
成功率98%

请求参数

请求示例

POST /task/submit
{
  "task_type": "tls_forward",
  "proxy": "http://username:password@host:port",
  "url": "https://httpbin.org/post",
  "method": "POST",
  "headers": {
    "x-sss": "111",
    "accept": "application/json",
    "referer": "https://httpbin.org/aa"},
  "body_base64": "dGVzdEJvZHk=",
  "cookies_dict": {
    "test": "11"}
}

注意事项

快速使用:
import riskbypass
client = riskbypass.RiskByPassClient(token="你的token")
response = client.tls_get(xxx)或client.tls_post(xxx)
当你的积分不小于100,000($100)时此接口不扣除积分

SHShape F5shape$1/1k▶
单价$1 / 1000次
平均耗时~6s
成功率98%

请求参数

请求示例

POST /task/submit
{
  "task_type": "shape",
  "proxy": "http://username:password@ip:port",
  "target_url": "https://www.pokemoncenter-online.com/login/",
  "target_api": "https://www.pokemoncenter-online.com/on/demandware.store/Sites-POL-Site/ja_JP/Account-SubmitConfirmationEmail",
  "shape_js_url": "https://www.pokemoncenter-online.com/larkbileomet.js?single",
  "method": "POST",
  "title": "ログイン｜【公式】ポケモンセンターオンライン"}

注意事项

每个站点都需要单独配置, 需要请联系管理员。

PXPerimeterX 验证perimeterx_hold维护中$5/1k▶
单价$5 / 1000次
平均耗时~7s
成功率98%

请求参数

请求示例

POST /task/submit
{
  "task_type": "perimeterx_hold",
  "proxy": "http://username:password@ip:port",
  "target_url": "https://www.walmart.com/",
  "perimeterx_js_url": "https://client.px-cloud.net/PXu6b0qd2S/main.min.js",
  "captcha_js_url": "https://www.walmart.com/px/PXu6b0qd2S/captcha/captcha.js",
  "init_cookies": {
    "pxhd": "3a72e00e1ce54a44b3d59b42a8eead42ee5c246a4389de2aba9544281656c0a9:84439b81-676a-11f0-b082-def9cefce6ae"},
  "pxvid": "84439b81-676a-11f0-b082-def9cefce6ae",
  "pxuuid": "1d90e990-982a-11f0-9531-bb778ceab4d7",
  "pxAppId": "PXu6b0qd2S"}

注意事项

暂不支持app端与微软邮箱注册。

AKAkamai _abckakamai$1/1k▶
单价$1 / 1000次
平均耗时~5s
成功率98%

请求参数

请求示例

POST /task/submit
{
  "task_type": "akamai",
  "proxy": "http://username:password@ip:port",
  "target_url": "https://shop.lululemon.com/",
  "akamai_js_url": "https://shop.lululemon.com/WGlx/lc_w/w/vez/w0HNXw/EmubktLXh3Npr6Nab5/TXUGYQ/Lh9aC2xK/H34",
  "page_fp": "424541475255414d424b41585f5e50495c5148",
  "init_cookies": {}
}

注意事项

如需要proxyless功能(直接返回sensor_data)，请联系管理员获取。
akamai_js_url每日变化, 请确保你的脚本中每天更新。
高风控网站需要搭配本站的tls_forward任务使用才能通过akamai风控

DDDataDome 无感datadome-invisible$1/1k▶
单价$1 / 1000次
平均耗时~4s
成功率98%

请求参数

请求示例

POST /task/submit
{
  "task_type": "datadome-invisible",
  "proxy": "http://username:password@ip:port",
  "target_url": "https://www.tripadvisor.com/",
  "datadome_js_url": "https://js.datadome.co/tags.js",
  "ddjskey": "2F05D671381DB06BEE4CC52C7A6FD3",
  "ddoptions": "{\"ajaxListenerPath\": true, \"allowHtmlContentTypeOnCaptcha\": true}"}

注意事项

仅适用于来自tags.js的datadome cookie, 如果是设备验证或者滑块, 请使用datadome-slider。
如果你确定是tags.js，且此任务得到的cookie不可用，说明此网站需要单独进行配置，请联系管理员。

R8Incapsula Reese84reese84$1/1k▶
单价$1 / 1000次
平均耗时~5s
成功率98%

请求参数

请求示例

POST /task/submit
{
  "task_type": "reese84",
  "proxy": "http://username:password@ip:port",
  "reese84_js_url": "https://book.virginaustralia.com/side-you-ares-may-Exit-sition-Alaruern-Naugmen-G"}

注意事项

如果返回_Incapsula_Resource JS，请尝试utmvc任务。

CFCloudflare 五秒盾cloudflare_waf$1/1k▶
单价$1 / 1000次
平均耗时~4s
成功率98%

请求参数

请求示例

POST /task/submit
{
  "task_type": "cloudflare_waf",
  "proxy": "http://username:password@ip:port",
  "target_url": "https://pastebin.com/login",
  "target_method": "GET"}

注意事项

请确保代理一致性, 且使用与返回ua相同的请求头。
如需定制或并发，请联系管理员。

HHCaptcha1hcaptcha$1/1k▶
单价$1 / 1000次
平均耗时~4s
成功率98%

请求参数

请求示例

POST /task/submit
{
  "task_type": "hcaptcha",
  "proxy": "http://username:password@ip:port",
  "target_url": "https://www.yelp.com/",
  "site_key": "6660d4df-1884-4ac6-a933-e5f3bd460946"}

注意事项

暂不支持rqData。
如果此任务得到的token无效，请尝试更换代理或使用hcaptcha_pro任务。