返回首頁AI API

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

15 min 分鐘閱讀
#AI API#API 教學#API 串接#OpenAI#Claude#Gemini#Python#API Key#入門教學#程式碼範例

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

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

AI API 就是這樣。

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

就這麼簡單。

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

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

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

API 請求/回應流程圖


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

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

API 的運作原理

用白話文說:

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

整個過程通常在 1-5 秒內完成。

API 串接常見術語

術語白話解釋餐廳比喻
API Key你的身分證明(一串密鑰)會員卡
EndpointAPI 的網址餐廳地址
Request你傳給 API 的資料你的點餐單
ResponseAPI 回傳的結果上桌的餐點
TokenAI 處理文字的最小單位一口飯的大小
Rate Limit每分鐘可以發幾次請求每小時最多點幾道菜
SDK官方提供的程式庫,簡化串接餐廳 App,一鍵下單

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


AI API 入門三步驟

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

步驟一:申請 API Key

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

平台申請網址免費額度
OpenAIplatform.openai.com有限免費額度,實際條件以官網為準
Anthropic(Claude)console.anthropic.com有限免費額度
Google(Gemini)aistudio.google.com依帳號使用層級而定,須登入查詢(見下方說明)

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

重要提醒: 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-5.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 平台。核心 API 是 Chat Completions。2026 年 7 月的現行機種是 GPT-5.6 三階(Sol/Terra/Luna)與 GPT-5.4-mini/nano;GPT-4o 已非現行機種,新專案不要再寫死它

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-5.6-terra",  # 模型 ID 請以 OpenAI 官方文件為準
    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.6-sol、gpt-5.6-terra、gpt-5.6-luna、gpt-5.4-mini、gpt-5.4-nano)
  • temperature:0 = 確定性高,1 = 創意性高
  • max_tokens:限制回應長度

完整的 OpenAI API 教學?請參考 OpenAI API 教學|從 API Key 申請到程式碼範例


Gemini API 串接教學

Answer-First: Gemini API 透過 Google AI Studio 操作最簡單,免費層級覆蓋最廣。現行主力是 Gemini 3.6 Flash(2026 年 7 月 21 日發布)與 3.5/2.5 Flash-Lite;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. 點「Get API Key」→「Create API Key」
  4. 選擇或建立 Google Cloud 專案

Python 程式碼範例

from google import genai

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

response = client.models.generate_content(
    model="gemini-3.6-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 省 90%(快取命中僅 0.1 倍價)聞名。現行機種(Fable 5、Opus 4.8、Sonnet 5、Sonnet 4.6)內含 100 萬 Token 上下文,且以標準價計費不加價,適合處理長文件。

Anthropic Console 設定

  1. 前往 console.anthropic.com
  2. 註冊帳號
  3. 進入 API Keys 頁面,建立新的 Key
  4. 設定付款方式

Python 程式碼範例

import anthropic

client = anthropic.Anthropic()

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

print(message.content[0].text)

Claude 的 Prompt Caching 功能在需要長 System Prompt 的場景(如客服機器人)特別實用,快取命中只需原價 10% 的費用(5 分鐘寫入 1.25 倍、1 小時寫入 2 倍)。

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

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

三大 AI API 程式碼範例對比


API 串接練習資源

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

免費 API 練習平台

平台說明網址
Google AI StudioGemini 免費層級(配額依帳號而定,登入可查)aistudio.google.com
OpenAI Playground視覺化測試介面(需帳號)platform.openai.com/playground
Anthropic WorkbenchClaude 測試介面console.anthropic.com
Postman通用 API 測試工具postman.com
HTTPie命令列 API 測試工具httpie.io

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 年 7 月查核)
  2. Claude API 官方定價(2026 年 7 月查核)
  3. Gemini API 官方定價(2026 年 7 月查核)
  4. Gemini API 速率限制(免費額度查詢)
  5. Python - Requests Library Documentation

需要專業的雲端建議?

無論您正在評估雲平台、優化現有架構,或尋找節費方案,我們都能提供協助

預約免費諮詢

相關文章