一、核心结论先搞懂
/v1/chat/completions（旧 API）现在还能用、会维护，但 OpenAI 2025 年推出了新的 /v1/responses（Responses API）。官方建议：新项目优先用新 API，功能更全、是未来的统一接口；旧 API 没说要停用，可慢慢迁移。
二、官方怎么定位这两个 API？
- 新 API（Responses）：官方把它当核心接口，既有旧 API 的简单易用，又多了 “智能代理能力”—— 比如能直接用内置工具、支持文字 / 音频等多种内容形式、自动记会话上下文。
- 旧 API（Chat Completions）：仍在支持，但官方明确 “新项目推荐用 Responses”，还给了详细的迁移教程和例子。
三、旧 API（Chat Completions）还会更新吗？
会！2024 年还加了语音功能、支持音频的 GPT 模型（gpt-4o-audio-preview），2023 年底也加了新参数，说明一直在维护。但后续更厉害的功能，主要会更给新 API（Responses）。
四、新旧 API 核心差异（一看就懂）
| 对比维度 | 旧 API（Chat Completions） | 新 API（Responses） |
|---|---|---|
| 调用方式 | 需传 “消息列表数组” | 用统一的 “输入内容”（文字 / 消息列表）+ 专门的 “指令字段”，更清晰 |
| 会话记忆 | 自己手动保存上下文（比如之前的对话） | 打开 “存储开关” 就能让服务器记上下文，还支持多步推理，更省心 |
| 数据存储 | 新账户默认存记录，可关闭 | 默认存记录，也能关闭，还支持加密推理（更安全） |
| 可用工具 | 只能用自己写的自定义工具 | 自带网页搜索、文件搜索、代码运行、远程服务连接等工具，直接用 |
| 返回结果 | 结果在 “choices/message” 里 | 结果分类明确，还有 “快捷访问文本”，方便提取 |
五、关键时间线（别记错）
- 2025 年 3 月：Responses API 正式发布
- 2026 年 8 月 26 日：Assistants API（另一个旧 API）停用
- 旧 API（Chat Completions）：没说停用时间，继续用就行
六、实用建议（按自己情况选）
- 已经上线的旧 API 项目：不用急着改，继续运行没问题；
- 想加新功能（比如用内置工具、让系统记对话、更强的推理能力）：按官方教程，慢慢迁移到新 API；
- 担心数据安全（比如不想存对话记录）：新 API 支持 “不存储数据” 模式，还能加密，合规又好用。
