OpenAI API 开发指南 | Wiki | JR Academy

OpenAI API Guide

如果你现在要接 OpenAI API，更稳的起点是直接从 Responses API 开始。原因很简单：它已经是 OpenAI 官方推荐的新项目默认入口，文本、image input、tool use 和多轮状态都能沿着同一条路线走。

先建立一个正确心智

对大多数新项目来说，可以先这样理解：

• Responses API：新项目默认主入口
• Chat Completions：老项目兼容和渐进迁移路径
• Embeddings：检索、推荐、聚类等独立能力
• Assistants：更适合读旧代码和迁移盘点，不适合新项目默认起点

这能帮你少走很多“看旧教程看到一半才发现路线变了”的弯路。

这组 wiki 最适合谁

• 想把第一个 OpenAI 请求跑通的后端或全栈开发者
• 正在把 demo 升级成可上线接口的团队
• 想先决定默认 API 选型，再往下拆能力页的负责人

推荐阅读顺序

1. Quickstart
2. Authentication
3. Chat basics
4. Streaming
5. Function calling
6. Vision

为什么现在优先 Responses API

按 OpenAI 官方迁移文档，Responses API 是新的统一 API primitive，新项目推荐优先使用。它的价值不只是“接口新”，而是它把：

• text generation
• image input
• function calling
• tool use
• 多轮链式交互

放进同一条更统一的接口心智里。

第一阶段真正要先跑通什么

别急着一次学完所有能力。对大多数团队来说，第一阶段只要把下面几件事做好就够了：

1. 安全读取 API key
2. 成功发出第一个 responses.create
3. 正确处理错误和限流
4. 按需再补 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