概述

使用穿云 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 中配置以下关键参数：

V1 与 V2 版本逻辑演进

• V1 版本（传统模式）：
  请求为无状态模式。内置默认动态代理，支持可选配置第三方代理。适用于防护等级较低、无需保持登录态的简单采集。
• V2 版本（全栈模拟模式）： 必须提供第三方代理 IP 以维持会话稳定性。V2 采用了先进的 JA3 指纹模拟与 HTTP/2 流量特征匹配技术。
  • 自动质询处理：遇到 Cloudflare JS 质询时，系统将自动执行挑战逻辑。
  • 会话持久化：挑战成功后，穿云将锁定该 Cloudflare 会话 10 分钟。在有效期内，后续请求将复用该会话，无需重复消耗积分进行验证。
  • 会话分区 (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 官方文档