加第一個 AI 大腦：申請 GLM 金鑰

為什麼還要自己去申請一個金鑰

你在第 1 章就聽過：Pi Agent 是「BYOK（Bring Your Own Key，帶你自己的鑰匙來）」的設計。也就是說，這個附加元件本身完全不會幫你決定要用哪家 AI、也不會幫你付錢——你要自己去 AI 廠商那邊申請一支鑰匙，貼進來它才會動。

可以把它想像成剛裝好的音響：喇叭、擴大機都齊了，但你要自己插上一台 CD 播放機它才唱得出來。這一章教你去買第一張 CD，下一章教你怎麼把 CD 塞進去。

那為什麼第一支選 GLM（智譜清言）？有三個直白的理由：

• 不用翻牆——GLM 是中國那邊的公司，服務就開在對岸，台灣家用光世代直連沒問題。相對地，OpenAI（ChatGPT 的公司）在台灣沒有官方入口，你要嘛用 VPN、要嘛透過中轉服務，麻煩很多。
• 註冊就送額度——一支手機號碼註冊完，帳戶馬上有一筆免費配額可以直接開玩，不用先綁信用卡。輸個簡訊驗證碼你就可以在 Pi Agent 裡面聊了。
• 中文回應最順——GLM 是為中文語境訓練的模型，回台灣中文比 OpenAI 或 Anthropic 的模型自然。你問「客廳幾坪要選幾噸冷氣」，它不會用翻譯腔回你。

API 金鑰（API key）到底是什麼

你去餐廳吃飯，服務生會發你一張卡：上面有你的桌號、你點的東西都記在這張卡上，最後結帳的時候老闆看卡出帳。API 金鑰就是這張卡——AI 廠商認的不是你這個人，是這張卡。任何人拿著這張卡去點東西，都會算到你頭上。

技術上白話講：API 金鑰是一串長長的英文加數字，GLM 傳統上發的格式是「前段.後段」中間有一個「`.`」點號（例如 abc123def456.XYZ789QWE0），實際字元數與格式以 GLM 產出的當下畫面為準。你把它貼進 Pi Agent 之後，Pi Agent 每次要問 AI 都會把這串字附在請求裡送過去，GLM 那邊看到就知道「這是誰在用、要跟誰扣錢」。

Pi Agent 這邊有一個貼心的設計：從 v0.13.0 版開始，金鑰只存在你家 HA 主機的 /data/pi-agent/models.json 這個檔案裡，Woow 這邊看不到、其他人也看不到。你把 HA 主機 snapshot 備份的時候，金鑰會一起被打包走；主機壞了還原之後，金鑰也一起回來，不用重新申請。這在第 1 章就講過了。

GLM 是什麼、跟 ChatGPT 差在哪

你可能沒聽過智譜清言（英文：Zhipu AI），但它在中國就跟 OpenAI 在美國一樣有名。這家公司總部在北京清華大學附近，主打的模型叫「GLM」系列。你這一章申請的金鑰可以呼叫他們家所有的 GLM 模型，示範會以 GLM-4.6 為主（他們目前還有更新的 GLM-4.7、GLM-5 系列，你拿到金鑰之後在 Pi Agent 的 Models 面板都能切；模型清單以 docs.bigmodel.cn 官網為準）。

下面這張表用你熟悉的 ChatGPT 當對照，讓你有個譜：

申請 GLM 金鑰完整流程

從打開網站到金鑰躺在你剪貼簿裡，總共八步，全程手機或電腦都可以做。以下步驟以電腦瀏覽器為準，手機上按鈕位置類似。

1. 打開 GLM 開發平台

   在瀏覽器打 https://open.bigmodel.cn/ 直接開這個網址。注意是 open.bigmodel.cn 不是 chatglm.cn——後者是一般消費者用的聊天網頁（類似 ChatGPT 網頁版），前者才是給開發者拿 API 金鑰的地方。你要進的是後者，也就是 open. 開頭那個。

2. 右上角按「登入 / 註冊」

   頁面右上角有「登錄」或「登入」的按鈕（介面可能只有簡體字，別緊張，操作是一樣的），按下去會跳到登入頁。第一次來的話下面會有一個「立即註冊」的連結，點它。

3. 用手機號碼或 email 註冊

   註冊頁預設通常是「手機號碼註冊」。國碼列表可以下拉找 +886（台灣）——如果找不到或簡訊收不到，直接切到「郵箱註冊」tab 用 email 也行（實際 tab 名稱與版面以官網為準，GLM 常改版）。手機號碼開頭那個「0」不用打，例如 912345678。填完按「取得驗證碼」，等 10-30 秒簡訊或信箱驗證信會到，把驗證碼填進去、設一個密碼（規則以官網當下的提示為準，通常要英文加數字 8 位以上），按「註冊」就完成了。

