openai/openai-python

解决的问题

该库为 Python 开发者提供了便捷且类型安全的方式来与 OpenAI REST API 交互，无需手动构建 HTTP 请求即可访问 OpenAI 的模型和服务。

工作原理

它作为 OpenAI REST API 的封装器，基于 OpenAPI 规范生成。默认使用 HTTPX2 进行网络通信，提供同步和异步客户端（OpenAI 和 AsyncOpenAI）。该库通过 API 密钥或工作负载身份提供者（如 Kubernetes、Azure 和 GCP）处理认证，支持通过服务器发送事件（SSE）的流式响应，并提供 Pydantic 模型以实现结构化、类型检查的响应。

适用人群

构建集成 OpenAI AI 模型的应用程序的 Python 开发者，特别是需要高并发异步请求或在云环境中使用安全的企业级认证的用户。

主要亮点

• 多模态支持：通过响应和 Realtime API 支持文本、图像和音频的输入/输出。
• 灵活的认证方式：支持 API 密钥、工作负载身份联合（K8s、Azure、GCP）以及 X.509 相互 TLS。
• Realtime API：使用 WebSocket 实现低延迟、多模态的对话体验。
• 开发者体验：请求参数的完整类型定义，以及通过 Pydantic 和 TypedDict 实现的自动补全。
• 自动分页：简化对分页列表响应的迭代处理。
• Webhook 验证：内置工具用于验证和解包传入的 OpenAI Webhook 签名。