如何取得 OpenAI API Key:platform.openai.com 註冊、計費、產生金鑰與第一條 curl
註冊 OpenAI 平台帳號、開通計費、產生 API key,用 curl 發出第一條請求並讀懂 rate limit 錯誤。
你要在程式裡呼叫 GPT,而不是只在 ChatGPT 網頁裡聊天。官方路徑是 platform.openai.com:註冊帳號 → 綁定 Billing → 產生 API key → 用 curl 發出第一條 chat/completions 請求。步驟以 OpenAI Quickstart 與 Authentication 為準。
可檢索主題是 如何取得 OpenAI API Key 並完成第一條 API 請求:帳號、計費、金鑰、curl 範例,以及 rate limits 怎麼讀。定價與 tier 以平台 Billing / Limits 頁面為準,不用第三方轉述表。
先分清平台入口與 ChatGPT
platform.openai.com
開發者控制台:Billing、API keys、Usage、Limits。REST API 呼叫走 api.openai.com。
chatgpt.com
面向終端使用者的 ChatGPT 網頁/應用。Plus 訂閱不等於 API 額度;API 按用量單獨計費。
| 步驟 | 官方位置 | 常見卡點 |
|---|---|---|
| 註冊 / 登入 | platform.openai.com | 需可用信箱;部分地區可能受限,以註冊頁提示為準 |
| 綁定 Billing | Settings → Billing | 未綁卡時 API 可能無法呼叫或額度極低 |
| 建立 API key | Settings → API keys → Create | 金鑰只顯示一次;遺失需新建並輪換舊 key |
| 第一條請求 | POST /v1/chat/completions | 401 查 Authorization 標頭;429 查 rate limits |
從註冊到第一條 curl
- 01在 platform.openai.com 註冊帳號
瀏覽器開啟 platform.openai.com,用信箱或支援的 OAuth 方式註冊並驗證信箱。登入後進入 Dashboard。官方 Quickstart 把「Sign up / Log in」列為第一步。
- 02設定 Billing(支付方式)
進入 Settings → Billing,按頁面提示新增支援的信用卡或其他支付方式。API 按 token 用量計費;具體價格見 Pricing。Billing 未就緒時,呼叫可能失敗或額度受限。
- 03產生 API key
Settings → API keys → Create new secret key。複製並保存在密碼管理器裡;官方 Authentication 文件強調金鑰等同於密碼,不要寫入 Git 或前端 bundle。可為不同專案建立多個 key 並單獨撤銷。
- 04用 curl 傳送第一條 Chat Completions 請求
在終端機把
$OPENAI_API_KEY設為剛複製的金鑰,然後請求https://api.openai.com/v1/chat/completions。成功時 JSON 的choices[0].message.content會有模型回覆。 - 05讀懂 rate limits 與 429
官方 Rate limits 指南說明每個模型有 RPM 與 TPM 上限,回應標頭含
x-ratelimit-remaining-requests等欄位。收到 429 時按retry-after等待或降低並發;長期額度見 Settings → Limits。
export OPENAI_API_KEY="sk-..." # 不要提交到 Git
curl https://api.openai.com/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-d '{
"model": "gpt-4o-mini",
"messages": [{"role": "user", "content": "Say hello in one word."}]
}'
第一次呼叫常在哪裡斷
- 401 Unauthorized
- 金鑰缺失、拼寫錯誤或已撤銷。確認
Authorization: Bearer標頭與 Settings → API keys 裡 key 狀態為 Active。 - 429 Too Many Requests
- 觸及 RPM/TPM 限制。讀回應標頭與 retry-after;官方 Rate limits 文件建議指數退避重試。
- 403 或 model not found
- 帳戶 tier 可能無權存取該模型。改 Quickstart 推薦的預設可用模型,或查看 Limits 頁面。
先跑通一條最小 curl,再接入 Cline、Cursor 或自研服務。金鑰外洩比選錯模型更貴——輪換 key 比追帳單便宜。
API 整合要對齊時
OpenAI API 走 HTTP;IDE 裡的 Copilot 或 Cursor Agent 是另一條路。要把 endpoint、模型和 rate limit 截圖對齊,可以攤在同一頁。用 oakmeet 開一間會過期的房:瀏覽器、空間碼、不用註冊。上限見 八人、大約一小時。可對照 Google AI Studio 與 Cline 自備金鑰。
ChatGPT Plus 包含 API 額度嗎?
不包含。Plus 是 chatgpt.com 的訂閱;API 在 platform.openai.com 單獨按用量計費。以 OpenAI 官方 Pricing 與 Billing 說明為準。
免費層還能用 API 嗎?
政策與額度會變。以註冊後 Billing 與 Limits 頁面顯示為準;不要依賴過時的「$5 免費額度」截圖。
金鑰外洩了怎麼辦?
立即在 Settings → API keys 撤銷該 key 並新建。官方 Authentication 文件建議定期輪換,且 never commit keys to version control。
Rate limit 能申請提高嗎?
官方 Rate limits 指南說明額度隨 Usage tier 提升;在 Settings → Limits 查看目前 tier 與申請路徑(若頁面提供)。