OpenAI API 简介

如果你现在要接 OpenAI API，我建议直接从 Responses API 开始。原因很简单：它已经是官方主推入口，文本、多模态、工具调用和流式输出都能往这个接口上收。

#先建立一个正确心智

OpenAI API 现在不是“很多分散的小接口，自己慢慢拼”。更实用的理解是：

• Responses API：主入口，适合新项目
• Chat Completions：兼容历史代码，仍支持，但不是官方推荐起点
• Embeddings：做检索、推荐、聚类时单独使用

这能帮你少走一个弯路。很多人一上来还在找 Assistants、Chat、Vision 各自的旧最佳实践，结果读到一半发现路线已经变了。

#这页最适合谁

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

#先看什么

如果你是新项目，顺序我建议这样走：

1. 先看 快速开始
2. 再看 认证配置
3. 然后按需求选 流式输出、函数调用、视觉能力

#为什么现在优先 Responses API

根据 OpenAI 官方迁移文档，Responses API 是面向未来的主接口，官方也明确建议新项目优先迁移或直接从这里开始。

它适合做这些事：

• 普通文本生成
• 图像输入理解
• 工具调用
• 流式输出
• 更接近 agent 工作流的交互

这类统一入口对工程团队的好处很实际：接口面更少，默认模板更容易统一。

#模型怎么选更稳

模型名会持续变，但选择逻辑其实没那么复杂：

• 复杂推理、代码和 agent 任务：先看 GPT-5 系列
• 高并发、预算敏感：看 mini / nano
• 非推理但要低延迟和长上下文：可以看 GPT-4.1 系列

我不建议在首页把所有型号、价格和能力表写得太死。这个信息变化快，最好以官方模型页和 pricing 页为准：

• https://platform.openai.com/docs/models↗
• https://platform.openai.com/pricing↗

#一个最小请求

python复制
from openai import OpenAI

client = OpenAI()

response = client.responses.create(
    model="gpt-5.2",
    input="用一句话解释什么是 API"
)

print(response.output_text)

#你真正需要先掌握的，不是全部能力

对大多数团队来说，第一阶段只要把下面四件事跑通就够了：

1. 安全读取 API key
2. 成功发出第一个 responses.create
3. 处理错误和限流
4. 需要时再补 streaming 或 tools

先把这四件事做好，比急着研究一堆高级能力更有价值。

#关于 Assistants API

如果你搜到很多旧教程提 Assistants、Threads、Runs，要注意时间点。OpenAI 官方已经给出从 Assistants 迁移到 Responses 的文档，并说明 Assistants API 已弃用，关闭日期是 2026-08-26。

所以这类资料更适合“读旧代码”或“做迁移”，不适合新项目当默认方案。

#官方参考

• Developer 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↗

python复制
import tiktoken

encoding = tiktoken.encoding_for_model("gpt-5.2")
tokens = encoding.encode("Hello, world!")
print(f"Token 数量: {len(tokens)}")

#常见问题

#API 调用失败？

1. 检查 API Key 是否正确
2. 确认账户余额充足
3. 检查网络连接（可能需要代理）

#响应太慢？

1. 减少 max_tokens
2. 使用 gpt-5-mini 代替 gpt-5.2
3. 启用流式输出

#超出速率限制？

1. 实现重试机制
2. 使用指数退避
3. 升级账户 tier

一句轻松版总结：
API 接入就像开餐厅，模型是厨房，Prompt 是菜单，日志与重试是后厨流程。
菜好吃靠厨师，出餐稳定靠系统。

#下一步

• 快速开始 - 详细的入门教程
• Function Calling - 学习函数调用
• Embeddings - 构建语义搜索

---

提示：OpenAI 经常更新模型，关注 官方更新日志↗ 了解最新功能。