4. 登入後進後台（個人中心／工作台／控制台）

   註冊完會自動登入，也可能被丟回首頁要你再登一次——都正常。登入之後，滑鼠移到右上角你的頭像（或一個人像圖示），會下拉一個選單，選類似「個人中心」、「工作台」或「控制台」的入口（不同版本文字略有差異，選單位置以官網當下版面為準）。目標是進到一個左邊有側欄的開發者後台頁面。

5. 在左邊側欄找「API 金鑰」

   左側欄找一個帶有「API Keys」、「API 金鑰」、「APIKey 管理」或類似字樣的項目（實際文字以官網為準，GLM 常改版）。點進去，你會看到一個列表；第一次來通常是空的，會有一個「建立新的 API Key」或「+ 添加新的 API Key」的按鈕。

6. 按「建立新金鑰」，取一個好認的名字

   按「建立」按鈕會跳一個小視窗要你幫這個金鑰取名字。強烈建議取有意義的名字——例如 pi-agent-家裡、pi-agent-辦公室、test-2026-08。以後你如果會申請第二支、第三支給不同機器用，看名字就知道哪支是哪支，要作廢也不會作廢錯。

7. 複製金鑰（通常只顯示一次！）

   按確定之後，畫面會顯示這串金鑰，GLM 傳統格式是「前段.後段」中間有一個「.」點號（例如 abc123def456ghi789jkl012.XYZABCDEFGHIJKLM），如果有點號要兩段一起複製，一整串不能漏。右邊通常有一個「複製」的圖示按鈕，點它最保險。大多數 API 平台的完整金鑰只顯示這一次（GLM 也是這樣設計），關掉視窗再回列表時通常只會看到前幾碼遮罩後的預覽（例如 abc123def4…），完整內容看不到了。

8. 馬上貼到密碼管理器或記事本存起來

   複製完不要直接關頁面。打開你的密碼管理器（1Password、Bitwarden、Apple Keychain 都行），開一筆新記錄，把金鑰貼進去，標題寫「GLM API Key - 家裡 Pi Agent」之類。如果你沒有密碼管理器，先貼在一個本地的記事本檔案裡（別放桌面截圖分享出去），等下一章教你怎麼貼進 Pi Agent 之後再刪掉。

費用怎麼算、新戶送多少

GLM 的計費單位是「tokens（詞元）」。一個 token 大概等於半個中文字、或一個英文單字的一部分。你打「你好，今天天氣如何？」大概是 8-10 tokens，AI 回你「今天台北多雲時晴，最高 28 度，早晚較涼建議帶薄外套。」大概是 25-30 tokens。所以一輪對話 30-50 tokens 是常見數字。

GLM 系列價格與新戶贈送方案 GLM 官方會不定期調整（近期他們把新戶贈送從「送 CNY 額度」改成直接送幾千萬 tokens，你可能會看到「註冊送 2000 萬 tokens」之類的活動）。下面數字僅供大略體感，實際請到 open.bigmodel.cn/pricing 官網為準：

那實際使用一個月大概花多少？拿家用場景抓個粗略概念（單價會浮動，這裡的台幣金額是體感值，實際以官網當下計費與你的使用量為準）：

實名認證要不要做

你註冊完只填手機號碼或 email、沒填身分證，這叫「未實名」帳號。未實名可以用完全部送的免費額度，但當你想儲值買更多額度、或想用某些進階／推理模型時，通常會被擋下來要求你先做「實名認證」（哪些模型會被鎖，以官網當下公告為準，這條 GLM 也會調）。

實名認證要什麼？中國大陸的實名法規通常會要中國身分證號＋支付寶／微信人臉辨識這類流程。如果你是台灣人、沒有中國大陸身分證，通常這一關過不了（實務上 GLM 曾開放過幾種替代驗證方式，最新受理範圍以官網為準）。那怎麼辦？下面幾個選項：

金鑰放哪、不要放哪

再講一次，因為這是最容易踩雷的地方。金鑰＝你的錢包裡的信用卡，處理方式要跟信用卡一樣小心。

可以放的地方（安全）：

• Pi Agent 的 Models 面板——這是這支金鑰的「家」，下一章會教你貼進去。它會存在你家 HA 主機的 /data/pi-agent/models.json，本地檔案，除非有人拿到你家 HA root 權限否則看不到。
• 你自己的密碼管理器——1Password、Bitwarden、Apple Keychain、KeePass 都行。這些工具本來就是為「敏感字串」設計的，加密妥當。
• 離線的紙本或加密隨身碟——最原始也最安全，如果你會這樣搞的話。

