
前言:為什麼要直接呼叫 API?
在 ChatGPT 網站上對話,與直接呼叫 API 是完全不同層次的應用。
類別 | 網頁聊天(Before) | API 呼叫(After) |
|---|---|---|
自動化 | 每次都要手動輸入 | 可與 Excel・Slack・CRM 串接 |
成本 | 每月固定 $20(ChatGPT Plus) | 用多少付多少(以 token 計費) |
客製化 | 有限 | 可精細調整溫度、系統提示詞等參數 |
大量處理 | 逐筆複製貼上 | 可批次處理數百筆 |
💡 理解 API 後,您就能從「使用 AI 的人」升級為 **「將 AI 融入工作的人」**。即使不會寫程式,只要使用 Postman 這個免費工具,也能輕鬆跟著操作。
只要跟著本指南完成,您就能親自呼叫 OpenAI(GPT-4o)、Anthropic(Claude)、Google(Gemini)三家的 API。所需時間約 40~60 分鐘。
Step 1. 事前準備 — 安裝 Postman
Postman 是 不需寫程式就能測試 API 的免費工具。開發人員每天都在使用,非開發人員也能輕鬆上手。
1-1. 下載並安裝 Postman
在瀏覽器中開啟 postman.com/downloads。
點選畫面中央的橘色 「Download the App」 按鈕。
系統會自動下載符合您作業系統(Windows/Mac)的安裝檔。
執行下載的檔案,完成安裝。
安裝完成後開啟 Postman,會出現註冊(Sign Up)畫面。
使用 Google 帳號或電子郵件建立免費帳號。
1-2. 確認首頁畫面
登入後,若頂端出現 "+" 分頁,就表示準備完成。
點選這個 「+」 分頁,就會開啟建立新 API 請求(Request)的畫面。
左側下拉選單目前應該是 **「GET」**,稍後我們會把它改成 **「POST」**。
💡 Postman 也有網頁版(app.getpostman.com),但 桌面版應用程式更穩定。僅在公司資安政策導致無法安裝時,再使用網頁版。
Step 2. 申請 OpenAI API 金鑰並完成首次呼叫
2-1. 申請 API 金鑰
在瀏覽器中前往 platform.openai.com。
請使用與 ChatGPT 相同的帳號登入。(可能需要另外註冊。)
登入後,點選左側邊欄的 ⚙️ 齒輪圖示(Settings)。
點選左側選單的 "API keys"。
點選畫面上方的 "+ Create new secret key" 按鈕。
在 Name 欄位輸入「我的第一把金鑰」,然後點擊「Create secret key」。
畫面會顯示一長串以 sk- 開頭的字串,這就是您的 API 金鑰。
請務必按下 「Copy」 按鈕,並貼到記事本中保存。
⚠️ 此金鑰只會顯示一次。關閉視窗後就無法再查看,請務必存放在安全的地方。若遺失,需重新申請新的金鑰。
2-2. 登錄付款方式(必要)
API 屬於 付費服務,必須先登錄付款方式才能呼叫。
點選左側選單的 "Billing"。
點選 "Add payment method" 按鈕。
輸入信用卡資訊。
在 "Initial credit balance" 輸入 $5。(最低儲值金額)
OpenAI 計費結構重點:
模型 | 輸入(每 100 萬 Token) | 輸出(每 100 萬 Token) | 參考 |
|---|---|---|---|
GPT-4o | $2.50 | $10.00 | 最推薦 |
GPT-4o-mini | $0.15 | $0.60 | 性價比最高 |
GPT-4.1 | $2.00 | $8.00 | 最新模型 |
💡 以中文計算,約 1,500 字相當於 1,000 個 token。即使只儲值 $5,使用 GPT-4o-mini 也能呼叫 數千次,可以放心開始。
2-3. 在 Postman 中呼叫 OpenAI API
開啟 Postman,點選上方的 "+" 分頁,建立新的請求。
將左側下拉選單由 GET 改為 POST。
請將下列網址直接複製並貼到 URL 輸入欄:
https://api.openai.com/v1/chat/completions
4. 點選 URL 輸入欄下方的 "Headers" 分頁。
5. 加入以下兩行:
KEY | VALUE |
|---|---|
|
|
|
|
注意:Bearer 與 sk- 之間必須有一個空格。
點選 "Body" 分頁。
選取 「raw」 選項按鈕。
將右側下拉選單從 **「Text」→「JSON」** 切換。
請將以下內容直接複製並貼上:
json
{
"model": "gpt-4o-mini",
"messages": [
{
"role": "system",
"content": "您是 B2B 銷售專業助理。請以簡潔、實用的方式回答。"
},
{
"role": "user",
"content": "請撰寫一封提案導入 IT 解決方案的電子郵件。對象是中堅企業的 CFO,重點是節省成本。"
}
],
"temperature": 0.7,
"max_tokens": 1000
}
10. 點擊右上角的藍色「Send」按鈕。
2-4. 確認回應
下方區域會顯示 JSON 格式的回應。在 "choices" 內的 "content" 欄位,可以看到 AI 生成的電子郵件內文;在 "usage" 欄位則可確認使用的 token 數量。
提示詞範例 ①:撰寫陌生開發信
"請撰寫一封提案導入 IT 解決方案的電子郵件。對象是中堅企業的 CFO,重點是節省成本。請控制在 300 字以內,CTA(Call to Action)請設定為提議 15 分鐘會議。"
Step 3. 申請 Anthropic(Claude)API 金鑰並完成首次呼叫
3-1. 申請 API 金鑰
在瀏覽器中開啟 console.anthropic.com。
點選 "Sign Up" 建立帳號。(與 claude.ai 帳號各自獨立。)
完成電子郵件驗證。
登入後,點選左側邊欄的 「API Keys」。
點選 「Create Key」 按鈕。
在 Name 欄位輸入 "第一組金鑰",然後點選 "Create Key"。
畫面會顯示以 sk-ant- 開頭的字串,請將它複製到記事本保存。
3-2. 登錄付款方式
在左側選單點擊「Billing」→「Payment Methods」。
登錄信用卡,並儲值 $5 額度。
Anthropic 費用結構:
模型 | 輸入(每 100 萬 Token) | 輸出(每 100 萬 Token) |
|---|---|---|
Claude Sonnet 4 | $3.00 | $15.00 |
Claude Haiku 3.5 | $0.80 | $4.00 |
3-3. 在 Postman 呼叫 Claude API
在 Postman 開啟新分頁(「+」),並設定為 POST。
URL:
https://api.anthropic.com/v1/messages
3. 在 "Headers" 分頁中新增以下三行:
KEY | VALUE |
|---|---|
|
|
|
|
|
|
與 OpenAI 不同,這裡使用名為 x-api-key 的標頭,且不加 Bearer。
依序選擇 "Body" → "raw" → "JSON",然後貼上以下內容:
json
{
"model": "claude-sonnet-4-20250514",
"max_tokens": 1024,
"system": "您是擁有 10 年資歷的 B2B 銷售教練。",
"messages": [
{
"role": "user",
"content": "請撰寫一封客戶會議後的跟進郵件。會議中討論的內容是雲端遷移,下一步是安排技術展示的時間。"
}
]
}
5. 點選 「Send」 按鈕。
提示詞範例 ② — 跟進電子郵件:
「請幫我寫一封客戶會議後的追蹤信。會議中討論的內容是雲端遷移,下一步是安排技術展示的時間。請用專業又溫暖的語氣,並提出 2 個具體的日期。」
3-4. 確認回應
回應 JSON 中 "content" 陣列內的 "text" 欄位,就是 Claude 撰寫的郵件。
💡 Claude 擅長分析長篇文件。將
max_tokens調高到 4096,就能得到更長的回答。
Step 4. 申請 Google Gemini API 金鑰並進行首次呼叫
4-1. 申請 API 金鑰
Google Gemini API 是三者中 最簡單 就能取得金鑰的一個。
在瀏覽器中開啟 aistudio.google.com/apikey。
以 Google 帳號登入。
點選 「建立 API 金鑰(Create API Key)」 按鈕。
若出現選擇專案的畫面,請選擇 「在新專案中建立 API 金鑰」。
系統會產生以 AIza 開頭的字串。請複製並儲存到記事本。
Google Gemini 收費結構:
模型 | 輸入(每 100 萬 Token) | 輸出(每 100 萬 Token) | 免費方案 |
|---|---|---|---|
Gemini 2.0 Flash | $0.10 | $0.40 | 每分鐘 15 次免費 |
Gemini 2.5 Pro | $1.25~$2.50 | $10.00~$15.00 | 每分鐘 5 次免費 |
💡 Gemini Flash 模型提供免費方案,不需登錄付款方式也能測試。以學習為目的的話,這是最沒有負擔的選擇。
4-2. 在 Postman 呼叫 Gemini API
在 Postman 開啟新分頁(「+」),並設定為 POST。
URL(請將下方的
YOUR_API_KEY換成您自己的金鑰):
https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash:generateContent?key=YOUR_API_KEY
Google 比較特別,是以 URL 參數傳遞 API 金鑰。
「Headers」 分頁:
KEY | VALUE |
|---|---|
|
|
選擇 「Body」 → 「raw」 → 「JSON」 後:
json
{
"contents": [
{
"role": "user",
"parts": [
{
"text": "請製作 B2B SaaS 產品的競爭對手比較表。類別為專案管理工具,請比較 Asana、Monday.com、Jira,並包含價格、主要功能與優缺點。"
}
]
}
],
"generationConfig": {
"temperature": 0.7,
"maxOutputTokens": 2048
}
}
5. 點選 「Send」。
提示詞範例 ③ — 競爭對手分析:
"請製作 B2B SaaS 產品的競爭對手比較表。類別為專案管理工具,請比較 Asana、Monday.com、Jira。請以 Markdown 表格整理價格、主要功能、優缺點,以及各工具適合的團隊規模。"
4-3. 確認回應
沿著 "candidates" → "content" → "parts" → "text" 的路徑,即可看到生成的回答。
Step 5. 三種 API 比較整理
比較項目 | OpenAI | Anthropic | |
|---|---|---|---|
金鑰格式 |
|
|
|
驗證方式 | Header: | Header: | URL 參數: |
Body 結構 |
|
|
|
免費方案 | 無(最低儲值 $5) | 提供有限的免費額度時才有 | Gemini Flash 免費 |
高性價比模型 | GPT-4o-mini | Claude Haiku 3.5 | Gemini 2.0 Flash |
優勢 | 泛用性、生態系 | 長文分析、安全性 | 速度、免費方案、多模態 |
Step 6. 實戰應用技巧 — 可直接用在工作上的提示詞模式
6-1. 調整 temperature 參數
temperature: 0.1~0.3 → 格式固定的報告、資料摘要(結果一致)
temperature: 0.5~0.7 → 電子郵件、一般工作文件(結果均衡)
temperature: 0.8~1.0 → 腦力激盪、創意文案(結果較多元)
💡 B2B 銷售電子郵件的 temperature 設在 0.5~0.7 最為自然。太低會顯得生硬,太高則可能偏離商務情境。
6-2. 運用系統提示詞(Before/After)
Before:未使用系統提示詞時:
「幫我寫業務開發信」 → 產出內容空泛的通用信件
After — 設定系統提示詞:
系統:「您是擁有 10 年經驗的 B2B SaaS 銷售專家。請套用 SPIN 銷售方法論,並務必在內容中加入具體數字與投資報酬率(ROI)。」
使用者:「請幫我寫一封提案導入雲端資安解決方案的電子郵件」
→ 產出包含 ROI 數據、結構完整的業務郵件
6-3. 費用管理實務守則
測試階段請一律使用 mini/flash/haiku 等輕量模型。等提示詞確定後,再切換到高階模型。
在 OpenAI 控制台(platform.openai.com → Usage)查看每日用量。
將**每月用量上限(Usage Limits)**設為 $10,可避免產生意外費用。
在 Settings → Limits → "Set a monthly budget" 中設定
Step 7. 常見錯誤與解決方法
錯誤 401:Unauthorized
原因:API 金鑰輸入錯誤
解決方法:確認
Bearer後面有空格,且複製金鑰時沒有連同前後空白一起複製。
錯誤 429:Rate Limit Exceeded
原因:短時間內送出過多請求
解決方法:等待 30 秒至 1 分鐘後再試一次。免費方案的限制更為嚴格。
錯誤 400:Bad Request
原因:JSON 格式錯誤(漏掉逗號、引號錯誤等)
解決方法:將 Body 的內容貼到 jsonlint.com 進行語法驗證。
錯誤 403:Insufficient Balance
原因:額度餘額不足
解決方式:前往 Billing 頁面追加儲值額度。
💡 發生錯誤時,請到 Postman 下方回應區的 "Body" 分頁,查看
"error"→"message"欄位。大部分原因都會以英文清楚說明。
Step 8. 下一步 — 免寫程式,用自動化擴大應用
API 呼叫成功後,就可以銜接到實際的工作自動化。
工具 | 難易度 | 應用範例 |
|---|---|---|
Zapier / Make | ⭐ 簡單 | 收到電子郵件 → AI 摘要 → Slack 通知 |
Google Apps Script | ⭐⭐ 普通 | Google 試算表資料 → AI 分析 → 自動產出報告 |
Power Automate | ⭐⭐ 普通 | Teams 訊息 → AI 翻譯 → 自動回覆 |
n8n | ⭐⭐⭐ 中階 | CRM 潛在客戶 → AI 評分 → 自動寄送電子郵件 |
實際工作應用數據(Before → After)
撰寫業務開發信的時間:平均 25 分鐘 → 3 分鐘(約 縮短 88%)
客戶會議摘要報告:手動撰寫 40 分鐘 → 呼叫 API 後再編修 10 分鐘(約 縮短 75%)
競爭對手分析資料:原本需要半天的調查 → 生成初稿 5 分鐘 + 事實查核 30 分鐘(約縮短 70%)
結語檢核表
請確認下列項目是否都已完成:
完成 Postman 安裝與帳號建立
已完成 OpenAI API 金鑰申請與額度儲值
OpenAI API 呼叫成功(GPT-4o-mini)
已完成 Anthropic API 金鑰申請
Claude API 呼叫成功
已完成 Google Gemini API 金鑰申請
Gemini API 呼叫成功
了解三種 API 的認證方式差異
temperature 調整測試完成
已完成每月使用上限設定
💡 請將本指南中使用的 Postman 請求儲存為 Collection。按下 Postman 左側邊欄的 「Save」 按鈕,建立名為「AI API 測試」的資料夾,之後隨時都能再取出使用。這就是屬於您自己的 AI API 實驗室。