Cloudflare 与 DataDome 共用相同的 API 接入逻辑和代码调用方式。 是否支持具体目标仍取决于网站和验证类型，请先测试目标兼容性。统一套餐不代表所有目标都能成功访问。
Cloudflare 与 DataDome 共用同一套 API 积分，采用统一的积分消耗规则和定价策略。根据业务用量选择套餐；代理流量单独计费。 查看价格
概述
使用穿云 API 可助您深度绕过 Cloudflare 的各项安全挑战。目前已全面支持绕过 5 秒盾（JavaScript Challenge）、WAF 防护、Turnstile CAPTCHA 以及 Imperva/Incapsula 等顶级人机验证产品。
本文档详细介绍了穿云 HTTP API、本地代理工具及 Python SDK 的集成方法，涵盖最新的 V2 异步/同步接口逻辑、请求参数规范及返回处理。
发起请求
穿云 API 基于 HTTPS 协议，支持全量 HTTP 请求方法。您需将目标地址的协议和主机名替换为穿云 API 网关地址。
- API 请求地址：
https://api.cloudbypass.com - 代码生成器调试：https://console.cloudbypass.com/#/code-generator
核心请求头参数
对接时，必须在 Header 中配置以下关键参数：
| 参数名 | 描述 | 备注 |
|---|---|---|
x-cb-apikey | 您的 API 密钥 | 从穿云控制台获取 |
x-cb-host | 目标服务器主机名 | 如访问 example.com/path，则传 www.example.com |
x-cb-proxy | 代理服务器地址 | V2 版本强制要求提供固定或具有时效性的代理 IP |
V1 与 V2 版本逻辑演进
- V1 版本（传统模式）：
请求为无状态模式。内置默认动态代理，支持可选配置第三方代理。适用于防护等级较低、无需保持登录态的简单采集。 - V2 版本（全栈模拟模式）： 必须提供第三方代理 IP 以维持会话稳定性。V2 采用了先进的 JA3 指纹模拟与 HTTP/2 流量特征匹配技术。
- 自动质询处理：遇到 Cloudflare JS 质询时，系统将自动执行挑战逻辑。
- 会话持久化：挑战成功后，穿云将锁定该 Cloudflare 会话 10 分钟。在有效期内，后续请求将复用该会话，可减少重复验证挑战的额外积分消耗，但每次成功请求仍消耗 1 积分。
- 会话分区 (
x-cb-part)：支持通过此参数实现逻辑上的会话隔离，适用于多账号并发操作场景。
Python SDK 集成示例
穿云官方提供基于 requests 封装的 Python SDK（支持 Python 3.7+），内置会话管理器，自动处理 Cookie 与指纹对齐。
# 安装指令: pip install cloudbypass
from cloudbypass import Session
# 初始化穿云会话（配置 APIKey 和 V2 必需的代理地址）
apikey = "您的APIKEY"
proxy = "http://username:password@proxy_host:port"
with Session(apikey=apikey, proxy=proxy) as session:
# 访问受 Cloudflare 保护的网站
# SDK 会自动处理 JA3 指纹、HTTP/2 特征及 V2 会话逻辑
response = session.get("https://target-website.com/data")
# 输出经过穿云解密后的响应内容
print(response.status_code)
print(response.text)立即开始优化：
更多详细参数及 SDK 进阶用法，请参考官方快速开始指南：
👉 穿云 Python API 官方文档