OpenAI Python API 使用指南：基础功能与异步处理

三、视觉功能

OpenAI 的视觉模型可以分析图片内容

1. 使用图片 URL

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}
            ]
        }
    ]
)

2. 使用 Base64 编码图片

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 在特定高并发场景下可能表现更好。

1. 基础异步用法

• 使用 AsyncOpenAI 替代同步的 OpenAI 客户端
• 每个 API 调用需配合 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())

2. 使用 aiohttp 后端

• 默认使用 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())