> For the complete documentation index, see [llms.txt](https://docs.ipwo.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ipwo.net/kai-fa-zhe-wen-dang/ai-agent-kai-fa/ru-he-zai-openai-sdk-zhong-shi-yong-ipwo-dai-li.md).

# 如何在 OpenAI SDK 中使用 IPWO 代理

在部分网络环境下，开发者可能需要通过代理服务器访问 OpenAI API。通过配置 IPWO 住宅代理，可以为 OpenAI SDK 提供稳定的网络连接，并根据业务需求选择不同国家或地区的出口 IP。

本文将介绍如何在 Python 和 Node.js 环境中为 OpenAI SDK 配置 IPWO 代理。

***

### 环境准备

在开始之前，请确保您已经：

* 拥有 [IPWO 住宅代理账号](/readme/zhu-ce-deng-lu.md)
* [获取代理用户名和密码](/kai-fa-zhe-wen-dang/kuai-su-kai-shi/huo-qu-dai-li-xin-xi.md)
* 获取代理服务器地址和端口
* 拥有 OpenAI API Key

示例代理信息：

```
Proxy Host: us.ipwo.net
Proxy Port: 7878

Username: username
Password: password
```

***

### Python 示例

安装依赖：

```bash
pip install openai httpx
```

创建客户端：

```python
from openai import OpenAI
import httpx

proxy_url = "http://username:password@us.ipwo.net:7878"

http_client = httpx.Client(
    proxy=proxy_url
)

client = OpenAI(
    api_key="YOUR_OPENAI_API_KEY",
    http_client=http_client
)

response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[
        {
            "role": "user",
            "content": "Hello"
        }
    ]
)

print(response.choices[0].message.content)
```

***

### Python 异步示例

```python
from openai import AsyncOpenAI
import httpx
import asyncio

proxy_url = "http://username:password@us.ipwo.net:7878"

async def main():
    async_client = httpx.AsyncClient(
        proxy=proxy_url
    )

    client = AsyncOpenAI(
        api_key="YOUR_OPENAI_API_KEY",
        http_client=async_client
    )

    response = await client.chat.completions.create(
        model="gpt-4o-mini",
        messages=[
            {
                "role": "user",
                "content": "Hello"
            }
        ]
    )

    print(response.choices[0].message.content)

asyncio.run(main())
```

***

### Node.js 示例

安装依赖：

```bash
npm install openai https-proxy-agent
```

创建客户端：

```javascript
import OpenAI from "openai";
import { HttpsProxyAgent } from "https-proxy-agent";

const proxyAgent = new HttpsProxyAgent(
  "http://username:password@us.ipwo.net:7878"
);

const client = new OpenAI({
  apiKey: process.env.OPENAI_API_KEY,
  httpAgent: proxyAgent
});

const response = await client.chat.completions.create({
  model: "gpt-4o-mini",
  messages: [
    {
      role: "user",
      content: "Hello"
    }
  ]
});

console.log(response.choices[0].message.content);
```

***

### 使用环境变量配置代理

部分应用程序会自动读取系统代理配置。

Linux/macOS：

```bash
export HTTP_PROXY=http://username:password@us.ipwo.net:7878
export HTTPS_PROXY=http://username:password@us.ipwo.net:7878
```

Windows：

```cmd
set HTTP_PROXY=http://username:password@us.ipwo.net:7878
set HTTPS_PROXY=http://username:password@us.ipwo.net:7878
```

***

### [验证代理](/kai-fa-zhe-wen-dang/kuai-su-kai-shi/kuai-su-yan-zheng.md)是否生效

在调用 OpenAI API 之前，可以先验证代理连接是否正常。

使用 curl 测试：

```bash
curl -x "us.ipwo.net:7878" \
-U "username:password" \
ipinfo.io
```

返回结果中应显示代理出口 IP 的地理位置和网络运营商信息。

***

### 常见问题

#### 出现 Connection Timeout

可能原因：

* 本地网络无法访问代理节点
* 代理账号已过期
* 防火墙拦截连接

建议：

* 检查代理账号状态
* 更换网络环境后重试
* 使用 curl 测试代理连接

***

#### 出现 Authentication Failed

可能原因：

* 用户名错误
* 密码错误
* 代理认证信息格式不正确

建议检查：

```
username
password
host
port
```

是否与控制台提供的信息一致。

***

#### OpenAI API 返回 401

此错误通常与 OpenAI API Key 有关，而非代理配置问题。

请检查：

```
OPENAI_API_KEY
```

是否有效，并确认账户具备对应模型的调用权限。

***

### 最佳实践

* 长时间运行的 AI 应用建议使用 Sticky Session 保持连接稳定。
* 高并发请求建议合理控制请求频率，避免短时间内建立大量连接。
* 在生产环境中，建议通过环境变量管理 API Key 和代理凭证，避免硬编码敏感信息。
* 部署在 Docker、云服务器或自动化工作流平台时，可统一使用系统代理配置，简化维护成本。

***

### 相关阅读

如果您正在构建 AI 应用或自动化工作流，以下内容可能对您有所帮助：

* [获取和配置住宅代理](/kai-fa-zhe-wen-dang/kuai-su-kai-shi/huo-qu-dai-li-xin-xi.md)
* [如何检测代理是否生效](/dai-li-jian-ce-yu-yin-si-an-quan/ru-he-jian-ce-dai-li-shi-fou-sheng-xiao.md)
* [Claude API 使用代理](/kai-fa-zhe-wen-dang/ai-agent-kai-fa/ru-he-zai-claude-api-zhong-shi-yong-ipwo-dai-li.md)
* [Gemini API 使用代理](/kai-fa-zhe-wen-dang/ai-agent-kai-fa/ru-he-zai-gemini-api-zhong-shi-yong-ipwo-dai-li.md)
* [Python 使用住宅代理](/kai-fa-zhe-wen-dang/dai-ma-shi-li/python.md)
* [Node.js 使用住宅代理](/kai-fa-zhe-wen-dang/dai-ma-shi-li/node.js.md)
* [cURL 使用住宅代理](/kai-fa-zhe-wen-dang/dai-ma-shi-li/curl-dai-ma-shi-li.md)