第六部分,OpenAI SDK 与 API

OpenAI Python SDK

安装 Python SDK,通过 Responses API 发起请求,并为超时、重试和异常建立基础处理。

安装并调用 Responses API

在虚拟环境中安装 openai 包,避免污染系统 Python。OpenAI 客户端默认读取 OPENAI_API_KEY。下面示例使用当前推荐模型系列,实际部署前应核对模型目录。

output_text 是 SDK 对文本输出的便捷聚合。需要处理工具调用、结构化数据或多模态项目时,应遍历完整 output。

bash
python -m venv .venv
# macOS 或 Linux
source .venv/bin/activate
pip install openai
python
from openai import OpenAI

client = OpenAI()
response = client.responses.create(
    model="gpt-5.6",
    input="用三条建议解释如何写可测试的 Python 函数。",
)
print(response.output_text)

生产封装

  • 复用客户端,不要为每次请求重复创建连接。
  • 捕获超时、连接、速率限制和服务端错误。
  • 只对可安全重试的请求使用指数退避。
  • 对输入长度和输出 schema 做应用层校验。
  • 日志中保留请求标识,敏感内容脱敏。

官方资料

本页由 xueai 根据 OpenAI 官方资料重新组织并用中文讲解。产品会持续更新,涉及版本、模型和命令时请同时核对下列官方页面。