ChatGPT / OpenAI 開發指南總覽

最後更新：2026-08-12· 14 分鐘閱讀

🚀 快速通道

ChatGPT 國內版：點擊直達↗
穩定鏡像站：開啟鏡像↗
官方 ChatGPT：chatgpt.com ↗

更新時間：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	本文	全局地圖與術語
2	Platform 開發文件概覽	控制台與文件結構
3	API 快速入門	第一條 API 請求
4	ChatGPT API 開發指南	鑑權、限流、生產清單
5	文字生成	參數與結構化輸出
6	Prompt Engineering	可評測的提示詞工程
7	Assistants API	歷史方案與遷移注意
8+	Embeddings、Vision、Speech 等	按模組深入

核心術語（5 分鐘建立共同語言）

術語	含義	開發注意
API Key	Platform 頒發的 `sk-...` 金鑰	僅伺服器端；按環境分 Key
Model ID	如 `gpt-4o-mini`（範例）	上線前查 Models 頁，勿抄舊文
Token	計費與上下文單位	輸入含 system、RAG、工具定義
Chat Completions	`/v1/chat/completions`	messages 陣列由你維護
Responses API	`/v1/responses`	新項優先對照 Quickstart
Assistants	Assistant / Thread / Run	可能 legacy，見專門指南
Rate limit	RPM / 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
語意搜尋、RAG	embeddings
讀圖、OCR	vision
語音合成 / 識別	speech
文生圖	image-generation
多步 Agent	agents-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。

導讀