OpenAI API Guide
如果你现在要接 OpenAI API，更稳的起点是直接从 Responses API 开始。原因很简单：它已经是 OpenAI 官方推荐的新项目默认入口，文本、image input、tool use 和多轮状态都能沿着同一条路线走。
先建立一个正确心智
对大多数新项目来说，可以先这样理解：
Responses API：新项目默认主入口Chat Completions：老项目兼容和渐进迁移路径Embeddings：检索、推荐、聚类等独立能力Assistants：更适合读旧代码和迁移盘点，不适合新项目默认起点
这能帮你少走很多“看旧教程看到一半才发现路线变了”的弯路。
这组 wiki 最适合谁
- 想把第一个 OpenAI 请求跑通的后端或全栈开发者
- 正在把 demo 升级成可上线接口的团队
- 想先决定默认 API 选型，再往下拆能力页的负责人
推荐阅读顺序
为什么现在优先 Responses API
按 OpenAI 官方迁移文档，Responses API 是新的统一 API primitive，新项目推荐优先使用。它的价值不只是“接口新”，而是它把：
- text generation
- image input
- function calling
- tool use
- 多轮链式交互
放进同一条更统一的接口心智里。
第一阶段真正要先跑通什么
别急着一次学完所有能力。对大多数团队来说，第一阶段只要把下面几件事做好就够了：
- 安全读取 API key
- 成功发出第一个
responses.create - 正确处理错误和限流
- 按需再补 streaming、tools 或 image input
先把这几件事跑通，比急着研究所有高级能力更有价值。
Official sources
- Quickstart: https://platform.openai.com/docs/quickstart
- Migrate to Responses: https://platform.openai.com/docs/guides/migrate-to-responses
- Models overview: https://platform.openai.com/docs/models
