Vibe Coding — Stage 2 · 串 AI
M2-4

Vibe Coding 實戰課 — Stage 2 · 串 AI

免費 AI API
全攻略

三大免費平台 + 用量限制 + 做出你的 AI 工具

M2-4 3 小時 6 輪循環 帶走成品

按 → 或空白鍵開始

六輪循環,逐層遞進

Round 1
三大 API 導覽
Round 2
申請第二個 API
Round 3
IDE 串接做工具
Round 4
RPM 撞牆
Round 5
期末成品
Round 6
Stage 2 回顧

這一堂的主線
認識免費 API 生態系 → 親手申請 → 串接工具 → 撞 RPM → 完成期末成品

Stage 2 進度定位

M2-1GitHub Pages
M2-2搬家 + Secrets
M2-3IDE + Git
M2-4免費 API
今天的目標

拿到 API Key → 用 IDE 串接成工具 → 理解 RPM 限制 → Stage 2 期末成品上線

回顧:M1-4 已經做過什麼

1
申請了 Groq API Key

第一個免費 API,LPU 極速推論

2
用 GAS 串接 Groq

Google Apps Script 呼叫 API,做出第一個 AI 工具

3
今天的延伸

從一家餐廳 → 認識整個美食街

ROUND 1 · 0:00–0:20

三大免費
API 平台

不是只有一家餐廳,每家的菜色和份量不同

API 生態系

不是只有一家餐廳
每家的菜色和份量不同
核心原則:主力 + 專長 + 備援
Groq
主力日常
+
Google AI Studio
長文本專家
+
OpenRouter
備援多模型

Groq — 主力日常用

LPU 極速推論

自研硬體,回應速度遠快於 GPU 方案
M1-4 已經用過

OpenAI 兼容格式

換 endpoint 就能切換
學一套用到底

不需信用卡

註冊即用
免費額度充足

主力模型:llama-3.3-70b(日常)/ qwen3-32b(寫程式)/ llama-3.1-8b(大量任務)

Google AI Studio — 長文本專家

1M Context Window

能一次吃進整本書
適合長文件分析

Gemini 2.5 系列

Flash 快速 / Pro 最強推理
兩種模型自由切換

Google 帳號即用

不需另外註冊
不需綁信用卡

GAS 注意事項

直接呼叫走 GCP 需 Billing → 用 UrlFetchApp 呼叫 AI Studio endpoint 就免費

OpenRouter — 備援多模型

28 個免費模型

一個帳號
用遍所有模型

統一 API 格式

換 model name 就能切
不用學不同 SDK

備援角色

Groq 撞額度時
切到 OpenRouter 繼續

2026 免費 API 額度表

平台主力模型RPMRPD最佳場景
Groqllama-3.3-70b301,000日常聊天、快速回應
Groqqwen3-32b / kimi-k2601,000寫程式、強推理
Groqllama-3.1-8b3014,400大量簡單任務
AI Studiogemini-2.5-flash10250長文本分析 (1M ctx)
AI Studiogemini-2.5-pro5100最強推理
OpenRouter28 個免費模型2050備援、多模型測試
注意

開課前 1 週重新查驗 — Groq 額度每天太平洋午夜重置

核心策略:主力 + 專長 + 備援

Groq
主力日常
最快最多
Gemini
長文本專家
1M context
OR
備援多模型
28 個免費

不要把雞蛋放在同一個籃子裡

免費 API 隨時可能調整額度
有備援才不會被卡住

即時展示:同一個問題問三個 API

1
送出同一段 prompt

觀察回應速度差異

2
比較回應內容

模型不同,風格與深度不同

3
記下你的觀察

哪個最快、哪個最詳細、哪個格式最好

Round 1 小結

API 生態系

三大平台各有專長
Groq 主力 / Gemini 長文本 / OpenRouter 備援
都不需要信用卡

ROUND 2 · 0:20–0:45

申請
第二個 API

