AI API 入門教學｜2026 年從零開始學會串接 OpenAI、Claude、Gemini API

不會寫程式也能看懂！AI API 其實就像「點餐」一樣簡單

你走進一家餐廳，跟服務生說「我要一碗牛肉麵」，服務生把你的需求傳給廚房，廚房做好後端上桌。

AI API 就是這樣。

你（程式）把需求（文字 Prompt）傳給 AI 服務（廚房），AI 處理完後把結果（回應）傳回來。

就這麼簡單。

2026 年，會用 AI API 已經不是工程師的專利。行銷人員用它自動生成文案，客服團隊用它打造聊天機器人，分析師用它處理大量數據。

這篇教學會從最基礎的概念開始，一步一步帶你學會串接 OpenAI、Claude、Gemini 三大 AI API。

想快速上手 AI API？CloudInsight 提供技術支援與企業方案，解決付款和發票問題。

---

API 串接是什麼？一次搞懂基礎概念

Answer-First： API（Application Programming Interface）就是「程式與程式之間的溝通介面」。API 串接就是讓你的程式透過這個介面，去使用別人的服務。

API 的運作原理

用白話文說：

1. 你的程式發送一個 HTTP 請求（Request）給 AI 服務的伺服器
2. 伺服器收到請求，用 AI 模型處理你的問題
3. 伺服器把結果包成 HTTP 回應（Response）傳回來
4. 你的程式收到結果，做後續處理

整個過程要多久，視模型、推理強度與輸出長度而定。

API 串接常見術語

想更深入了解 API 的基礎概念？請參考 API 概念基礎完整指南。

---

AI API 入門三步驟

Answer-First： 串接 AI API 只需三步：(1) 申請 API Key，(2) 安裝 SDK，(3) 寫幾行程式碼發送請求。整個流程 10 分鐘就能完成。

步驟一：申請 API Key

每個 AI 平台都需要先申請帳號並取得 API Key。

關於 Gemini 免費額度： Google 已不再公佈固定的免費額度數字。官方速率限制頁寫明額度依帳號使用層級而定，要看自己的即時配額請登入 AI Studio。所以坊間流傳的「每分鐘 15 次、每日 100 萬 Token」已不適用。另外，影像／影片生成類、Pro Preview 系列與 2026-10-13 GA 的旗艦 Gemini 4 Argon 沒有免費層級。

重要提醒： 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-6-luna",  # 模型 ID 請以 OpenAI 官方文件為準
    messages=[
        {"role": "user", "content": "用一句話解釋什麼是 API"}
    ]
)

print(response.choices[0].message.content)
# 輸出：API 就是讓不同程式互相溝通的標準化介面。

就這樣。五行程式碼，你就成功串接了 AI API。

---

OpenAI API 串接教學

Answer-First： OpenAI 是最多人使用的 AI API 平台。入門最常見的是 Chat Completions，官方新文件則以 Responses API 為起點（GPT-6 Astra、GPT-6.1 Sol 與 10 月 26 日推出的 GPT-6.1 Terra 要用工具呼叫必須走 Responses；GPT-6 Sol／Luna 僅在 reasoning_effort 為 none 時可在 Chat Completions 用 function calling）。2026 年 9 月起的現行主力是 GPT-6 系列（GPT-6 Astra、GPT-6.1 Sol、GPT-6 Luna，以及 10 月 26 日加入、$1／$5 的 GPT-6.1 Terra），7 月推出的 GPT-5.6 三階（Sol／Terra／Luna）與 GPT-5.4-mini／nano 也仍在售（GPT-5.4-nano 將於 2027-04-01 關閉）；GPT-4o、GPT-4o mini、GPT-4.1、GPT-4.1 mini 將於 2027-01-14 關閉（官方建議改用 GPT-6 Luna），gpt-5、o3 系列則於 2026-12-11 關閉，新專案不要再寫死它們（見 OpenAI 退役公告）。

OpenAI API Key 申請

