AI API 入門教學|2026 年從零開始學會串接 OpenAI、Claude、Gemini API
- 不會寫程式也能看懂!AI API 其實就像「點餐」一樣簡單
- API 串接是什麼?一次搞懂基礎概念
- API 的運作原理
- API 串接常見術語
- AI API 入門三步驟
- 步驟一:申請 API Key
- 步驟二:安裝 SDK 與環境設定
- 步驟三:發送第一個 API 請求
- OpenAI API 串接教學
- OpenAI API Key 申請
- Python 程式碼範例
- Gemini API 串接教學
- Google AI Studio 設定
- Python 程式碼範例
- Claude API 串接教學
- Anthropic Console 設定
- Python 程式碼範例
- API 串接練習資源
- 免費 API 練習平台
- API Playground 工具推薦
- FAQ - API 教學常見問題
- API 怎麼寫?
- API 串接是什麼意思?
- API 怎麼用?
- 新手該從哪個 AI API 開始?
- AI API 一定要會寫程式才能用嗎?
- 參考資料
不會寫程式也能看懂!AI API 其實就像「點餐」一樣簡單
💡 重點摘要:你走進一家餐廳,跟服務生說「我要一碗牛肉麵」,服務生把你的需求傳給廚房,廚房做好後端上桌。
AI API 就是這樣。
你(程式)把需求(文字 Prompt)傳給 AI 服務(廚房),AI 處理完後把結果(回應)傳回來。
就這麼簡單。
2026 年,會用 AI API 已經不是工程師的專利。行銷人員用它自動生成文案,客服團隊用它打造聊天機器人,分析師用它處理大量數據。
這篇教學會從最基礎的概念開始,一步一步帶你學會串接 OpenAI、Claude、Gemini 三大 AI API。
想快速上手 AI API?CloudSwap 提供技術支援與企業方案,解決付款和發票問題。
API 請求/回應流程圖
API 串接是什麼?一次搞懂基礎概念
Answer-First: API(Application Programming Interface)就是「程式與程式之間的溝通介面」。API 串接就是讓你的程式透過這個介面,去使用別人的服務。
API 的運作原理
用白話文說:
- 你的程式發送一個 HTTP 請求(Request)給 AI 服務的伺服器
- 伺服器收到請求,用 AI 模型處理你的問題
- 伺服器把結果包成 HTTP 回應(Response)傳回來
- 你的程式收到結果,做後續處理
整個過程通常在 1-5 秒內完成。
API 串接常見術語
| 術語 | 白話解釋 | 餐廳比喻 |
|---|---|---|
| API Key | 你的身分證明(一串密鑰) | 會員卡 |
| Endpoint | API 的網址 | 餐廳地址 |
| Request | 你傳給 API 的資料 | 你的點餐單 |
| Response | API 回傳的結果 | 上桌的餐點 |
| Token | AI 處理文字的最小單位 | 一口飯的大小 |
| Rate Limit | 每分鐘可以發幾次請求 | 每小時最多點幾道菜 |
| SDK | 官方提供的程式庫,簡化串接 | 餐廳 App,一鍵下單 |
想更深入了解 API 的基礎概念?請參考 API 概念基礎完整指南。
AI API 入門三步驟
Answer-First: 串接 AI API 只需三步:(1) 申請 API Key,(2) 安裝 SDK,(3) 寫幾行程式碼發送請求。整個流程 10 分鐘就能完成。
步驟一:申請 API Key
每個 AI 平台都需要先申請帳號並取得 API Key。
| 平台 | 申請網址 | 免費額度 |
|---|---|---|
| OpenAI | platform.openai.com | 新帳號 $5(3 個月) |
| Anthropic(Claude) | console.anthropic.com | 有限免費額度 |
| Google(Gemini) | aistudio.google.com | 免費版每分鐘 15 次 |
重要提醒: API Key 就是你的密碼,絕對不要放在公開的程式碼裡。
想了解 API Key 的管理和安全知識?請參考 API Key 管理安全指南。
步驟二:安裝 SDK 與環境設定
以 Python 為例:
# OpenAI
pip install openai
# Anthropic (Claude)
pip install anthropic
# Google Gemini
pip install google-genai
設定 API Key(建議用環境變數):
# macOS / Linux
export OPENAI_API_KEY="sk-your-key-here"
export ANTHROPIC_API_KEY="sk-ant-your-key-here"
export GOOGLE_API_KEY="your-key-here"
步驟三:發送第一個 API 請求
用 Python 呼叫 OpenAI API:
from openai import OpenAI
client = OpenAI() # 自動讀取環境變數
response = client.chat.completions.create(
model="gpt-4o",
messages=[
{"role": "user", "content": "用一句話解釋什麼是 API"}
]
)
print(response.choices[0].message.content)
# 輸出:API 就是讓不同程式互相溝通的標準化介面。
就這樣。五行程式碼,你就成功串接了 AI API。
OpenAI API 串接教學
Answer-First: OpenAI 是最多人使用的 AI API 平台。核心 API 是 Chat Completions,支援 GPT-5、GPT-4o 等模型。
OpenAI API Key 申請
- 前往 platform.openai.com
- 註冊帳號並驗證信箱
- 進入 API Keys 頁面,點「Create new secret key」
- 複製並安全保存(只會顯示一次)
Python 程式碼範例
from openai import OpenAI
client = OpenAI()
# 基本對話
response = client.chat.completions.create(
model="gpt-4o",
messages=[
{"role": "system", "content": "你是一位專業的技術顧問"},
{"role": "user", "content": "什麼是 REST API?請用簡單的方式解釋"}
],
temperature=0.7,
max_tokens=500
)
print(response.choices[0].message.content)
print(f"使用了 {response.usage.total_tokens} 個 Token")
參數說明:
model:選擇模型(gpt-5、gpt-4o、gpt-4o-mini)temperature:0 = 確定性高,1 = 創意性高max_tokens:限制回應長度
完整的 OpenAI API 教學?請參考 OpenAI API 教學|從 API Key 申請到程式碼範例。
Gemini API 串接教學
Answer-First: Gemini API 透過 Google AI Studio 操作最簡單,免費額度最大方,而且 Context Window 高達 100 萬 Token。
Google AI Studio 設定
- 前往 aistudio.google.com
- 用 Google 帳號登入
- 點「Get API Key」→「Create API Key」
- 選擇或建立 Google Cloud 專案
Python 程式碼範例
from google import genai
client = genai.Client(api_key="your-api-key")
response = client.models.generate_content(
model="gemini-2.0-flash",
contents="用一段話介紹台灣的科技產業"
)
print(response.text)
Gemini 的免費版每分鐘 15 次請求,對學習和原型開發完全夠用。
完整教學?請參考 Gemini 教學|Google Gemini API 串接與使用完整教學。
遇到串接問題?CloudSwap 技術團隊為您服務,中文即時支援。
Claude API 串接教學
Answer-First: Claude API 由 Anthropic 提供,以中文理解力強和 Prompt Caching 省 90% 聞名。200K Context Window 適合處理長文件。
Anthropic Console 設定
- 前往 console.anthropic.com
- 註冊帳號
- 進入 API Keys 頁面,建立新的 Key
- 設定付款方式
Python 程式碼範例
import anthropic
client = anthropic.Anthropic()
message = client.messages.create(
model="claude-sonnet-4-6-20260321",
max_tokens=1024,
messages=[
{"role": "user", "content": "請比較 REST API 和 GraphQL 的優缺點"}
]
)
print(message.content[0].text)
Claude 的 Prompt Caching 功能在需要長 System Prompt 的場景(如客服機器人)特別實用,快取後只需原價 10% 的費用。
三大 AI API 程式碼範例對比
API 串接練習資源
Answer-First: 學 API 最快的方法是動手做。以下推薦免費的練習平台和工具,讓你不花錢就能上手。
免費 API 練習平台
| 平台 | 說明 | 網址 |
|---|---|---|
| Google AI Studio | Gemini 免費版,每分鐘 15 次 | aistudio.google.com |
| OpenAI Playground | 視覺化測試介面(需帳號) | platform.openai.com/playground |
| Anthropic Workbench | Claude 測試介面 | console.anthropic.com |
| Postman | 通用 API 測試工具 | postman.com |
| HTTPie | 命令列 API 測試工具 | httpie.io |
API Playground 工具推薦
不想寫程式碼?用 Playground 直接測試。
每個 AI 平台都有自己的 Playground(線上測試介面),讓你用圖形介面調整參數、測試 Prompt,不需要寫一行程式碼。
推薦學習路徑:
- 先用 Playground 熟悉 API 的輸入輸出
- 再用 Python 寫簡單的程式碼
- 最後嘗試做一個小專案(如翻譯工具、摘要工具)
想用 Python 串接各大 AI API?請參考 Python AI API 教學完整指南。
更多 API 串接的基礎教學?請參考 API 串接教學|新手從零開始。
FAQ - API 教學常見問題
API 怎麼寫?
API 串接的程式碼通常只需要幾行。以 Python 為例:(1) 安裝 SDK(pip install openai),(2) 設定 API Key,(3) 呼叫函式。本文有完整的程式碼範例,複製貼上就能用。
API 串接是什麼意思?
API 串接就是讓你的程式透過標準介面去呼叫另一個服務。就像你的 App 透過 Google Maps API 來顯示地圖——你不需要自己做地圖,只要「接上去」就好。AI API 串接也是一樣,你不需要訓練 AI 模型,只要呼叫 OpenAI/Claude/Gemini 的 API 就能使用 AI 功能。
API 怎麼用?
最簡單的方式是用 Playground(各平台都有線上測試介面)。進階的方式是用 Python 寫程式碼,透過 SDK 呼叫 API。本文的步驟三有完整的範例。
新手該從哪個 AI API 開始?
建議從 Gemini API 開始。原因:(1) 免費額度最大方,(2) Google AI Studio 介面最友善,(3) 不需要信用卡就能開始。熟悉基本概念後,再嘗試 OpenAI 和 Claude。
AI API 一定要會寫程式才能用嗎?
不一定。每個平台都有 Playground(圖形化測試介面),不用寫程式就能體驗 AI API 的功能。但如果要整合到自己的產品或自動化流程中,就需要基本的 Python 能力。
立即諮詢,取得最適合您的 AI API 方案
CloudSwap 提供 OpenAI、Claude、Gemini API 企業採購服務:
- 企業專屬折扣,比官價更優惠
- 台灣統一發票,解決海外付款報帳難題
- 中文技術支援,API 串接問題即時協助
參考資料
- OpenAI Platform - API Documentation(2026)
- Anthropic - Claude API Documentation(2026)
- Google AI for Developers - Gemini API Documentation(2026)
- OpenAI - Tokenizer Documentation
- Python - Requests Library Documentation
{
"@context": "https://schema.org",
"@type": "BlogPosting",
"headline": "AI API 入門教學|2026 年從零開始學會串接 OpenAI、Claude、Gemini API",
"author": {
"@type": "Person",
"name": "CloudSwap 技術團隊",
"url": "https://cloudswap.info/about"
},
"datePublished": "2026-03-21",
"dateModified": "2026-03-21",
"publisher": {
"@type": "Organization",
"name": "CloudSwap",
"url": "https://cloudswap.info"
}
}
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "API 串接是什麼意思?",
"acceptedAnswer": {
"@type": "Answer",
"text": "API 串接就是讓你的程式透過標準介面去呼叫另一個服務。AI API 串接就是呼叫 OpenAI、Claude、Gemini 的 API 來使用 AI 功能,不需要自己訓練模型。"
}
},
{
"@type": "Question",
"name": "API 怎麼寫?",
"acceptedAnswer": {
"@type": "Answer",
"text": "以 Python 為例:安裝 SDK(pip install openai)、設定 API Key、呼叫函式即可。核心程式碼通常只需要 5-10 行。"
}
},
{
"@type": "Question",
"name": "新手該從哪個 AI API 開始?",
"acceptedAnswer": {
"@type": "Answer",
"text": "建議從 Gemini API 開始。免費額度最大方、Google AI Studio 介面最友善、不需要信用卡就能開始。"
}
},
{
"@type": "Question",
"name": "API 怎麼用?",
"acceptedAnswer": {
"@type": "Answer",
"text": "最簡單的方式是用 Playground(各平台都有線上測試介面)。進階的方式是用 Python 寫程式碼,透過 SDK 呼叫 API。"
}
},
{
"@type": "Question",
"name": "AI API 一定要會寫程式才能用嗎?",
"acceptedAnswer": {
"@type": "Answer",
"text": "不一定。每個平台都有 Playground 圖形化測試介面,不用寫程式就能體驗。但整合到產品中需要基本的 Python 能力。"
}
}
]
}
