openai-python — Official OpenAI Python SDK

简介

在 Python 3.9+ 中以同步/异步方式调用 OpenAI REST API，并获得类型化的请求/响应模型；适合作为 agent 与后端服务的核心 SDK，并便于集中管理重试/超时与日志。

• 适合谁（Best for）: 做 LLM 应用的 Python 开发者，希望使用类型化 client 并保持稳定升级路径
• 兼容工具（Works with）: Python 3.9+、OpenAI API、基于 httpx 的同步/异步 client
• 安装时间（Setup time）: 6 分钟

量化信息

• 跑通约 6 分钟（pip 安装 + 配 API key + 一次请求）
• GitHub stars + forks（已核验）：见「来源与感谢」
• Python 版本要求：3.9+（仓库说明）

实战要点

建议把 SDK 使用封装在一层很薄的适配器里（一个模块），避免升级时全局改动。统一配置 timeout/重试并记录 request_id。做 agent 时要收敛工具 schema，并对模型输出做校验后再执行。

安全提示： 不要把 API key 写死在代码里；用环境变量/密钥管理，并清理日志中的敏感信息。

FAQ

Q: 导入库需要 API key 吗？ A: 不需要。创建 client/导入不依赖 key；调用 API 才需要。

Q: 支持异步吗？ A: 支持，提供同步与异步 client。

Q: 怎么处理限流？ A: 用重试/退避策略，能批量就批量，并记录 request_id 便于排障。