本页目录
巨量IP动态代理包量套餐， 只有调用API提取 IP 的时候才扣减账户 IP 总额度 ，单纯访问网页不消耗额度。API接口支持 HTTP(S)/SOCKS5 代理提取，返回 TEXT 、 JSON 、 XML 三种格式，单次最高提取 200 个 IP ， API 调用上限 50 次 / 秒，支持多服务器分布式接入。
一、前置准备（必做）
1. 登录后台找到包量订单
登录巨量IP官网后台，进入【产品管理】 - 【动态代理（包量）】，找到已购买的包量订单，点击【生成提取链接】进入 API 配置页面。
2. 配置白名单（核心步骤）
包量套餐需要把服务器、本地电脑的外网IP添加到订单白名单，否则调用 API 会返回 407 无权限报错。
查询当前机器外网IP；
在API配置页点击【修改白名单】，添加外网 IP 并保存；
单订单最多支持5个白名单 IP ，多集群服务器超过 5 台，建议分开采购订单。
|
提示： 白名单添加完成后，等待1~3分钟生效。 |
3. API参数配置（后台可视化生成链接）
在生成API链接页面按需设置参数：
|
参数项 |
说明 |
|
提取数量num |
单次提取IP数量，上限 200 |
|
代理类型 |
HTTP/HTTPS 或者 SOCKS5 |
|
返回结果类型 |
TEXT / JSON / XML |
|
地区筛选 |
随机地区，或指定城市定向 |
|
IP存活周期 |
1/3/5/10/15/30/60分钟，按需选择 |
|
IP去重 |
开启24小时 IP 去重，避免短时间重复拿到相同 IP |
全部参数设置完成，点击【生成API链接】，复制生成好的完整接口地址。
二、API接口调用实操
1. 浏览器快速测试
直接复制生成的API链接，粘贴浏览器地址栏访问，页面会直接返回 IP 列表，快速验证接口是否正常。每一次刷新访问，都会提取 IP 并扣减包量额度。
2. Curl命令行测试（ Linux 服务器）
|
bash |
执行命令后即可输出IP代理信息，适合服务器快速调试接口连通性。
3. Python完整调用示例（爬虫常用）
|
python |
说明： JSON格式返回会包含 ip 、 port 、账号、密码、城市、剩余存活时间等完整字段，方便程序解析存入 IP 池。
三、配套API辅助接口（包量套餐可用）
查询剩余额度：查看订单剩余可提取IP总量
获取白名单列表：查看当前已授权机器IP
修改白名单：代码动态增删服务器IP
查看可用城市列表：筛选城市定向资源
四、API调用规范与额度规则
频率上限： API调用最高 50 次 / 秒，不要高频循环调用，建议按需提取，一次只拿当下业务需要的 IP ，大量提前预提取会导致 IP 失效浪费额度；
扣费逻辑：每一次API请求提取 IP ，就扣减对应数量包量额度 ；拿到IP之后访问目标网页，不会重复扣费；
IP轮换： 动态短效IP到达存活周期自动失效，需要再次调用 API 获取新 IP ；
额度有效期： 包量提取的IP额度有效期 1 年，到期自动失效。
五、常见报错排查
|
报错现象 |
排查方法 |
|
407 鉴权失败 |
IP不在白名单 / 账号密码鉴权失败，检查服务器外网 IP 是否添加白名单 |
|
429 Too Many Requests |
API调用频率超限，降低调用速率 |
|
返回无IP、额度不足 |
登录后台查看包量剩余IP额度 |
|
接口成功但代理无法访问 |
IP已过期，减少提前批量预提取 IP 数量 |
FAQ 常见问题
Q1：包量套餐 API 提取 IP ，多台服务器共用同一个订单可以吗？
A：可以，多台服务器外网 IP 全部添加到订单白名单，多台机器并发调用 API ，统一消耗该订单的总额度，白名单上限 5 个。
Q2： TEXT 和 JSON 返回格式怎么选？
A：简单脚本、快速查看选 TEXT ；需要程序解析城市、 IP 存活时间等结构化信息，优先 JSON 。
Q3：新用户可以测试 API 接口吗？
A：可以，前往免费试用页面申请测试额度，提前验证 API 连通、提取逻辑，正式采购前验证业务适配性。