提取动态住宅时先查询官方地区目录，再按国家、州省、城市层级传参。不要猜拼写，也不要自造用户名语法。不是城市落地页。不支持中国大陆。
要让动态住宅从某个国家或城市出去，应在提取凭据时传入文档支持的地区参数，而不是改用户名。本页按官方动态资源2接入指南说明：先查询平台提供的标准名称，不要自行猜测州/省或城市拼写。不传地区时，提取使用全球随机 IP。
这不是又一篇「该选哪个市场」的选型文，那篇见出口地区怎么选；也不是 `/locations/` 下的国家或城市落地页。已公布的国家页仍按地区一览与控制台库存为准。仅限授权目标。不支持中国大陆使用。
开始前备齐什么
| 准备项 | 从哪里来 |
|---|---|
| 动态账户 ID 与令牌 | 购买响应中的 `accountId`；令牌只放服务端。见提取凭据 |
| 目标市场 | 按你要查看的站点地区选择，而不是按你人在哪。见出口地区怎么选 |
| 标准地区名称 | 先调用文档中的国家、州/省、城市目录，不要手写猜测 |
| 静态固定出口 | 若需要订购期内固定 IP，请改用静态，不要靠提取参数代替 |
占位符（非生产）：主机 `proxy.example.invalid`，端口 `10000`，用户 `USER_EXAMPLE`，密码 `PASS_EXAMPLE_NOT_REAL`。账户 ID 示例 `ACCOUNT_ID_EXAMPLE`。下文城市名称取自官方文档示例，不代表该城市此刻有库存。
地区参数怎么叠
文档要求按「国家 → 州/省 → 城市」传递：
| 你想指定到哪一层 | 应传的参数 | 不要做的事 |
|---|---|---|
| 全球随机 | 不传 `country`、`state`、`city` | 不要为此自造用户名 |
| 只到国家 | 只传 `country`（例如文档中的两位代码 `US`） | 不要把中文国名或自造缩写当成代码 |
| 再到城市 | 同时传 `country`、`state` 和 `city` | 只传 `city`、不传国家和州/省 |
查询接口见文档：国家目录、按国家查州/省、再按国家与州/省查城市。`country` 使用目录返回的两位代码；`state` 和 `city` 使用目录中的标准名称。切换地区时，若你同时在用粘性会话，应换新的会话标识，见粘性会话。
带地区的提取示例
下面的州和城市名称来自官方文档示例。实际请求前，请先查目录，确认当前拼写与层级仍然有效。库存与是否可提取以接口和控制台为准。
export ZTPROXY_BASE="https://backend.ztproxy.net/api"
export ZTPROXY_TOKEN="TOKEN_EXAMPLE_NOT_REAL"
curl -X POST "$ZTPROXY_BASE/business/dynamic-accounts/ACCOUNT_ID_EXAMPLE/extract" \
-H "Authorization: Bearer $ZTPROXY_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"protocol": "socks5",
"country": "US",
"state": "California",
"city": "Los Angeles"
}'提取默认协议仍是文档中的 `socks5`。用 SOCKS5 访问 HTTPS 目标，不代表该提取路径已提供 HTTP 代理或 HTTPS CONNECT。拿回的主机、端口、用户名、密码要分字段使用。文档当前实现里，美国地区与其他地区的入口域名可能不同，以响应里的 host 为准。
常见误操作
| 误操作 | 为什么不行 |
|---|---|
| 猜测 `newyork` / `洛杉矶` 等拼写 | 文档要求使用目录中的标准名称 |
| 只传城市、不传国家和州/省 | 层级不完整，接口可能返回 400 |
| 在用户名里自造 `-country-us` | 客户端不应自行拼接用户名 |
| 把本页当成某个城市的产品页 | 城市是否可买、可提取，只以目录和控制台为准 |
| 指定地区后仍沿用旧的粘性会话 ID | 可能继续使用原地区出口；换地区应换会话 |
测通见curl 测通。协议总览见HTTP / SOCKS5。
合规与范围
只用于授权目标。不要把本页写成绕过限制的教程。价格以控制台与价格方案为准（动态约 $0.40/GB，100 TB 整包约 $0.20/GB；静态共享约 $1.50、独享约 $5 /IP/月）。USDT/USDC 可用；Visa/Mastercard 申请中。不支持中国大陆使用。
FAQ
不传地区会怎样？
文档写明：不传地区时使用全球随机 IP。
可以只传城市吗？
不可以。传 `city` 时必须同时传 `country` 和 `state`。
文档里的 Los Angeles 现在一定有库存吗？
不一定。那是文档中的调用示例。下单和提取前都要查当前目录与控制台。
为什么不能改用户名来选国家？
提取接口已经提供地区字段。官方说明要求使用完整返回的用户名，不要自行拼接。
这和静态住宅选城市有何不同？
静态订单在创建时使用产品查询返回的 `countryCode` 和 `cityCode`，并且是订购期内相对固定的 IP。动态提取的地区参数只影响当次领取的出口，不是静态 IP。见动态 vs 静态。
可以用来突破登录限制吗？
不可以。仅限合法授权目标。
换地区后出口为什么还是旧的？
如果仍在使用同一个粘性会话标识，文档提示可能继续使用原地区出口。换地区时应生成新的会话标识。
价格以哪里为准？
以控制台与价格方案为准。