絕對不要放的地方（會被抓）：

• GitHub 公開 repo——這是最經典的踩雷點。有大量爬蟲工具 24 小時掃 GitHub 找洩漏的金鑰，你 push 上去不到一小時就會被抓。就算你事後 delete commit 也救不回來，因為 git 歷史還留著。
• Line / Telegram / Discord 群組——群組管理員的伺服器紀錄裡有你的訊息。就算你事後撤回，別人手機截圖你也不知道。
• Google Docs / Notion 共享頁面——分享連結設「知道連結的人都能看」等於公開。就算設「僅特定人」，那個人的帳號被盜你就掰了。
• 論壇貼文問問題——這是新手最愛踩的雷：「我這個金鑰貼進 Pi Agent 錯誤是這樣，請問怎麼辦？」貼之前記得把金鑰打掉，換成 abc123.XXX...（打碼）。
• 電子郵件——email 傳輸通常不加密，中繼點都能看，別把金鑰用 email 傳給人。
• 截圖分享——截圖裡看得到的字，AI OCR 都讀得出來。

一定要用 GLM 嗎？可以先跳過嗎

不一定。這一章拿 GLM 當第一支金鑰的示範，理由是「最省麻煩、最快看到 AI 回你話」，但你完全可以直接跳去其他家。下面這張表比較幾個常見選擇：

常見卡關

1. 手機收不到簡訊驗證碼

   幾個可能原因：（a）國碼選錯了——找 +886（台灣），不要用 +86；如果國碼下拉選單找不到 +886，那可能是 GLM 當下不受理台灣門號，直接跳去 email 註冊。（b）手機號碼開頭那個「0」不用打，直接從 9 開始。（c）電信商可能擋到境外簡訊——等 3 分鐘按「重新發送」，再不行就換註冊頁上的「郵箱／Email」註冊 tab（版面文字以官網當下版本為準）。（d）都不行的話，海外門號或請有中國門號的朋友幫忙代收驗證碼也是選項。

2. 金鑰複製沒複製到中間那個點

   金鑰的格式一定是「前段.後段」——中間有個「.」（小數點），兩段都要一起複製才是完整的一把。有人習慣選字元的時候用滑鼠拖，拖到那個點卡一下，結果只拖到前段。建議按複製按鈕，不要手動選字。如果不小心貼進 Pi Agent 之後跑 Test 說「invalid key」（金鑰無效），第一件事是回去看你手上這串有沒有中間那個點。

3. 金鑰忘記存、關掉視窗才發現沒複製

   幾乎沒救，這串通常不會再被完整顯示第二次（多數 API 平台是為了安全採「後端不存明文、只存驗證用的雜湊值」這種設計，GLM 也走這條路）。做法只有一個：回 API 金鑰列表把這支「刪除」／「作廢」（沒用過的直接刪，不會有帳單問題），然後按「建立新金鑰」重來一次，這次專心複製。

4. 註冊送的額度顯示 0 或看不到

   先確認位置：後台左側欄找類似「資源總覽」、「資源包」、「我的套餐」、「Billing」、「積分」的入口（實際文字以官網當下版面為準），額度會顯示在那邊，不是在 API 金鑰頁。如果那頁顯示 0，試試看：（a）按瀏覽器重新整理 F5——有時候是快取。（b）登出再登入一次。（c）如果都試過還是 0，可能你註冊的時間點剛好活動結束或還沒開始；此時 GLM 家的 Flash 系列（例如 GLM-4-Flash、GLM-4.7-Flash 這類輕量／免費模型，實際型號以官網為準）通常還是能用，可以先切這個玩玩。或者你的帳號可能被判定為「非活躍」，過幾天再看看。

5. 網頁介面主要是簡體字，看不習慣

   open.bigmodel.cn 主要以簡體中文呈現（是否有繁中／英文切換以官網為準，若沒有語系選單就是沒開放）。字型顯示會稍微怪但都看得懂。手機瀏覽器可以開「網頁翻譯」，Chrome 桌機可以用「Google 翻譯」擴充功能，把「注册」翻成「註冊」、「密钥」翻成「金鑰」，讀起來會順一點。

6. 網址打錯進到 chatglm.cn 找不到 API 金鑰

   chatglm.cn 是 GLM 給一般消費者聊天的網頁介面（類似 chat.openai.com），那邊沒有開發者 API 功能。要拿 API 金鑰只能到 open.bigmodel.cn——中間有個 open. 開頭，不要漏。如果你不小心跑到 chatglm.cn 註冊了帳號，理論上帳號是通的（同一家公司），直接切去 open.bigmodel.cn 登入試試看，通常可以直接進。

常見問題