主力 + 備援,不要只靠一家

路線 A:Google AI Studio

1
前往 aistudio.google.com

登入你的 Google 帳號

2
建立 API Key

左側選單 → Get API Key → Create

3
複製並保存

存到 .env 檔案 → 同時存到 GitHub Secrets

完成條件

拿到 GEMINI_API_KEY 且存入 .env 和 GitHub Secrets

路線 B:OpenRouter

1
前往 openrouter.ai

註冊帳號(可用 Google / GitHub 登入)

2
取得 API Key

Keys 頁面 → Create Key

3
選一個免費模型測試

Playground 裡篩選 Free 模型 → 測試對話

API Key 安全提醒

WRONG

直接貼在程式碼裡

const key = "AIza..."

push 到 GitHub → 全世界都看得到

CORRECT

放在 .env + .gitignore

GEMINI_KEY=AIza...   ← .env
.env                 ← .gitignore

回扣 M2-2 安全 Checklist

.env 檔案管理你的 API Keys

.env
# M1-4 已申請
GROQ_API_KEY=gsk_xxxxxxxxxx

# 今天新申請
GEMINI_API_KEY=AIzaxxxxxxxxxx
OPENROUTER_API_KEY=sk-or-xxxxxxxxxx
.gitignore
.env
.env.*

同步到 GitHub Secrets — M3-4 的 GitHub Actions 會直接從 Secrets 讀取

API 格式差異

Groq / OpenRouter

OpenAI 兼容格式
換 endpoint 就能切
學一套用到底

Gemini AI Studio

Google 自有格式
不同但不難
AI 幫你處理轉換

實際操作

告訴 AI「用 Gemini API 格式呼叫」→ AI 自動產生正確的 fetch 程式碼

操作確認

Groq API Key

M1-4 已申請,存在 .env 中

2
第二個 API Key

AI Studio 或 OpenRouter,存到 .env + GitHub Secrets

3
.gitignore 有 .env

確認 Key 不會被 push 到 GitHub

Round 2 小結

主力 + 備援

你現在有兩個(或三個)免費 API Key
都不需信用卡
Key 安全存放在 .env + GitHub Secrets

ROUND 3 · 0:45–1:10

用 IDE
串接做工具

跟 AI 說你要什麼,API 串接它來處理

選一個你想做的 AI 工具

AI 摘要器

貼入長文
自動產出重點摘要

多語翻譯

一鍵翻譯多國語言
保留格式

文件分析

上傳文件
AI 幫你找重點

每日金句

每天生成勵志句
搭配精美排版

跟 AI 下指令

PROMPT
幫我做一個 AI 摘要器
用 Gemini API
Key 從 .env 讀取
前端用 HTML + CSS
後端用 JavaScript fetch
使用者貼入文字 → 按按鈕 → 顯示摘要

AI 會幫你做:建前端介面 + 寫 API 呼叫邏輯 + 錯誤處理

IDE 串接工作流

描述需求
AI 產生程式碼
測試
修正
完成
M1-4 GAS 串 Groq

在 Google Apps Script 裡寫

要手動處理格式

部署步驟多

M2-4 IDE 串 API

在 IDE 裡跟 AI 協作

AI 幫你處理一切

更快、更靈活

API 呼叫的基本結構

FETCH 呼叫
const response = await fetch(ENDPOINT, {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${API_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "模型名稱",
    messages: [{ role: "user", content: "你的問題" }]
  })
})

你不需要背 — AI 會幫你寫
但你要看得懂 endpoint / model / messages 三個關鍵

三大平台 Endpoint 對照

平台Endpoint格式
Groqapi.groq.com/openai/v1/chat/completionsOpenAI
AI Studiogenerativelanguage.googleapis.com/v1betaGoogle
OpenRouteropenrouter.ai/api/v1/chat/completionsOpenAI
快速切換

Groq 和 OpenRouter 格式相同 — 換 endpoint + model name 就能切

操作時間