1. 前往 platform.openai.com
2. 註冊帳號並驗證信箱
3. 進入 API Keys 頁面，點「Create new secret key」
4. 複製並安全保存（只會顯示一次）

Python 程式碼範例

from openai import OpenAI

client = OpenAI()

# 基本對話
response = client.chat.completions.create(
    model="gpt-6-luna",  # 模型 ID 請以 OpenAI 官方文件為準
    messages=[
        {"role": "system", "content": "你是一位專業的技術顧問"},
        {"role": "user", "content": "什麼是 REST API？請用簡單的方式解釋"}
    ],
    reasoning_effort="none",  # 不推理時才能調 temperature
    temperature=0.7,
    max_completion_tokens=500
)

print(response.choices[0].message.content)
print(f"使用了 {response.usage.total_tokens} 個 Token")

參數說明：

• model：選擇模型（gpt-6-astra、gpt-6.1-sol、gpt-6-luna，或仍在售的 gpt-5.6-sol、gpt-5.6-terra、gpt-5.6-luna 等）
• reasoning_effort：推理強度；GPT-6 Luna 可設 none（GPT-6 Astra、GPT-6.1 Sol 不支援 none）
• temperature：0 = 確定性高，1 = 創意性高；推理強度不是 none 時不支援，要拿掉
• max_completion_tokens：限制回應長度（含看不到的推理 token，要留餘裕）

完整的 OpenAI API 教學？請參考 OpenAI API 教學｜從 API Key 申請到程式碼範例。

---

Gemini API 串接教學

Answer-First： Gemini API 透過 Google AI Studio 操作最簡單，免費層級覆蓋最廣。現行旗艦是 2026 年 10 月 13 日 GA 的 Gemini 4 Argon（沒有免費層；$2／$10 至 2026-11-30，2026-12-01 起 $4／$20），入門最常用的主力則是 Gemini 3.8 Flash（2026 年 9 月 2 日發布；7 月 21 日發布的 3.6 Flash 已被官方定價頁列為前一代；兩者都是 $0.75／$3.75 至 2026-12-31，2027-01-01 起 $1.50／$7.50），輕量款是 3.5 Flash-Lite（2.5 系列官方只開放給過去實際用過的使用者，新專案拿不到）；Gemini 3.7 Flash 與 3.5 Flash 已於 2026 年 10 月 8 日停用（舊端點自動轉到 3.8／3.6 Flash），Gemini 2.0 Flash 與 2.0 Flash-Lite 已於 2026 年 6 月 1 日關閉，舊教學裡的 gemini-2.0-flash 已無法使用。

Google AI Studio 設定

1. 前往 aistudio.google.com
2. 用 Google 帳號登入
3. 進入 API Keys 頁面（aistudio.google.com/apikey）
4. 新使用者接受服務條款後，AI Studio 會自動建立預設的 Google Cloud 專案與 API Key；既有使用者可先匯入自己的 Google Cloud 專案再建立 Key

Python 程式碼範例

from google import genai

client = genai.Client(api_key="your-api-key")

response = client.models.generate_content(
    model="gemini-3.8-flash",  # 模型 ID 請以 Gemini 官方文件為準
    contents="用一段話介紹台灣的科技產業"
)

print(response.text)

Gemini 的免費層級對學習和原型開發通常夠用，但 Google 已不再公佈固定的免費額度數字——官方速率限制頁寫明依帳號使用層級而定，請登入 AI Studio 查自己的配額。

完整教學？請參考 Gemini 教學｜Google Gemini API 串接與使用完整教學。

遇到串接問題？CloudInsight 技術團隊為您服務，中文即時支援。

---

Claude API 串接教學

Answer-First： Claude API 由 Anthropic 提供，以 Prompt Caching 聞名（快取命中一般為 0.1 倍價，Opus 5.5 與 Sonnet 5.5 為 0.05 倍、Fable 5.1 為 0.025 倍）。現行主力機種（Fable 5.1、Opus 5.5、Sonnet 5.5）內含 100 萬 Token 上下文，且以標準價計費不加價，適合處理長文件；2026-10-07 推出的輕量款 Haiku 5.5 也是 100 萬 Token，但提示 10 萬 Token 以內 $0.10／$0.50、超過改為 $0.50／$2.50。

