如何在 OpenAI SDK 中使用 IPWO 代理

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

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

环境准备

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

拥有 IPWO 住宅代理账号
获取代理用户名和密码
获取代理服务器地址和端口
拥有 OpenAI API Key

示例代理信息：

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

Username: username
Password: password

Python 示例

安装依赖：

pip install openai httpx

创建客户端：

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 异步示例

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 示例

安装依赖：

npm install openai https-proxy-agent

创建客户端：

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：

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

Windows：

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

验证代理是否生效

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

使用 curl 测试：

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、云服务器或自动化工作流平台时，可统一使用系统代理配置，简化维护成本。