25
分鐘
用 IDE + AI 做出你的第一個 AI 工具
1
選一個工具主題

摘要器 / 翻譯 / 文件分析 / 每日金句

2
跟 AI 描述需求

指定用哪個 API + Key 從 .env 讀取

3
測試、修正、確認可用

至少成功呼叫一次 API 拿到回應

觀察:IDE 串接 vs GAS 串接

跟 M1-4 用 GAS 串 Groq 相比
IDE 裡做更快、更靈活
M1-4
GAS + Groq
手動處理格式
M2-4
IDE + 任意 API
AI 幫你處理一切

串接常見問題

!
CORS 錯誤

瀏覽器直接呼叫 API 被擋 → 用後端 proxy 或 serverless function

!
401 Unauthorized

Key 錯誤或過期 → 重新檢查 .env 裡的值

!
回應格式不對

不同 API 回傳結構不同 → 用 console.log 看完整回應

Round 3 小結

你的第一個 AI 工具

用 IDE + AI 完成了一個真正能用的工具
前端 + API 串接 + 錯誤處理
這就是 Vibe Coding 的核心流程

ROUND 4 · 1:10–1:30

RPM
撞牆體驗

免費不是無限 — 做 API 專案前先算用量

設計會撞牆的任務

用你的 AI 工具
批量處理 30 段文字
迴圈連續呼叫 → 前幾次成功 → 然後...
呼叫 1
呼叫 2
...
呼叫 15
被擋

撞牆了

429
Too Many Requests
被擋了
只做了 15 個就停了
這就是 Rate Limiting — 每分鐘有上限

Rate Limiting 三個維度

RPM
Requests Per Minute
每分鐘最多幾次
RPD
Requests Per Day
每天總額度
Token
Token Limit
每次份量上限

RPM 是最容易撞到的牆 — Groq 30 RPM = 每 2 秒才能呼叫一次

各平台 RPM 比較

Groq
30 RPM
Gemini
10 RPM
OpenRouter
20 RPM
現實

Gemini Pro 最強但 RPM 最少(5 RPM)→ 不適合批量任務

升級:加上延遲

沒延遲

連續呼叫 → 429 被擋

30 個任務只完成 15 個

加延遲(每次 2 秒)

慢但穩 → 全部完成

30 個任務 × 2 秒 = 1 分鐘搞定

延遲策略
for (const item of items) {
  await callAPI(item)
  await sleep(2000)  // 等 2 秒再呼叫下一個
}

經典案例:沒設限額的後果

$200
某人一個月的 API 帳單
1
沒設每月限額

付費 API 沒有設 budget cap

2
寫了一個無限迴圈

bug 導致程式不斷呼叫 API

3
月底收到帳單

免費 API 撞 RPM 只是被擋,付費 API 撞的是錢包

做 API 專案前先算用量

1
估計每日呼叫次數

你的工具一天會被用幾次

2
對照 RPD 額度

Groq 1,000 RPD / AI Studio 250 RPD / OpenRouter 50 RPD

3
需要更多 → 組合多平台

Groq 用完切 OpenRouter → 再切 AI Studio

Rate Limiting = 限速

免費 ≠ 無限

每個 API 都有看不見的天花板
做 API 專案前先算用量
撞牆不可怕 — 可怕的是不知道牆在哪裡

Round 4 小結

429
撞牆體驗
每分鐘有上限
2s
延遲策略
慢但穩

帶走:RPM / RPD / Token Limit 三個維度 + 延遲策略 + 用量規劃意識

ROUND 5 · 1:30–1:55

Stage 2
期末成品

完善工具 + 部署上線 + 互測回饋

期末成品要求

1
功能完整

Round 3 的工具能正常運作,不會 crash

2
安全合格

.env 存 Key + .gitignore 排除 → M2-2 安全 Checklist

3
部署上線

push 到 GitHub → GitHub Pages 部署

4
用量提示 + 錯誤處理

