跳到主要内容
NexCaptcha

产品

过盾 API:直接拿页面,不是拿 token

自动化 API 是一个 header 驱动的 HTTP 网关。请求照原样发给网关,真实目标写在 header 里,网关过盾之后把源站的状态码、响应头、响应体原封返回。没有任务对象,也不用轮询,采集逻辑已经写好的代码只需要改一个收件地址。

返回给你

目标页面的原始响应

看另一个产品

[ 01 ]一次请求怎么走

一次请求怎么走

两个产品的全部区别,就在你的请求停在哪一步。

  1. 01

    只改收件地址,请求本身不动

    method、path、query、body 全部保持原样,真实域名放进 x-nc-host,key 放进 x-nc-key,请求发给网关,不再直接发给源站。

  2. 02

    网关负责过盾

    x-nc-fingerprint 指定 TLS 与浏览器指纹,x-nc-proxy 用你自己的出口 IP 发出去。整页拦截在网关内部处理完,流程中途冒出来的验证码直接转给识别引擎,请求不用退回来重发。

  3. 03

    拿回目标页面的响应

    状态码、响应头、响应体按源站原样返回,content-length 按解码后的长度修正。响应头里的 x-nc-status: ok 表示这一次过盾成功,也只有这种请求计费。

  4. 04

    复用已经过盾的 session

    x-nc-session 按你自己给的编号做会话分区,同一个编号下的后续页面复用已经清场的状态,不用每个 URL 都重新过一次盾。

[ 02 ]能过什么

能过什么

  • Cloudflare 5秒盾直接返回拦截页后面的页面内容,不用你自己拿 cf_clearance 再绑 IP。
  • Cloudflare Turnstile组件在会话内识别完并注入结果,后续请求直接放行。
  • DataDome拦截页和滑块都在网关内处理,datadome cookie 留在 session 上。
  • Imperva Incapsula___utmvc 那段引导脚本在服务端跑完,reese84 的交换过程你看不到。
  • Akamai Bot Manager按会话生成 sensor data,_abck cookie 由网关维护。
  • Kasadax-kpsdk 系列 header 由网关生成并续期,不用客户端参与。
  • PerimeterX / HUMAN长按验证在网关内完成,_px 系列 cookie 跟着 session 走。
  • AWS WAF 验证码token 生成后附在请求上重放到源站。
  • 嵌入式验证码流程中途出现的 reCAPTCHA、hCaptcha、极验 转给识别引擎,结果回到同一个请求里。

[ 03 ]你会得到什么

你会得到什么

50,000

次 / 分钟

并发

默认 key 支持每分钟 50,000 次请求,没有按秒的硬顶,也不用为了绕开上限去写排队逻辑。需要更高按账号调整,不做成套餐档位。

4.8 秒

p50,p95 为 11.2 秒

过盾耗时

从请求进入到源站响应返回的全链路统计,取自线上流量。

99.4%

过盾并返回

识别成功率

成功带回源站响应的请求占比,其余返回错误体,识别失败不计费。

余额不过期

充的是余额不是月度套餐,没用完不清零,两条产品线共用同一个余额。

[ 04 ]五行代码接入

五行代码接入

fetch.sh
# path 和 query 还是目标站的,变的只有 host。
curl -s "https://gateway.nexcaptcha.net/product/12345?ref=list" \
  -H "x-nc-key: YOUR_API_KEY" \
  -H "x-nc-host: shop.example.com" \
  -H "x-nc-fingerprint: chrome-131-win" \
  -H "x-nc-proxy: http://user:[email protected]:8000" \
  -H "x-nc-session: catalog-42" \
  -D headers.txt -o page.html

# headers.txt 里出现 x-nc-status: ok,表示这次过盾成功,这一次才计费。
# page.html 就是浏览器访问 shop.example.com 会拿到的那个页面。

[ 05 ]怎么收费

怎么收费

两条产品线共用一张价目表,按每千次成功请求计费,价格由页面实际出的题决定:图形验证码 $0.75,reCAPTCHA v2 $1.50,Turnstile 与 DataDome $2.18,Cloudflare 5秒盾、极验4代、Akamai、Kasada、PerimeterX $4.49。走网关不加价,同一个盾、同一个页面,取响应和取 token 是一个价,识别失败不计费。

完整价目表

[ 06 ]怎么选

怎么选

什么时候选它

  • 整页被拦下,你要的只是页面 HTML,不想再处理 token 怎么带进去。
  • 采集端就是普通 HTTP 客户端,不想为了让 token 被接受而去对齐 TLS 指纹、cookie、User-Agent。
  • 一次过盾要走很多页,x-nc-session 把已清场的状态带过去,后续页面不重复收费。
  • 用 Playwright、Puppeteer、Selenium 驱动浏览器,希望盾在浏览器下面这一层就解决,走上游 proxy 模式接入。

什么时候选另一个

  • 验证码在表单里,提交这个表单用的是你自己的 session,请求必须从你自己的 IP 发出去。
  • 你要的就是 token 本身,拿去给别的东西用,比如 App 客户端、队列、内部服务。
  • 页面本来就能正常打开,挡路的只是一个独立组件,比如 reCAPTCHA、极验、图形验证码。
  • 现有流程已经按 createTask / getTaskResult 写好了,缺的只是识别这一步。
自动化打码

[ 07 ]关于这一项的常见问题

关于这一项的常见问题

看你的请求想停在哪一步。要的是页面,用自动化 API,请求发过去,回来的是源站响应。要的是 token,由你自己的 session 和 IP 去提交,用自动化打码接口。底层是同一批识别资源,价格一样,区别只在停在哪。

不加价。两条线都按每千次成功请求计费,价格看实际遇到的题,用的是同一张价目表。Cloudflare 5秒盾 都是每千次 $4.49,网关替你过完盾给页面,和你自己拿 cf_clearance 再带进请求,价钱一样,识别失败不计费。

可以。除了 header 模式,还提供上游 proxy 模式,把浏览器的 proxy 指到网关,proxy 用户名填 API key,盾在浏览器下面这一层就过掉,页面选择器不用改。纯 HTTP 客户端不起浏览器的,继续用 header 模式即可。

一次请求一起处理完。网关先过传输层的盾,页面接着渲染出 reCAPTCHA、hCaptcha 或者 极验 时,这道题转给识别引擎,答案注入后请求继续发往源站。计费看实际识别的那道题,一次请求里触发两道,按较高的那一档收一次,不叠加。

过盾 解决的是请求根本进不去,整页被拦,返回 403 或者一直转圈,这种交给自动化 API,拿回的是页面本身。打码 解决的是页面能打开,但表单里有一道题,要的是 g-recaptcha-response、cf-turnstile-response 这类 token,交给自动化打码接口,token 由你自己带进请求提交。同一个站点上两件事经常一起出现,两条线用的是同一个余额。

第一千次识别,我们请。

创建密钥,粘进上面的示例代码,看着真实的 token 返回。不用绑卡,没有销售电话。