Python调用OpenAI API需理解接口逻辑、处理响应结构、适配业务场景，并兼顾错误处理与成本控制；须用新版OpenAI()客户端、环境变量管理密钥、response_format参数确保JSON输出、分场景优化调用方式并遵守合规要求。
Python调用OpenAI API不是单纯发个请求就完事，关键在于理解接口逻辑、处理响应结构、适配业务场景，并兼顾错误处理与成本控制。
快速接入：从环境配置到基础调用
先确保安装官方SDK：pip install openai。OpenAI已弃用旧版openai.ChatCompletion.create等方法，统一使用OpenAI()客户端实例。API密钥需通过环境变量设置（OPENAI_API_KEY），避免硬编码。
最简文本生成示例：
from openai import OpenAI
client = OpenAI()
response = client.chat.completions.create(
model="gpt-4o",
messages=[{"role": "user", "content": "用一句话解释量子纠缠"}]
)
print(response.choices[0].message.content)
结构化输出：让大模型返回可解析的JSON
直接让模型“返回JSON”不可靠，容易格式错乱或含解释文字。推荐使用response_format={"type": "json_object"}参数（需搭配支持的模型如gpt-4o、gpt-3.5-turbo-0125），并配合明确的system prompt约束结构。
立即学习“Python免费学习笔记（深入）”；
- 在system消息中声明字段名、类型和约束，例如：“你只能输出严格符合以下JSON Schema的对象，不要任何额外说明：{"summary": "string", "keywords": ["string"]}
- 调用时传入
response_format={"type": "json_object"}，API会自动校验格式并重试 - 用
json.loads(response.choices[0].message.content)安全解析，建议加try-except捕获JSONDecodeError
实际场景落地：三类高频应用模式
智能客服问答：不直接转发用户问题，而是先做意图识别+上下文摘要（如用少量shot示例引导模型分类），再路由到知识库检索或模板回复，降低幻觉风险。
批量内容生成：处理Excel或CSV时，避免单条请求串行调用。改用异步并发（asyncio + client.chat.completions.create）或批量封装（如一次请求生成多个变体），注意速率限制（RPM/TPM）和token预算。
代码辅助与重构：给定函数片段+注释要求，让模型补全、加类型提示或转成另一种语言。关键是提供清晰输入输出示例（few-shot），并用temperature=0.1抑制随机性，保证结果稳定可测试。
避坑要点：稳定性、成本与合规
- 始终检查
response.choices[0].finish_reason——等于"length"说明被截断，需调整max_tokens或拆分逻辑 - 记录每次请求的
usage.prompt_tokens和completion_tokens，按月统计，及时发现异常增长 - 敏感数据不出境：国内用户注意API调用是否走国际节点；涉及个人信息时，务必脱敏或使用本地部署模型替代
- 超时与重试：设置
timeout=30，对429（限流）、500（服务端错误）实现指数退避重试