429 時顯示友善訊息、不要整個頁面爆掉

完善你的 AI 工具

1
加上 Loading 狀態

呼叫 API 時顯示「處理中...」

2
加上錯誤處理

429 → 「請稍後再試」/ 401 → 「API Key 有誤」

3
優化介面

排版美化、手機版適配、操作說明

部署到 GitHub Pages

git add .
git commit
git push
Pages 部署
上線
注意

免費 Key + 個人課堂用 OK
正式專案要怎麼保護 Key,Stage 3 會教進階做法

前端 API Key 的現實

課堂練習

免費 Key + 個人使用

前端直接呼叫可以接受

被盜用也不會花錢

正式專案

付費 Key + 公開使用

必須走後端 proxy

Stage 3 會教進階做法

交換網址,互相測試

1
分享你的 GitHub Pages 網址

貼到群組讓大家看到

2
測試三位同學的工具

實際使用、找 bug、觀察差異

3
給回饋

什麼好用、什麼卡住、什麼可以改

互測觀察重點

功能性

API 有回應嗎
結果正確嗎
錯誤有處理嗎

使用體驗

操作直覺嗎
有 Loading 提示嗎
手機能用嗎

安全性

打開 DevTools
看得到 Key 嗎
.gitignore 有設嗎

Round 5 小結

Stage 2 期末成品上線

一個真正能用的 AI 工具
部署在 GitHub Pages 上
任何人都能打開使用

ROUND 6 · 1:55–2:05

Stage 2
回顧

四個模組、四層能力

六維度反思

學到什麼

新概念、新工具

做到什麼

實際完成的成品

卡在哪裡

遇到的困難

怎麼解決的

解題策略

想做但還沒做

延伸想法

下一步是什麼

Stage 3 目標

帶走清單

本堂定位 免費 API 體驗 — 找出生存之道

不只學了什麼,是想法怎麼變了
從「AI 是訂閱服務」→ AI 是可調度的基礎資源

從「AI 就是買會員」
模型是可調度資源
從「多申請很麻煩」
備援是使用者主權
從「API 離我很遠」
能力可以嵌進工具
從「撞牆代表失敗」
限制是系統設計題
從「成品靠靈感」
成品來自資源編排
從「我在用 AI 產品」
我在配置 AI 基建

Stage 2 能力升級

Stage 1
用 AI 做作品
Stage 2
串 AI 做工具
Stage 3
造 AI 做系統
你的進度

從「跟 AI 聊天產出作品」到「用 API 串接做出自己的 AI 工具」
這是從使用者到開發者的關鍵跨越

M2-4 注意事項總覽

#常見問題學到什麼
1API Key 直接貼程式碼安全 Checklist 復用
2GAS 呼叫 AI Studio 需 Billing用 UrlFetchApp 繞過
3撞 RPM 429Rate Limiting
4免費 ≠ 無限用量規劃
5批量任務超時延遲策略

NEXT STAGE

Stage 3
造 AI

IDE Extension → CLI → MCP → Skills

Stage 3 預告

CLI 模式

從 Extension 升級到 CLI
更快更強更自動

MCP 工具

AI 接上更多工具
能力無限擴展

Skills 記憶

AI 永遠記住你教的技能
不用每次重說

下一堂銜接

你今天申請的 API Key 已存在 GitHub Secrets 裡
M3-4 的 GitHub Actions 會直接用

Stage 3 課前準備

P1
P3-1 課前單元

安裝 CLI 環境

P2
P3-2 ~ P3-3

MCP 基礎概念 + Skills 初探

P3
P3-4 ~ P3-5

CLI 操作練習 + 進階設定

重要

Stage 3 課前準備必須完成 → 上課才能直接動手

M2-4 完成

三大免費 API
+ 你的 AI 工具

從使用者到開發者的關鍵跨越

Groq + Gemini + OpenRouter RPM 意識 期末成品

Stage 2 完成 — Stage 3 見

1 / 58
章節