Skip to content
AI Blog

ChatGPT / OpenAI 开发指南总览

最后更新：2026-08-12· 14 分钟阅读

🚀 快速通道

  • ChatGPT 国内版：点击直达↗
  • 稳定镜像站：打开镜像↗
  • 官方 ChatGPT：chatgpt.com ↗

ChatGPT / OpenAI 开发指南总览

更新时间：2026-09-17。旗舰模型跟进见 GPT-6 Astra（gpt-6-astra）换挡上手。

导读

OpenAI 生态里至少有三层容易混淆：ChatGPT 网页 面向终端用户，OpenAI Platform 面向开发者（Key、账单、Playground），REST / SDK 才是你代码真正调用的接口。接口形态仍在演进：Responses API 是当前 Quickstart 常指向的新入口，Chat Completions 承载大量存量集成，Assistants API 则可能处于维护或迁移期。本文是本系列「地图页」——帮你建立术语、选型与阅读顺序。model ID、端点、价格以 官方文档 与 定价页 为准。

开发者该走哪条路？

要把 GPT 接进产品 / 脚本 / 后台？
  ├─ 是 → Platform 开 Key → 读 Quickstart → 选 Responses 或 Completions
  └─ 否 → 只聊天 → chatgpt.com 或 [本站 Chat 体验](https://app.chatgpt-blog.net/zh-cn/chat/)
            （体验入口不能替代 API Key）
目标推荐路径常见误区
客服机器人、内容审核Platform + API把 ChatGPT Plus 当 API 额度
批量摘要、离线任务API + Batch（若适用）人工在网页复制粘贴
试 prompt、写文档ChatGPT 网页 / Playground未评测就上生产
带文件的知识库 POC先查文档：Responses / Assistants不看 deprecation 直接选型

本系列阅读顺序

顺序文章你会得到什么
1本文全局地图与术语
2Platform 开发文档概览控制台与文档结构
3API 快速入门第一条 API 请求
4ChatGPT API 开发指南鉴权、限流、生产清单
5文本生成参数与结构化输出
6Prompt Engineering可评测的提示词工程
7Assistants API历史方案与迁移注意
8+Embeddings、Vision、Speech 等按模块深入

核心术语（5 分钟建立共同语言）

术语含义开发注意
API KeyPlatform 颁发的 sk-... 密钥仅服务端；按环境分 Key
Model ID如 gpt-4o-mini（示例）上线前查 Models 页，勿抄旧文
Token计费与上下文单位输入含 system、RAG、工具定义
Chat Completions/v1/chat/completionsmessages 数组由你维护
Responses API/v1/responses新项优先对照 Quickstart
AssistantsAssistant / Thread / Run可能 legacy，见专门指南
Rate limitRPM / TPM 配额429 需退避，非 Key 错误

API 表面对照：新项目怎么选

接口典型端点会话状态新建项目
Responses API/v1/responses通常无状态（input 自管）优先跟随官方 Quickstart
Chat Completions/v1/chat/completions自管 messages存量可留；新功能查迁移
Assistants API/v1/assistants 等OpenAI 存 Thread先读 deprecation，再决定
Embeddings/v1/embeddings无RAG 检索层

深度对比：Responses API 中文指南；维护 Assistants 存量：Assistants 开发指南。

能力模块与系列文章

业务需求对应指南
文本问答、JSON 抽取text-generation
稳定 prompt、回归测试prompt-engineering
语义搜索、RAGembeddings
读图、OCRvision
语音合成 / 识别speech
文生图image-generation
多步 Agentagents-sdk
领域微调fine-tuning

跨厂商接入：OpenAI 在栈里的位置

若团队同时接 Claude、Gemini，网关层建议：

  • 鉴权分离：OpenAI 用 Authorization: Bearer；勿与 Anthropic x-api-key 混用同一 env 名。
  • 序列化分离：统一对外 API 可以，底层 request body 仍按各厂商文档构造。
  • 评测分离：换厂商或换 model 必须重跑 golden set，见 Prompt Engineering。

对比阅读：Claude API 快速开始。

最小可运行示例

# model 与 path 以官方 Quickstart 为准；gpt-4o-mini 仅为示例 ID
curl https://api.openai.com/v1/responses \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-4o-mini","input":"一句话说明 Platform 与 ChatGPT 网页的区别"}'

完整步骤（Key、SDK、错误码）见 API 快速入门。

上线前安全底线

  • Key 不进前端、不进 Git、不进客户端配置文件。
  • 日志记录 request id 与 token 用量，不记录用户密码、完整身份证号。
  • 高风险领域（医疗、法律、金融）输出必须有人工复核链路。
  • 国内：API 走服务器出站；与本地能否打开 ChatGPT 网页无必然关系，但需合规网络与可用支付。

常见问题

ChatGPT Plus 能抵扣 API 费用吗？

不能。订阅与 API 是两套计费；集成开发必须在 Platform 开通 API 用量。

只有网页 ChatGPT，没有 Platform 账户可以吗？

不行。API Key 只在 Platform 创建；网页登录不能当 Bearer Token 用。

Responses 与 Chat Completions 能否长期双栈？

技术上可以，但维护成本高。新项目选一条主路径；旧项目设迁移里程碑，见 API 开发指南。

Assistants 还值得新项目投入吗？

以官方文档当前状态为准。 若标记 legacy 或推荐 Responses / Agents SDK，新项目勿默认 Assistants，见 Assistants 指南。

国内想先体验对话再开发，怎么做？

对话体验可用 本站 Chat；正式开发仍需 Platform Key 与可访问 api.openai.com 的服务器。

官方资源

下一步阅读

行动路径

今天：打开 Platform 文档，确认 Quickstart 当前推荐的 API 形态。明天：创建测试 Key，按 快速入门 跑通一条 curl。本周：列出团队 3 个业务场景，各映射到本系列一篇后续文章并开始 POC。

相关内容