OpenAI Platform 开发文档概览

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

🚀 快速通道

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

更新时间：2026-08-12

导读

OpenAI Platform 是 API 开发的控制面：发 Key、看账单、在 Playground 试模型，并跳转到官方文档。很多集成问题不是「代码写错」，而是在错误博客、旧端点、过期 model ID 上浪费时间。本文建立「控制台任务 ↔ 文档章节 ↔ 代码字段」的映射，让你按任务找信息。界面会迭代，以你登录后实际页面为准。

Platform 与 ChatGPT 网页：别混用

维度	chatgpt.com	platform.openai.com
用户	终端用户	开发者
计费	ChatGPT 订阅	API 按 token / 附加能力
凭证	账户登录	API Key
产出	对话体验	可编程 HTTP 调用

集成只认 Platform。 想先感受对话可用本站 Chat，但 Key 创建、用量监控、正式调用仍依赖 Platform。

按开发任务找控制台功能

任务	去哪里	实操提示
创建 / 吊销 Key	API keys	dev / staging / prod 分 Key
查花费、设告警	Usage / Billing	上线前用真实 prompt 估单次成本
试模型与 prompt	Playground	确认后再迁代码
查可用 model	Models（文档或控制台）	示例 ID 可能已过期
团队权限	Organization / Projects	多产品共用账户时隔离
排障	Logs（若开放）+ `x-request-id`	401/429 先分清 Key 与限流

暂时打不开 Platform 时，可先读开发指南总览建概念；正式 Key 与计费仍需访问 Platform（或海外服务器代管）。

文档站怎么读：30 分钟扫一遍

platform.openai.com/docs 建议顺序：

Get started / Quickstart — 当前主推端点（常为 Responses API）
Models — 上下文长度、能力、价格档位
Guides — 文本生成、工具调用、RAG、结构化输出
API reference — 字段权威定义；与 Stack Overflow 冲突时以此为准
Changelog / Deprecations — Assistants 等旧接口 sunset 时间表

Assistants 若标 legacy：对照 Assistants 开发指南与 Responses API。

API Key：创建到轮换

# .env 本地开发；勿提交 Git
export OPENAI_API_KEY="sk-..."

# 快速验证 Key（返回 model 列表即表示鉴权通过）
curl https://api.openai.com/v1/models \
  -H "Authorization: Bearer $OPENAI_API_KEY"

实践	原因
按环境分 Key	泄露影响面可控
Key 命名 / 标签	轮换时知道谁在用
双 Key 灰度轮换	零停机切换
禁止前端暴露	浏览器里等于公开

Key 用法与生产清单见 API 开发指南。

计费、限流与成本估算

Token 计费：输入、输出通常分开计价；system、RAG chunk、tools schema 都算输入。
429 Rate limit：RPM/TPM 超限；实现指数退避，勿无限并发重试。
定价：openai.com/api/pricing — 用 Playground 或测试脚本记录 usage 再乘单价。
Batch API（若适用）：离线任务可能更便宜，见文档 Batch 章节。

参数与 token 优化见文本生成指南。

Playground → 生产的标准流程

Playground 试通 → 复制请求 JSON → 迁入服务端
       ↓                              ↓
  选 model / system              加 timeout、重试、日志
       ↓                              ↓
  记录 token 用量              golden set 对比输出

注意：temperature > 0 时 Playground 与 API 输出不会逐字相同；评测看结构是否符合、要点是否覆盖，而非字符串 diff。

组织、项目与数据政策

Organization ID：部分 SDK 与工单需要；大团队按项目划分配额。
数据使用政策：查官方 API data usage 说明——是否用于训练、留存多久。
区域限制：账户或 IP 触发地区限制时，查阅支持文档；勿违反 ToS 绕行。

周边资源对照

资源	何时用
Cookbook	RAG、Agent 等可复制 recipe
openai-python	官方 Python SDK
status.openai.com	大面积 5xx 先查状态
API 定价	选型与预算

常见问题

Platform 与 ChatGPT 是同一账号吗？

通常是同一 OpenAI 账户体系，但 API 账单与 ChatGPT 订阅分开。

Playground 调用要钱吗？

一般消耗 API 额度；具体以 Billing 说明为准。

文档找不到 Assistants 章节？

可能已迁移或标 legacy。读 Assistants API 开发指南并对照 Deprecations。

401 一定是 Key 错了吗？

常见是 Key 未传、已吊销、或环境变量名拼错；也检查是否误用了 ChatGPT 会话 token。

model 名在 Playground 能用、代码 400？

请求体字段随 API 形态变化；对照 API reference 的 model 与 messages/input 结构。

官方资源

下一步阅读

行动路径

今天：登录 Platform，创建 local-dev 专用 Key 写入 .env。明天：在文档 Quickstart 找到主推端点，Playground 与 curl 各跑一遍。本周：Billing 设预算提醒，并完成快速入门的服务器侧调用。

导读