七家 provider 金鑰申請速查

為什麼要這一頁

Pi Agent 支援的 provider 越來越多，但每次要新加一家，你都會撞到同樣三個問題：

• 入口網址在哪？ Google 搜「GLM API」跳出來十幾個看起來很像的頁面，哪個才是真的？智譜開放平台跟智譜清言（AI 對話網站）長得很像、網址完全不同。
• API keys 選單藏哪裡？ 每家後台的名字不一樣——OpenAI 現在統一收在 Settings → API keys、Anthropic 也是 Settings → API keys（左下齒輪進去）、GLM 叫「API 金鑰管理」、DeepSeek 叫 API keys 但入口在左側欄。第一次找常常要點五分鐘。
• Pi Agent 該怎麼填？ 拿到金鑰只是一半，另一半是要在 Pi Agent 的 Models 面板選對 API mode（openai-completions / openai-responses / anthropic-messages / google-generative-ai 四選一）、貼對 baseUrl、指對 model 名字。任何一格填錯都會 Test 紅叉。

這附錄把七家答案一次寫齊。已經看過第 5 章申請 GLM、第 6 章把金鑰貼進 Pi Agent 的話，這裡就是「同樣的流程套到另外六家」的對照表。看過第 10 章為什麼要多接幾家、第 11 章六家對照的話，這裡多出來的是 MiniMax 那家，還有每家的實務坑。

申請 provider 金鑰的通用四步驟

七家長得都不一樣，但流程幾乎是同一套。任何一家新的 provider 上手都是這四步：

1. 註冊帳號

   多數家要 email + 手機驗證。少數（Anthropic、OpenAI）可以用 Google 或 Apple 一鍵登入省掉密碼。中國家（GLM、DeepSeek、MiniMax）通常要中國或台灣手機收簡訊。Groq、OpenRouter 支援 GitHub 一鍵登入。

2. 綁付款方式或吃免費額度

   大部分家新戶都會送一點免費額度：GLM 送幾千萬 tokens、DeepSeek 送幾塊人民幣、Groq 純免費（有 rate limit）、OpenRouter 每天 50 free requests。想長期用就要綁信用卡或儲值。台灣信用卡在 OpenAI／Anthropic／OpenRouter 通常可以，中國家（GLM／DeepSeek／MiniMax）要用支付寶或微信支付。

3. 到「API keys」／「開發者中心」建 key

   每家後台入口位置不同，這附錄每一 section 都寫了確切位置。共同原則：金鑰只在「產生的那一次」看得到完整值，離開頁面之後就只剩前後幾碼給你認。所以按 Copy 之後一定要先貼到密碼管理器（Bitwarden、1Password、Keychain 都行）存一份。

4. 貼進 Pi Agent Models 面板 + Test

   打開 Pi Agent 右上 Models → Add Provider → 填 Name／API mode／baseUrl／apiKey → 加一個 model entry → 按 Test。3-5 秒內綠勾＝連得上，紅叉＝有一格填錯。第 6 章把每一步都拆給你看過，這裡就不重複，直接看每家「Pi Agent 填法」那行照抄。

GLM（智譜清言）

中國智譜 AI 的旗艦系列，性價比高、支援思考塊（reasoning）、200k context。新戶免費額度大方，是台灣使用者「入門第一支金鑰」的常見選擇。第 5 章整章拆解過完整流程，這裡只列速查。

典型 Add Provider 表單填法：

Name:           GLM
API mode:       openai-completions
Base URL:       https://open.bigmodel.cn/api/paas/v4
API key:        (貼你剛複製的那串)
Model name:     glm-4.6
thinkingFormat: zai

OpenAI

ChatGPT 背後的公司，模型指標一直是業界標竿。2026 主力是 gpt-5.6 系列——gpt-5.6-sol（頂配、會 reasoning）、gpt-5.6-terra（均衡、日常主力）、gpt-5.6-luna（便宜、高流量場景）。前代 gpt-4o 系列仍在但已不建議新專案首選。台灣可以用信用卡直接付。

Anthropic

Claude 系列的公司，寫程式跟長文推理特別強、有原生的 thinking blocks（會思考的模型會把思考過程結構化回傳）和 prompt caching（自動快取常見前綴省錢）。這附錄裡唯一一家 api mode 不選 openai-completions 的。

典型 Add Provider 表單填法：

Name:           Anthropic
API mode:       anthropic-messages ← 注意！不是 openai-completions
Base URL:       (留空，用官方預設)
API key:        sk-ant-...
Model name:     claude-sonnet-4-6

DeepSeek

中國幻方旗下的實驗室，V4 系列現在是全球性價比之王之一。相容 OpenAI 格式、API 定價便宜到誇張。注意：舊的 deepseek-chat / deepseek-reasoner 兩個模型名在 2026-07-24 已下架，改用 V4 系列。

Groq

