穿云 API 采用基于请求结果和验证挑战的积分消耗方式。根据官方文档，V1、V2 每次请求成功后都会消耗 1 积分；使用 V2 时如果遇到并成功完成验证挑战，会额外消耗 2 积分。V2s 与 V2 使用方式一致，但支持 stream 流式响应，因此在积分理解上可以按 V2 场景来判断，同时结合控制台实际扣费记录核对。

1. 积分扣费标准

不同版本的积分消耗可以按“基础请求积分 + 验证挑战积分”来拆开理解：

示例：如果一次 V2/V2s 请求已经有可复用会话并直接成功返回，通常只按成功请求理解；如果这次请求触发了 JS 质询或 Turnstile，并且挑战成功，则会在成功请求基础上额外产生挑战积分。具体扣费请以控制台账单与官方规则为准。

2. 哪些验证会产生额外挑战积分？

官方文档列出的验证挑战包括：

• Cloudflare JS质询
• Cloudflare Turnstile
• Incapsula

验证挑战成功会立即扣除额外积分。如果后续响应阶段出现错误，已成功完成挑战产生的积分通常不会返还；但请求本身未成功时，不按成功请求扣取基础请求积分。

3. V2s 与积分消耗的关系

V2s 不是新的验证类型，而是 V2 的流式响应版本。它的请求头写法是 x-cb-version: 2s，其余参数与 V2 一致，例如 x-cb-proxy、x-cb-part、x-cb-sitekey 等。

因此，判断 V2s 消耗时可以先判断它是否触发了 V2 类验证：如果只是使用 V2s 下载一个已经通过会话验证的大文件，重点关注成功请求本身；如果 V2s 请求过程中还触发了 JS 质询、Turnstile 或 Incapsula，并且挑战成功，则需要把挑战额外积分一并考虑。

curl --request GET   --url "https://api.cloudbypass.com/files/report.zip"   --header "x-cb-apikey: YOUR_APIKEY"   --header "x-cb-host: target.com"   --header "x-cb-version: 2s"   --header "x-cb-proxy: http://user:pass@proxy-host:port"   --header "x-cb-timeout: 600"   --output report.zip

上面这个例子使用 V2s 是因为响应可能很大，需要流式下载；2s 本身代表流式响应，不代表一定额外扣挑战积分。是否出现挑战额外消耗，取决于目标站是否触发并成功完成验证挑战。

4. 会话保持与省积分建议

V2/V2s 支持通过 x-cb-part 做会话分区。验证通过后，Cloudflare Cookie 会在服务端会话分区内保留一段时间；在同一目标域名、同一代理和同一 part 下复用会话，可以减少重复挑战，从而降低额外挑战积分的产生概率。

• 同一业务流程尽量使用稳定代理 IP。
• 多线程请求建议分配不同 x-cb-part，避免同一分区并发挑战锁。
• Turnstile 场景先确认 x-cb-sitekey、[cf_token]、x-cb-action、x-cb-cdata 是否正确，避免重复失败和重复挑战。
• 大文件或长响应使用 V2s，并合理设置 x-cb-timeout，减少中途断开后重新挑战的可能。

5. 积分有效期与结算逻辑

• 有效期限制：积分需在规定有效期内使用，过期后会自动清空。
• 独立计算：每次充值的套餐通常独立计算有效期和额度，新充值积分不会延长旧积分有效期。
• 优先抵扣：系统会按照过期先后顺序扣除，优先消耗更早到期的积分。
• 账单核对：如需核对 V2/V2s 请求是否触发挑战扣费，请结合请求日志、x-cb-status、控制台积分明细一起判断。

快速测试工具

您可以先领取新手试用礼包，通过穿云 API 代码生成器生成 V2 或 V2s 接口代码，实测代理、会话保持、Turnstile 和流式响应场景下的积分消耗情况：

👉 点击使用：穿云 API 代码生成器

该工具支持 Python、Node.js、Go 等主流语言，可用于快速验证不同版本、代理和会话参数的实际效果。