OpenAI API Key 怎麼獲取：創建密鑰、項目權限與安全保管

本文根據 OpenAI 開發者文檔（Quickstart、API Reference、Production best practices）和幫助中心（項目管理、API Key 安全、帳單）整理，資料核對於 2026-10-07；截圖引用自 OpenAI 幫助中心，為英文介面。

適用於誰

• 第一次接觸 OpenAI API，想拿到一個 API Key 跑通示例代碼的人；
• 已經有 ChatGPT Plus / Pro，以為會員裏自帶 API 額度的人；
• 要把 Key 交給同事、部署到伺服器，想知道怎麼分權限、防泄露的人。

結論先說

1. 在哪創建：登入 OpenAI 開發者平台（platform.openai.com），進入 Settings（設定）→ API keys，點 Create new secret key（創建新密鑰）。
2. ChatGPT 會員 ≠ API 額度：官方明確說 ChatGPT 和 API 平台是兩套獨立的計費系統。Plus、Pro 的訂閱費不能抵扣 API 調用，要用 API 需要在 API 平台單獨添加付款方式或購買額度。
3. 按項目建 Key：每個應用建一個項目（Project），在項目裏建 Key，權限盡量選 Restricted（受限），並設定過期時間。
4. 創建後馬上儲存，之後把它放進環境變量 OPENAI_API_KEY，不要寫進代碼、不要放到網頁前端或手機 App 裏。
5. 懷疑泄露就立即刪除重建，同時去用量頁面看有沒有異常調用，並給組織或項目設定支出上限。

步驟

1. 登入開發者平台，確認組織和項目

用你的 OpenAI 帳號登入 platform.openai.com。頁面左上角顯示的是當前組織（Organization）和項目（Project），點名字可以切換。

• 每個組織都有一個刪不掉的 Default project（預設項目）；
• 只有組織 Owner（所有者）能新建項目：點左上角項目名 → Create project，填名稱後創建；
• 項目裏的文件、存儲等資源只屬於這個項目，不能跨項目移動，所以「一個應用一個項目」最好管理。

2. 創建密鑰

進入 Settings → API keys，點右上角 Create new secret key。

圖片來源：OpenAI 幫助中心《Managing projects in the API platform》

彈窗裏需要選的幾項：

• Owned by（歸屬）：You（你本人） 表示密鑰綁定你的用戶，你被移出組織或項目後它會失效；Service account（服務帳號） 適合伺服器等程序長期使用，只有組織或項目 Owner 能建；
• Name（名稱）：寫清用途，如「blog-prod」，以後排查用量時一眼能認出來；
• Project（項目）：選這個 Key 能訪問的項目；
• Permissions（權限）：All（全部，預設）、Restricted（受限，可按端點分別設為無 / 讀 / 寫）、Read Only（只讀）。

圖片來源：OpenAI 幫助中心《Managing projects in the API platform》

另外兩點：

• 官方生產最佳實踐強烈建議給項目密鑰設定過期時間，並定期輪換：到期前先建新 Key、換到應用裏、確認正常後再吊銷舊 Key；
• 部分國家和地區的新用戶，首次生成 API Key 時可能要求手機號驗證，同一個號碼最多隻能用於 3 次驗證。

3. 立刻儲存密鑰

密鑰創建後會顯示完整內容。幫助中心在服務帳號部分寫明：出於安全原因，之後無法在帳號裏再次查看，丟了只能重新生成。建議當場存進密碼管理器，或直接寫進下一步的環境變量。

4. 放進環境變量

官方 Quickstart 推薦把密鑰導出為環境變量 OPENAI_API_KEY，官方 SDK 會自動讀取：

bash
# macOS / Linux
export OPENAI_API_KEY="把這裏換成你的密鑰"

powershell
# Windows（對之後新打開的終端生效）
setx OPENAI_API_KEY "把這裏換成你的密鑰"

Windows 用 setx 設定後，要新開一個終端窗口才讀得到。想驗證 Key 能不能用，可以列一下可用模型：

bash
curl https://api.openai.com/v1/models -H "Authorization: Bearer $OPENAI_API_KEY"

返回模型列表說明 Key 有效；返回 401 就檢查是否複製完整、有沒有多餘空格。接下來寫第一段 Python 代碼，見 /guides/openai-api-python-quickstart。

