OpenAI API 快速入門

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

🚀 快速通道

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

OpenAI API 快速入門

更新時間：2026-08-12

導讀

OpenAI API 讓你把 GPT 系列模型接入網站、腳本、客服或內部工具。本文從 Platform 帳戶到第一條 HTTP 請求，涵蓋 Key 管理、Responses / Chat Completions 雙形態範例、SDK 呼叫、常見錯誤與上線前安全檢查。端點、model ID、欄位名以官方 Quickstart 為準——OpenAI 可能主推 Responses API，同時保留 Chat Completions 供存量程式碼。

API 和 ChatGPT 網頁有什麼不同？

維度	chatgpt.com	OpenAI API
使用方式	瀏覽器對話	HTTP / 官方 SDK
計費	ChatGPT 訂閱	按 token 用量
整合	人工互動	可嵌入產品流程
金鑰	帳戶登入	API Key（需保密）

選型： 人機聊天用網頁（或本站 Chat 體驗入口）；自動化、批次處理、產品功能用 API。

準備帳戶與 API Key

登入 OpenAI Platform。
在 API keys 建立 Key；立即複製，頁面可能不再完整顯示。
為 Key 標註用途（如 dev-bot / prod-summarizer），便於外洩後輪替。
在 Billing 開通付費並設定用量/預算告警（若控制台提供）。

# Linux / macOS
export OPENAI_API_KEY="sk-..."

# Windows PowerShell
$env:OPENAI_API_KEY="sk-..."

控制台各區域說明見 Platform 概覽。

第一條 API 呼叫

以下展示請求形狀；gpt-4o-mini 等為範例 model ID，請在對照文件後替換。

Responses API（新專案先查 Quickstart 是否推薦）

curl https://api.openai.com/v1/responses \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "input": "用三句話解釋什麼是 RAG"
  }'

Chat Completions（教學與存量程式碼常見）

curl https://api.openai.com/v1/chat/completions \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {"role": "system", "content": "你是簡潔的技術助手。"},
      {"role": "user", "content": "用三句話解釋什麼是 RAG"}
    ]
  }'

Python SDK 範例

# pip install openai  # 版本以官方文件為準
from openai import OpenAI

client = OpenAI()  # 讀取 OPENAI_API_KEY 環境變數

resp = client.chat.completions.create(
    model="gpt-4o-mini",  # 範例 ID，請查文件更新
    messages=[{"role": "user", "content": "用三句話解釋什麼是 RAG"}],
)
print(resp.choices[0].message.content)
print(resp.usage)

Node.js SDK 範例

// npm install openai  // 版本以官方文件為準
import OpenAI from "openai";

const client = new OpenAI({ apiKey: process.env.OPENAI_API_KEY });

const resp = await client.chat.completions.create({
  model: "gpt-4o-mini", // 範例 ID，請查文件更新
  messages: [{ role: "user", content: "用三句話解釋什麼是 RAG" }],
});
console.log(resp.choices[0].message.content);
console.log(resp.usage);

若 SDK 提供 client.responses.create(...)，以官方 Quickstart 選擇 Completions 或 Responses。

讀懂回應與用量

成功回應含生成文字與 usage（prompt / completion tokens）。從第一天就日誌化：

欄位	用途
`usage.prompt_tokens`	輸入成本
`usage.completion_tokens`	輸出成本
回應 `id` 或頭 `x-request-id`	工單排查

價格參考：openai.com/api/pricing

模型怎麼選？

場景	傾向	驗證方式
客服短回覆	較小/較快檔位	延遲 P95、滿意度
長文件摘要	長上下文件	漏項率人工抽檢
複雜推理	較強檔位	樣本集準確率
高 QPS 批次處理	成本優化檔	帳單 + 限流

用同一批真實輸入對比兩個 model ID 再定預設值。詳見文字生成指南。

計費、限流與監控

Token：輸入 + 輸出都計費；system 與檢索上下文占輸入 token。
Rate limit：429 時應退避重試，勿打滿並發。
監控：記錄 model、latency、token、HTTP 狀態；對 5xx/429 設告警。

常見 HTTP 錯誤

狀態碼	常見含義	處理
401	Key 無效或未傳	檢查 `Authorization` 與環境變數
429	限流	指數退避；申請提額或降 QPS
400	請求體欄位錯誤	對照 API reference 的 model / messages
500+	伺服器端異常	有限重試 + 查 status.openai.com

安全清單（上線前必查）

Key 僅存在於伺服器端環境變數或金鑰管理器
禁止把 Key 寫進前端、行動 App、公開 GitHub
對使用者輸入做長度限制與 PII 過濾（按合規要求）
日誌去識別：不記錄完整密碼、卡號、健康資料
定期輪替 Key；離職流程包含撤銷
dev / staging / prod 使用不同 Key

可複製 system + user 模板

[System]
你是企業知識庫助手。只根據提供的 context 回答。
若 context 不足，回答「資料中未提及」並列出需要補充的資訊。
不得編造連結或法規條文。

[User]
context:
"""
[貼上去識別段落]
"""
問題：[使用者問題]

Prompt 體系化見 Prompt Engineering 指南。

常見問題

API Key 外洩了怎麼辦？

立即在 Platform 撤銷該 Key，建立新 Key，並排查 Git 歷史、CI 日誌、前端 bundle。

ChatGPT Plus 包含 API 額度嗎？

不包含。API 在 Platform 單獨計費。

應該用 Responses 還是 Chat Completions？

以文件 Quickstart 為準。新專案跟隨官方推薦；舊專案查閱遷移說明，見 API 開發指南與 Responses API 指南。

國內伺服器能調 API 嗎？

取決於網路與帳戶地區政策。API 在伺服器端呼叫，不依賴本地瀏覽器；合規與支付查閱官方說明。

和 Claude API 能共用一層抽象嗎？

欄位不同，需分別適配；可用 gateway 統一對外，底層仍按各廠商文件序列化。對比：Claude API 快速開始。

官方資源

下一步閱讀

行動路徑

今天：在測試環境跑通一條 API 呼叫並列印 usage。明天：把 Key 遷入環境變數，刪除程式碼裡的明文。本週：用 10 條真實問題建立基準集，再選預設 model 與生產化清單。

導讀