
Ethan Collins
Pattern Recognition Specialist

getTaskResult 返回的 token 必须提交到目标网站以成功完成验证。Cloudflare Turnstile 是一种注重隐私的 CAPTCHA 替代方案,取代了传统的 reCAPTCHA 挑战。它旨在减少用户干扰,同时仍有效防止自动化滥用。然而,从开发者的角度来看,Turnstile 为自动化、测试和数据收集工作流带来了新的挑战。
与 Cloudflare 的 5 秒挑战不同,Turnstile 依赖于 基于令牌的验证,而不是浏览器指纹连续性。这使其更容易集成——前提是使用正确的参数和任务类型。
在本指南中,您将学习:
本教程适合寻找 快速、可扩展且低维护 的 Turnstile 解决方案的开发者。
CapSolver 自动处理所有 Cloudflare Turnstile 变体,包括:

无需额外配置即可区分这些类型——CapSolver 会自动检测并处理它们。
在解决 Cloudflare Turnstile 之前,请确保满足以下先决条件并了解验证要求。
getTaskResult 响应中返回的 token 是 最终的 CAPTCHA 验证令牌。有关完整的参数说明,请参阅官方文档:
https://docs.capsolver.com/en/guide/captcha/cloudflare_turnstile/
本教程仅关注必需的参数。Cloudflare Turnstile 支持的任务类型为:
当网站受 Cloudflare Turnstile 保护且 不需要浏览器级指纹重用 时,推荐使用此任务类型。
使用 createTask API 创建任务并提交必要信息:
POST https://api.capsolver.com/createTask
{
"clientKey": "YOUR_API_KEY",
"task": {
"type": "AntiTurnstileTaskProxyLess",
"websiteURL": "https://www.yourwebsite.com",
"websiteKey": "0x4XXXXXXXXXXXXXXXXX",
"metadata": {
"action": "login",
"cdata": "0000-1111-2222-3333-example-cdata"
}
}
}
websiteKey 为必填项metadata.action 和 metadata.cdata 为可选参数,具体取决于网站的实现轮询 getTaskResult 端点,直到任务完成:
POST https://api.capsolver.com/getTaskResult
Host: api.capsolver.com
Content-Type: application/json
{
"clientKey": "YOUR_API_KEY",
"taskId": "TASKID_OF_CREATETASK"
}
一旦任务完成,响应将包含有效的 Turnstile 令牌:

要在目标网站完成验证:
token 提交到网站的 Turnstile 验证端点⚠️ 如果令牌被拒绝,请确认网站是否受 Cloudflare Turnstile 保护,而不是 Cloudflare 5 秒挑战,后者需要不同的任务类型和参数。
Cloudflare Turnstile 提供了简化版的 CAPTCHA 替代方案,但自动化仍需要可靠的令牌生成流程。
CapSolver 通过 AntiTurnstileTaskProxyLess 简化了 Turnstile 的解决过程,无需自定义代理或浏览器指纹管理。通过提供正确的参数并正确提交返回的令牌,开发者可以快速且大规模地将 Turnstile 解决方案集成到其工作流中。
通过正确的设置,解决 Cloudflare Turnstile 变得高效、可预测且适合生产环境。
Turnstile 是基于令牌的 CAPTCHA 机制,而 5 秒挑战是浏览器和网络指纹验证流程。它们需要不同的任务类型。
不需要。AntiTurnstileTaskProxyLess 使用 CapSolver 的内部代理基础设施。
常见原因包括错误的 websiteKey、过期的令牌,或尝试使用 Cloudflare 5 秒挑战而非 Turnstile。
不能。Turnstile 令牌是 一次性使用 的,并与特定会话或操作绑定。
有关 Cloudflare 5 秒挑战(IUAM)的解决方案,请参考:
https://www.capsolver.com/blog/how-to-solve-cloudflare-challenge
学习修复Cloudflare错误1005访问被拒绝的网络爬虫问题。发现解决方案如住宅代理、浏览器指纹识别和CapSolver验证码解决方法。优化您的数据提取。

了解如何通过使用Playwright隐身技术以及CapSolver实现可靠的验证码解决,从而有效处理AI工作流中的Cloudflare Turnstile。学习实用的集成策略和最佳实践,以实现无缝自动化。
