官方 SDK 与 HTTP API
官方提供 Python、Node.js 和 Go SDK。其他能够发送 HTTPS 请求的开发语言可直接调用 HTTP API，并自行判断响应状态和错误信息。
Cloudflare 访问验证解决方案
穿云API
把复杂的网页访问验证，变成清晰可控的 API 请求
面向开发者、数据团队与自动化项目，通过 HTTPS 接口处理 Cloudflare JS 质询、Turnstile 等访问验证。可直接调用 HTTP API，也可使用官方 SDK 或本地代理工具接入。
请仅用于经授权的网页访问、自动化测试与数据处理任务。查看官方 Quickstart
支持穿云 V1、V2 与 V2s
访问验证处理JS质询与Turnstile
HTTPS API支持所有HTTP方法
V1 / V2 / V2s按验证场景选择
官方 SDKPython、Node.js、Go
产品定位
穿云API能解决什么问题
当普通 HTTP 请求遇到 Cloudflare JS 质询或 Turnstile 验证时，穿云API通过统一的 HTTPS 接口转发目标请求。SDK 与本地代理工具用于简化接入，底层仍然调用同一套 HTTP API。
- 适用于已获授权的数据采集、页面监控和自动化测试
- 必填请求头为 x-cb-apikey 与 x-cb-host
- 处理响应时应检查 x-cb-status 和错误 JSON
cURL 请求示例
curl --include --request GET \
--url "https://api.cloudbypass.com/user/login.html" \
--header "x-cb-apikey: <APIKEY>" \
--header "x-cb-host: example.io"
# 原目标地址：https://example.io/user/login.html
# x-cb-protocol 默认值为 https
核心能力
围绕真实开发流程设计
从目标页面测试、参数配置到正式集成，穿云API把常用能力放进一套清晰的请求流程。
所有接入最终转发到 HTTP API
直接请求必须提供 x-cb-apikey 与 x-cb-host。本地代理工具和 SDK 负责简化调用，底层仍会转发到穿云 HTTP API。
穿云 V1
适用于浏览器能够访问、程序请求返回 403 的场景。V1 无需设置 x-cb-version，默认带动态代理，每次请求无状态。
穿云 V2
请求头设置 x-cb-version: 2。V2 必须提供固定或具有时效性的 x-cb-proxy；可用 Cookie 模式或 x-cb-part 管理会话，Turnstile 可配置 x-cb-sitekey。
穿云 V2s
能力与 V2 一致，并支持 stream 流式响应，适合大文件下载或边接收边处理；请求头使用 x-cb-version: 2s。
适用场景
服务于需要稳定网页访问的项目
在获得必要授权并遵守目标网站规则的前提下，将穿云API用于清晰、可审计的业务流程。
网页数据采集
获取公开页面内容，用于结构化整理、研究与业务分析。
价格与页面监控
定期检查商品、库存、公告或关键页面的公开变化。
自动化质量检测
验证不同网络环境中的页面可用性和返回结果。
AI 数据工作流
为经授权的检索、摘要和 Agent 任务提供网页内容输入。
积分套餐
穿云API套餐价格
根据每月请求规模和并发需求选择积分套餐。以下价格与 Cloudbypass 当前套餐保持一致。
请求失败不扣积分；成功请求消耗 1 点积分，穿云 V2 成功请求消耗 3 点积分。当前显示 1个月套餐。
基础套餐
$49/ 月
80,000 接口积分
- 有效期：30 天
- 并发线程：20 次/秒
标准套餐
$79/ 月
300,000 接口积分
- 有效期：30 天
- 并发线程：20 次/秒
高级套餐
$129/ 月
1,000,000 接口积分
- 有效期：30 天
- 并发线程：25 次/秒
专业套餐
$259/ 月
2,200,000 接口积分
- 有效期：30 天
- 并发线程：25 次/秒
高阶套餐
$489/ 月
4,600,000 接口积分
- 有效期：30 天
- 并发线程：30 次/秒
至尊套餐
$1056/ 月
12,000,000 接口积分
- 有效期：30 天
- 并发线程：30 次/秒
常见问题
了解穿云API
查看产品定位、版本选择、接入方式和响应状态等常见问题。
首次接入建议先阅读 Quickstart，并从小规模请求开始测试。
穿云API是一项基于 HTTPS 的网页访问接口。Python、Node.js、Go SDK 及本地代理工具最终都会把请求转发到穿云 HTTP API。
适合已获授权的数据采集、价格监控、内容聚合、质量检测和自动化测试等需要稳定获取公开网页内容的项目。使用时应遵守目标网站条款与适用法律。
HTTP API 是实际请求入口；官方 SDK 封装常用调用和错误处理；本地代理工具把原有代理请求转发到 HTTP API，适合 Java、采集器及复杂会话请求。
官方文档提供 Python、Node.js 和 Go SDK。其他能够发送 HTTPS 请求的语言可直接调用 HTTP API，并自行处理响应状态与错误。
浏览器可访问但程序请求返回 403 时可先测试 V1；遇到 JS 质询或 Turnstile 时使用 V2，并提供固定或具有时效性的代理；需要流式下载或边接收边处理时使用 V2s。
响应头 x-cb-status 为 ok 表示处理成功。失败时 HTTP API 返回 JSON 错误信息，其中包含请求 id、错误 code 和 message；使用 SDK 时会自动处理响应错误并抛出异常。
