OpenAI Python SDK 是官方维护的客户端库，支持与 OpenAI REST API 交互。本文介绍安装方式、同步与异步客户端配置，演示 Responses API 和传统 Chat Completions 接口的调用方法，涵盖文本生成、JSON 格式约束、图片 URL 及 Base64 视觉分析，并提供高并发场景下的 aiohttp 后端优化建议。
OpenAI Python API 库为开发者提供了便捷访问 OpenAI 强大 AI 模型的能力。本文将详细介绍该库的各项功能，并通过代码示例展示如何使用。
OpenAI Python 库是一个官方维护的 Python 客户端，用于与 OpenAI REST API 交互。主要特点包括：
# 安装命令
pip install openai
# 异步增强版（含 aiohttp）
pip install openai[aiohttp]
两种使用 OpenAI Python SDK 与 GPT-4o 模型交互的方式
import os
from openai import OpenAI
client = OpenAI(api_key=os.environ.get("OPENAI_API_KEY"))
# 从环境变量读取 API 密钥
response = client.responses.create(
model="gpt-4o",
instructions="你是一个编程助手",
input="如何用 Python 检查对象类型？"
)
print(response.output_text)
带有嵌套参数的聊天请求
input: 消息列表（嵌套字典结构）response_format: 要求响应格式为 JSON 对象from openai import OpenAI
client = OpenAI()
response = client.responses.create(
input=[
{
"role": "user",
"content": "请给我讲解一下 RAG ?"
}
],
model="gpt-4o",
response_format={"type": "json_object"}
)
from openai import OpenAI
client = OpenAI()
completion = client.chat.completions.create(
model="gpt-4o",
messages=[
{"role": "system", "content": "你是一个编程助手"},
{"role": "user", "content": "如何用 Python 检查对象类型？"}
]
)
print(completion.choices[0].message.content)
OpenAI 的视觉模型可以分析图片内容
prompt = "这张图片有什么内容？"
img_url = "https://upload.wikimedia.org/wikipedia/commons/thumb/d/d5/2023_06_08_Raccoon1.jpg/1599px-2023_06_08_Raccoon1.jpg"
response = client.responses.create(
model="gpt-4o-mini",
input=[
{
"role": "user",
"content": [
{"type": "input_text", "text": prompt},
{"type": "input_image", "image_url": img_url}
]
}
]
)
import base64
from openai import OpenAI
client = OpenAI()
prompt = "这张图片有什么内容？"
with open("path/to/image.png", "rb") as image_file:
b64_image = base64.b64encode(image_file.read()).decode("utf-8")
response = client.responses.create(
model="gpt-4o-mini",
input=[
{
"role": "user",
"content": [
{"type": "input_text", "text": prompt},
{"type": "input_image", "image_url": f"data:image/png;base64,{b64_image}"}
]
}
]
)
以下展示了如何使用 OpenAI Python 库的异步客户端（AsyncOpenAI），以及如何配置不同的 HTTP 后端（httpx 或 aiohttp）。
两者主要区别在于 HTTP 库的选择，API 功能完全相同。aiohttp 在特定高并发场景下可能表现更好。
AsyncOpenAI 替代同步的 OpenAI 客户端await 关键字import os
import asyncio
from openai import AsyncOpenAI
client = AsyncOpenAI(
api_key=os.environ.get("OPENAI_API_KEY")
)
async def main() -> None:
response = await client.responses.create(
model="gpt-4o",
input="向一个非开发人员解释什么叫 RAG"
)
print(response.output_text)
asyncio.run(main())
httpx，但可切换至 aiohttp 提升并发性能http_client=DefaultAioHttpClient() 参数启用async with）中使用pip install openai[aiohttp]
import asyncio
from openai import DefaultAioHttpClient
from openai import AsyncOpenAI
async def main() -> None:
async with AsyncOpenAI(
api_key="My API Key",
http_client=DefaultAioHttpClient()
) as client:
chat_completion = await client.chat.completions.create(
messages=[
{"role": "user", "content": "Say this is a test"}
],
model="gpt-4o"
)
asyncio.run(main())
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具，curl 转代码在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online