5. 開通 API 計費

要持續使用 API，需要在 API 平台的 Billing（帳單） 頁面添加付款方式；新帳號預設是預付費，先買額度再用。價格、預付額度和用量怎麼看，見 /guides/openai-api-pricing-billing。

安全保管：官方建議彙總

• 不要放進客戶端：瀏覽器、手機 App 裏的密鑰可以被別人提取並用你的額度調用。請求應該經過你自己的後端伺服器。
• 不要提交到代碼倉庫：用環境變量或 .env 文件（並加進 .gitignore）；用 GitHub Actions 的話放進 GitHub Secrets；團隊上線建議用密鑰管理服務。
• 不要共享密鑰：官方說明共享 API Key 違反使用條款。給同事用，就把他邀請進組織或項目，讓他生成自己的 Key。
• 最小權限 + 過期時間：按需選 Restricted；管理員還可以在平台設定裏強制規定密鑰最長有效期。
• 設支出上限：在 Limits（限額） 裏給組織或項目設月度支出上限，並打開 Enforce a hard limit（強制硬上限），泄露時能止損。注意只設提醒（alert）不會攔截請求，硬上限生效也有延遲。
• 限制來源 IP：可以開啟 IP 白名單，只允許你的伺服器 IP 調用，即使 Key 正確也會拒絕其他來源。
• 謹慎交給第三方工具：任何要你填 API Key 的第三方產品，先查清公司背景和私隱政策。

如果懷疑泄露：立即在 API keys 頁面刪除或輪換該 Key、更新應用裏的配置；到 Usage（用量） 頁面核對調用是否和自己的業務對得上；然後通過 help.openai.com 聯絡官方支持。頁面上也提示，OpenAI 可能會自動停用公開泄露的密鑰。

常見問題

Q：我有 ChatGPT Plus，為什麼調用 API 還提示沒額度？

因為兩者計費完全分開。ChatGPT 訂閱在 chatgpt.com 的設定裏管理，API 在 platform.openai.com 的 Billing 裏單獨付費。

Q：密鑰忘了儲存怎麼辦？

無法找回完整內容，刪除舊 Key 再新建一個，然後把應用裏的配置換成新的。

Q：報錯 401 Incorrect API key provided？

常見原因：複製時少了字符或多了空格、用了別的組織 / 項目的 Key、Key 已被刪除，或者本地還緩存着舊 Key。確認無誤仍報錯就重新生成。

Q：報錯 403 Country, region, or territory not supported？

說明你所在地區不在 API 支持範圍內，請查看官方的支持國家和地區列表。

Q：什麼時候需要組織驗證（Organization Verification）？

部分模型、功能或項目需要先完成企業驗證或身份驗證，平台會在需要時提示。只用常規模型做入門練習一般不會遇到；驗證要用政府簽發的原件證件，每人只能驗證一個帳號或組織。

參考資料

• OpenAI 開發者文檔：Developer quickstart — https://developers.openai.com/api/docs/quickstart
• OpenAI 開發者文檔：API Overview（Authentication）— https://developers.openai.com/api/reference/overview
• OpenAI 開發者文檔：Production best practices（API keys）— https://developers.openai.com/api/docs/guides/production-best-practices
• OpenAI 開發者文檔：Spend limits — https://developers.openai.com/api/docs/guides/spend-limits
• OpenAI 幫助中心：Managing projects in the API platform — https://help.openai.com/en/articles/9186755-managing-projects-in-the-api-platform
• OpenAI 幫助中心：Best Practices for API Key Safety — https://help.openai.com/en/articles/5112595-best-practices-for-api-key-safety
• OpenAI 幫助中心：Keeping your account secure（Protect your API keys）— https://help.openai.com/en/articles/8304786
• OpenAI 幫助中心：Managing billing for ChatGPT and the API platform — https://help.openai.com/en/articles/9039756-managing-billing-for-chatgpt-and-the-api-platform
• OpenAI 幫助中心：Phone verification（API Key 首次生成）— https://help.openai.com/en/articles/8983031
• OpenAI 幫助中心：API Organization Verification — https://help.openai.com/en/articles/10910291-api-organization-verification