高级住宅流量
按 GB 计费、流量不过期的高级住宅代理。任意动态住宅子账号在用户名里加 type-premium 即可接入,支持国家、州省、城市、设备操作系统定位和 1–120 分钟粘性会话。
高级住宅是另一条按 GB 计费的住宅线,流量单独计余额、不过期。它不需要单独的子账号:任何动态住宅子账号在用户名里加上 type-premium,这次连接就走高级住宅的线路和余额。
curl -x 'http://USERNAME-type-premium-country-US:PASSWORD@GATEWAY_HOST:58971' \
https://api.ipify.org
网关地址、端口、协议都和动态住宅一样,HTTP 和 SOCKS5 共用 58971。
和动态住宅的区别
| 动态住宅 | 高级住宅 | |
|---|---|---|
| 接入 | 用户名不带 type,或带 type-residential | 用户名带 type-premium |
| 余额 | 动态住宅流量池 | 独立的高级住宅余额 |
| 地区目录 | 动态住宅目录 | 高级住宅自己的目录 |
| 州省定位 | 支持 | 仅美国可以只定位到州省;其他国家要选到城市 |
| ASN 定位 | 支持 | 不支持 |
| 操作系统 | 支持 | 支持 |
| API 提取 | 支持 | 支持,加 product=premium,可带 os |
计费与购买
- 单位:GB。在控制台「高级住宅」页的「价格」标签购买。
- 阶梯单价:一次购买的 GB 数落在哪一档,整单都按那一档的单价计价。档位和单价以购买页为准。
- 单次购买:1–100,000 GB。
- 余额不过期,按用户累计,所有动态住宅子账号共用。
- 计费口径和动态住宅相同,只算隧道内成功转发的双向 payload,倍率 1:1。见 流量计费口径。
- 也可以用 流量 CDK 转出或兑换高级住宅流量。
支持的参数
| 参数 | 取值 | 说明 |
|---|---|---|
type | premium | 选择高级住宅;可以写在参数里的任意位置 |
country | 两位大写字母 | 可用国家以高级住宅的地区目录为准 |
state 或 region | 州省名称 | 美国可以单独使用;其他国家必须同时给 city |
city | 城市名称 | 需要同时给国家和州省 |
os | windows、android、ios、mac | 出口设备的操作系统 |
session + time | 同动态住宅,time 为 1–120 分钟 | 粘性会话 |
除 type 外,其余参数仍按 country → state/region → city → os → session → time 的顺序拼。完整规则见 用户名参数完整参考。
# 洛杉矶 + Windows 设备 + 30 分钟粘性
curl -x 'http://USERNAME-type-premium-country-US-state-California-city-Los%20Angeles-os-windows-session-job1-time-30:PASSWORD@GATEWAY_HOST:58971' \
https://api.ipify.org
# 美国以外要选到城市
curl -x 'http://USERNAME-type-premium-country-GB-state-England-city-London:PASSWORD@GATEWAY_HOST:58971' \
https://api.ipify.org
会话与轮换
和动态住宅一致:带 session + time 时,在时长内尽量保持同一个出口 IP;不带 session 时,每个新 TCP 连接重新分配出口。同一个 session 值在高级住宅和动态住宅之间是两个独立会话。见 粘性会话与轮换。
程序化提取
提取接口 加 product=premium 就提取高级住宅端口,还可以带 os:
curl 'https://api.example.com/api/v1/proxy/extract?apikey=YOUR_KEY&num=5&product=premium&country=US&os=windows&session=sticky&time=10'
用的是同一个代理账号的 API Key 和 IP 白名单,端口的流量从高级住宅余额扣。余额为 0 时返回 402 proxy_extract_traffic_exhausted。
访问限制
高级住宅限制访问政府网站、游戏主机网络和邮件端口等,详见 访问限制与使用规则。