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 設預算提醒，並完成快速入門的伺服器側呼叫。

導讀