不是 Elon 的 Grok，是另一家做「LPU 推理硬體」的美國公司，強項是速度——大型開源模型在 Groq 上一秒 500+ tokens，比其他家快 5-10 倍。免費 tier 就能用，適合當急件備援。注意：Groq 是本附錄七家裡「模型下架最頻繁」的一家，2026 上半年已把 Llama 3.x 全系列跟舊 Kimi 都退役。

MiniMax

中國 MiniMax 的模型系列，MiniMax-M2 是 2025-2026 的旗艦——1M context、支援 reasoning、相容 OpenAI／Anthropic 兩種格式。特色是超長 context 適合塞整本 PDF 進去問。國際版跟中國版分兩個 endpoint。

OpenRouter

不是 AI 廠商，是「AI 中盤商」——用一支金鑰、一個 baseUrl，就能通吃上百個模型（OpenAI、Anthropic、Google、Meta、Mistral、xAI、Perplexity、DeepSeek、GLM、Cohere 全都在）。台灣信用卡通常可以直接刷，也支援加密貨幣充值。

七家快速對照表

如果只想快速掃一眼、抄一列就走，看這張：

申請常見卡關

七家不同的坑歸納出來就這幾類：

1. 申請完貼進 Pi Agent、按 Test 紅叉

   先按以下順序排查：（1）baseUrl 結尾有沒有多一個 /——例如打成 .../v4/ 而不是 .../v4，多數 provider 會直接 404；（2）金鑰有沒有頭尾空白——網頁選字段常會多選到一格空白，貼進 Pi Agent 前先貼到記事本檢查；（3）api mode 選對沒——Anthropic 用 anthropic-messages，其他六家用 openai-completions，選錯直接 401 或 400；（4）model 名字打對沒——例如 glm-4.6 少打 .6 變 glm-4 就 404 model not found，或還在填 2026-07 前的 deepseek-chat／舊 llama-3.3-70b-versatile 也是同樣結果。第 6 章 troubleshoot 有完整錯誤碼對照。

2. 台灣信用卡刷不了

   依 provider 分開處理：（1）OpenAI／Anthropic——換一張卡，或改用綁在 Apple ID 上的 iCloud 家庭方案卡（那張卡通常過得了）；（2）GLM／DeepSeek／MiniMax（中國家）——找有支付寶／微信支付的朋友代刷儲值，或改走 OpenRouter 用它們的模型（例如 zhipu/glm-4.6、deepseek/deepseek-v4-flash）；（3）MiniMax——選國際版（platform.minimax.io）就能用台灣信用卡刷，中國版才需要支付寶；（4）不想麻煩——用 Wise 或 Revolut 開一張虛擬卡，多數海外 provider 都認；（5）直接用 OpenRouter——它一把 key 通吃多家，儲值時 5.5% 平台費（加密貨幣 5.0%）省下辦 5 個帳號的力氣。

3. 手機驗證卡住（收不到簡訊）

   某些家支援 email 驗證代替手機——OpenAI、Anthropic、Groq、OpenRouter 都可以純 email。中國家（GLM、DeepSeek、MiniMax）比較堅持要手機。台灣門號多數收得到中國家的簡訊，收不到的話：（1）看垃圾簡訊夾；（2）改用中華電信網頁版看有沒有被擋（少數電信商會把大陸來的簡訊當廣告擋）；（3）等 5 分鐘按重發；（4）換另一支台灣號碼試（同一支號常有連續發送冷卻）。

4. 中國家的入口（GLM / DeepSeek / MiniMax）在你家網路打不開

   台灣少數 ISP（例如某些 4G 熱點的分享網路）會擋 *.cn。試三招：（1）手機開網頁看能不能開——手機走 4G 的路徑跟家裡 WiFi 走的 ISP 常常不同，能開就代表是家裡網路的 DNS／防火牆擋住；（2）換 DNS——把家裡 router 或裝置的 DNS 從中華電信預設改成 8.8.8.8（Google）或 1.1.1.1（Cloudflare），多數擋大陸站的 DNS 過濾會失效；（3）還是不行就走 OpenRouter——OpenRouter 的入口是美國 IP，一定能開，然後用它代理連中國家的模型。

5. 金鑰產生後沒複製到、關掉頁面就再也看不到

   七家都一樣：金鑰只在「產生的那一次」顯示完整值，之後回後台只看得到前後幾碼。沒複製到就沒救了，直接把那支停用、重新產生一支新的，這次一定要先貼到密碼管理器再繼續。這不是 bug 是安全設計——如果後台隨時可以複製整支 key，你的密碼一被盜整批 key 就外流。

6. 某家 Test 綠燈，過幾天突然變紅叉

   三個可能：（1）免費額度用完——回該家後台看餘額，儲值就活；（2）模型被下架（Groq 特別常見）——去 provider docs 看該 model 是否還在名單，改成新推薦模型；（3）金鑰被判定異常——某些家（OpenAI 特別嚴）如果偵測到不尋常流量會自動停用金鑰，去後台看有沒有安全通知，需要就重發一支。

常見問題