Anthropic Console 設定

1. 前往 platform.claude.com（Claude Console，舊網址 console.anthropic.com 會自動轉址）
2. 註冊帳號
3. 進入 API Keys 頁面，建立新的 Key
4. 設定付款方式

Python 程式碼範例

import anthropic

client = anthropic.Anthropic()

message = client.messages.create(
    model="claude-sonnet-5-5",  # 模型 ID 請以 Anthropic 官方文件為準
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "請比較 REST API 和 GraphQL 的優缺點"}
    ]
)

print("".join(b.text for b in message.content if b.type == "text"))

Claude 的 Prompt Caching 功能在需要長 System Prompt 的場景（如客服機器人）特別實用，快取命中一般只需原價 10% 的費用，範例用的 Sonnet 5.5 與 Opus 5.5 更只要 5%（5 分鐘寫入 1.25 倍、1 小時寫入 2 倍）。

兩個現在就要知道的注意事項：

1. 現行 Sonnet 5.5 與前一版 Sonnet 5 都是 $2／$10（每百萬 Token）標準價。 Sonnet 5 的價格原本以開跑價公布，官方已明文說原訂 2026-09-01 調到 $3／$15 的計畫不會發生，做預算時不必再預留這筆調漲。
2. Claude 新機種改用了新 tokenizer（Opus 4.7 以後的機種，含現行的 Fable 5.1、Opus 5.5、Sonnet 5.5），同一段文字約多產生 30% Token。所以跨代直接比「每百萬 Token 單價」會低估成本，要比的是跑完同一個任務的實際花費。

---

API 串接練習資源

Answer-First： 學 API 最快的方法是動手做。以下推薦免費的練習平台和工具，讓你不花錢就能上手。

免費 API 練習平台

API Playground 工具推薦

不想寫程式碼？用 Playground 直接測試。

每個 AI 平台都有自己的 Playground（線上測試介面），讓你用圖形介面調整參數、測試 Prompt，不需要寫一行程式碼。

推薦學習路徑：

1. 先用 Playground 熟悉 API 的輸入輸出
2. 再用 Python 寫簡單的程式碼
3. 最後嘗試做一個小專案（如翻譯工具、摘要工具）

想用 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) 免費層級覆蓋最廣（實際配額須登入 AI Studio 查，Google 已不公佈固定值），(2) Google AI Studio 介面最友善，(3) 不需要信用卡就能開始。熟悉基本概念後，再嘗試 OpenAI 和 Claude。

AI API 一定要會寫程式才能用嗎？

不一定。每個平台都有 Playground（圖形化測試介面），不用寫程式就能體驗 AI API 的功能。但如果要整合到自己的產品或自動化流程中，就需要基本的 Python 能力。

---

立即諮詢，取得最適合您的 AI API 方案

CloudInsight 提供 OpenAI、Claude、Gemini API 企業採購服務：

• 企業專屬折扣，比官價更優惠
• 台灣統一發票，解決海外付款報帳難題
• 中文技術支援，API 串接問題即時協助

立即諮詢企業方案 → ｜ 加入 LINE 即時諮詢 →

---

參考資料

1. OpenAI API 官方定價與模型清單（2026-09-30 查核；GPT-6.1 Terra 於 2026-10-28 補查）
2. Claude API 官方定價（2026-09-30 查核；Haiku 5.5 於 2026-10-28 補查）
3. Gemini API 官方定價（2026-09-30 查核；Gemini 4 Argon 與 3.8 Flash 限期價於 2026-10-28 補查）
4. Gemini API 速率限制（免費額度查詢）
5. Python - Requests Library Documentation
6. OpenAI 官方退役公告
7. Gemini API 停用公告