在使用OpenAI官方Python SDK调用接口时，由于网络环境限制，很多开发者需要通过代理访问API服务，但是错误的配置方式往往会导致代理无法生效，甚至出现连接超时、权限错误等问题。本文将从SDK配置和底层HTTPX配置两个层面，讲解正确的代理设置方法。
OpenAI官方SDK的代理配置方式
OpenAI官方Python SDK从0.27.0版本开始，支持通过http_client参数传入自定义的HTTP客户端，我们可以基于HTTPX创建配置了代理的客户端，再传递给SDK使用。
首先确保已经安装了必要的依赖：
# 安装OpenAI SDK和HTTPX pip install openai httpx
以下是配置HTTP代理的示例代码：
import openai
import httpx
# 配置代理地址，这里替换为你的实际代理地址
proxy_url = "http://127.0.0.1:7890"
# 创建HTTPX客户端，设置代理
http_client = httpx.Client(proxies=proxy_url)
# 将自定义客户端传入OpenAI客户端
client = openai.OpenAI(
api_key="your_api_key_here",
http_client=http_client
)
# 测试调用接口
response = client.chat.completions.create(
model="gpt-3.5-turbo",
messages=[{"role": "user", "content": "你好"}]
)
print(response.choices[0].message.content)
注意事项
- 代理地址格式需要正确，HTTP代理格式为
http://ip:端口，SOCKS5代理格式为socks5://ip:端口 - 如果代理需要认证，可以在地址中加入认证信息，例如
http://user:password@127.0.0.1:7890 - 确保代理服务处于运行状态，否则会出现连接拒绝的错误
直接使用HTTPX调用OpenAI API的代理配置
如果不使用官方SDK，直接通过HTTPX发送请求调用OpenAI API，配置方式更加直接，只需要给Client传入proxies参数即可。
import httpx
proxy_url = "http://127.0.0.1:7890"
headers = {
"Authorization": "Bearer your_api_key_here",
"Content-Type": "application/json"
}
payload = {
"model": "gpt-3.5-turbo",
"messages": [{"role": "user", "content": "你好"}]
}
# 创建带代理的HTTPX客户端
with httpx.Client(proxies=proxy_url) as client:
response = client.post(
"https://api.openai.com/v1/chat/completions",
headers=headers,
json=payload
)
print(response.json())
常见代理问题排查
| 问题现象 | 可能原因 | 解决方法 |
|---|---|---|
| 连接超时 | 代理服务未启动、代理地址错误、网络不通 | 检查代理服务状态，确认代理地址和端口正确，测试代理是否可访问 |
| 代理不生效，仍然直连 | 未正确传入自定义http_client、代理格式错误 | 确认SDK版本支持http_client参数，检查代理地址格式是否符合要求 |
| 认证失败 | 代理需要认证但未提供凭证、API密钥错误 | 在代理地址中加入认证信息，检查OpenAI API密钥是否正确 |
异步场景下的代理配置
如果使用异步方式调用，需要创建异步的HTTPX客户端，配置方式类似：
import openai
import httpx
proxy_url = "http://127.0.0.1:7890"
# 创建异步HTTPX客户端
async_http_client = httpx.AsyncClient(proxies=proxy_url)
# 传入异步客户端
async_client = openai.AsyncOpenAI(
api_key="your_api_key_here",
http_client=async_http_client
)
# 异步调用示例
import asyncio
async def main():
response = await async_client.chat.completions.create(
model="gpt-3.5-turbo",
messages=[{"role": "user", "content": "你好"}]
)
print(response.choices[0].message.content)
asyncio.run(main())
通过以上配置方式，基本可以覆盖大部分OpenAI API代理连接的使用场景，遇到问题时可以按照排查表格逐步检查，快速定位问题所在。
OpenAI_APIHTTPX代理配置Python修改时间：2026-06-21 19:15:23