API 提取：用账户令牌调用开放接口，返回代理字符串。 它不替代账密认证。令牌过的是控制台接口，用户名密码过的是代理网关。
网页出口仍先接动态住宅。字段和鉴权以文档为准，本篇只判断什么时候该用 API。
API 提取是什么、不是什么？
是：个人中心复制 API 令牌，请求头带 X-Api-Key，调用开放接口生成一批代理串。动态住宅对应文档里的 ipType = 1，动态机房是 2，动态移动是 3。rotation：1 粘性、2 随机。protocolType：1 HTTP(S)、2 SOCKS5。proxyFormat 决定串的排列：HOST:PORT:USER:PASS、HOST:PORT@USER:PASS、USER:PASS:HOST:PORT、USER:PASS@HOST:PORT。国家、省、城市代码来自对应列表接口的 isoCode，不要手编未出现的码。
不是：换一种更「高级」的住宅池。也不是把令牌填进 curl 的 -x。令牌错了，接口返回业务码 40101（HTTP 往往仍是 200）；代理账密错了，才是 407。两种失败不要交叉改。
返回串里的用户名密码送给网关，和令牌不是一组。API 只负责把串造出来。报 407 时按407代理认证失败排，不要重签令牌。
动态住宅按 GB，起步 $0.79/GB。池是 超9000万合规采集，国家按控制台在线列表选（公开页写 195+）。接口不能生成未在线的国家或城市。网络成功率 99.97%、7×24 监控管连通，不管脚本有没有把返回串接对。
什么时候该用 API，什么时候复制就行？
该用：要按任务批量生成、定时换一批、或用子账号用户名去生成（文档里的 username，空则主账号）。控制台点一次也能生成，但人没法跟着脚本跑。
复制就行：只在本机测通、只给浏览器扩展填一条。先用 curl使用代理 对返回串测出口，再写进业务。
不要用 API 去写绕过访问控制的采集。频率、条款和 KYC 仍由你负责。令牌能生成代理、也能消耗流量，不要提交到公开仓库。重新生成后，旧令牌立即失效。
鉴权步骤在 Open API 鉴权。生成字段在 Open API 接口。帮助中心只讲窗口，不讲接口路径。基址以文档示例为准，不要把网站域名当成 API 主机。
一次请求只生成文档允许的条数。要更多，分次调用，不要把 proxyCount 写成未公布的上限。返回的 proxies 数组按你选的 proxyFormat 排列，脚本解析时不要假设永远是冒号四段。
对上了令牌，返回却不能用，先改哪？
- JSON 的
code不是 0：先读msg。40101换令牌；地理字段不在列表里换在线的countryCode/cityCode；流量不够去控制台加量，不要改协议碰运气。 proxies有串，curl 407：串里的用户名密码和网关认证有关，与令牌无关。回到账密和白名单，不要重签 API。- 随机模式只要 1 条、粘性最多 50 条：文档写明的上限。超过会按接口错误返回，不是池「超9000万」不够用。
- 粘性时长：
ipDuration单位是分钟，文档范围 1–120。对方说的短效 / 长效 / 包时，用粘性、按 GB、按 IP 理解；API 不会卖出未公布的包时套餐。
套餐以定价为准。只在官方网站购买，开始使用无需信用卡。