> ## Documentation Index
> Fetch the complete documentation index at: https://help.b2proxy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 如何通过API提取使用不限量住宅代理？

B2Proxy 支持通过 **API 提取方式（IP 白名单认证）** 使用不限量住宅代理，无需账号密码，配置更安全也更稳定。本文将介绍如何添加白名单 IP，并通过 API 成功提取不限量住宅代理，帮助您快速完成配置并开始使用。

## 一、基础设置步骤

### 1. 添加IP白名单

<img src="https://mintcdn.com/cloudguidenetworktechnology/zVTMZNH2jZDe7QR_/images/%E7%99%BD%E5%90%8D%E5%8D%95IP.png?fit=max&auto=format&n=zVTMZNH2jZDe7QR_&q=85&s=193c94299b89e9702a7dd8102497f757" alt="白名单IP" width="1281" height="327" data-path="images/白名单IP.png" />

进入「白名单IP」，点击「添加白名单」，将需要使用住宅代理的网络环境对应的IP地址添加进去。

<Warning>
  注：未添加白名单的IP将无法调用API
</Warning>

### 2. 设置代理数量

输入需要提取的IP数量（例如：100个）

### 3. 协议与格式配置

协议：默认HTTP(S)，可选SOCKS5

格式：默认TXT（每行一个IP:端口），可选JSON

分隔符：默认回车换行

### **4. 选择会话类型**

轮换IP：每次请求自动更换IP，适合爬虫、数据采集。

粘性IP：IP保持固定一段时间（默认5分钟），适合账号管理等。

<Tip>
  选择粘性IP时，在 \[提前更换IP] 栏选择“是”，系统将根据IP实际可用时长自动提前切换；选择“否”，则IP在粘性时长内保持不变，直至时长结束才可更换。
</Tip>

### **5. 选择代理主机**

基于您的网络IP选择最近的服务器，也可手动选择其他节点。

### 6. 生成API链接

点击「生成API链接」按钮，系统返回唯一的API链接。

<img src="https://mintcdn.com/cloudguidenetworktechnology/FZFMYloLqLaZufUK/images/%E4%B8%8D%E9%99%90%E9%87%8F.png?fit=max&auto=format&n=FZFMYloLqLaZufUK&q=85&s=b5383780a74c0ede5985c5270087b223" alt="B2不限量api提取" lightAlt="B2不限量api提取" darkAlt="B2不限量api提取" className="dark:hidden" width="1287" height="313" data-path="images/不限量.png" />

<img src="https://mintcdn.com/cloudguidenetworktechnology/FZFMYloLqLaZufUK/images/%E4%B8%8D%E9%99%90%E9%87%8F-1.png?fit=max&auto=format&n=FZFMYloLqLaZufUK&q=85&s=b7b60cf0ba82a2b41205f68f3889e342" alt="B2不限量api提取" lightAlt="B2不限量api提取" darkAlt="B2不限量api提取" className="hidden dark:block" width="1287" height="313" data-path="images/不限量-1.png" />

## 二、调用API获取代理

在浏览器中打开API链接，或者在工具中配置API链接，正确的返回示例如下：

1.1.1.1:8888

2.2.2.2:8888

…

如果出现如下提示，则表示没有正确添加白名单，请返回第一步检查。

```text theme={null}
IP Whitelist Check Failed
```

注意事项：

<Warning>
  频率限制：1秒/次
</Warning>

<Warning>
  代理有效期：默认24小时，超时后需重新获取
</Warning>