設定 Groq API Key
建立你自己的 Groq API Key、存進 App，順便了解免費額度大概夠用多少，以及金鑰出問題時會看到什麼。
這篇能完成什麼
做完這篇，App 會拿到你的 Groq API Key，可以開始辨識語音。大約五分鐘，需要一個 Email 註冊 Groq。
先講一下 Groq 和 API Key
Groq 是負責把聲音轉成文字的雲端服務，這個 App 用的是它的 whisper-large-v3 模型。
API Key 可以想成「你在 Groq 的通行證」。每個人用自己的 Key，用量和額度就算在自己的帳號上，不會跟別人共用，也不會經過我們。所以這一步要請你自己建立，我們沒辦法替你準備。
操作步驟
- 在「歡迎使用 What's up my neighbor」視窗按 開啟 Groq API Keys 網頁。 如果剛剛把視窗關掉了，點選單列的小黑貓 →「設定／更換 Groq API 金鑰…」就能叫回來。
- 瀏覽器會打開 Groq Console 的 API Keys 頁面。第一次用的話，先登入或註冊 Groq 帳號。
- 按 Create API Key，名稱可以隨意取，例如「my-mac」。
- 複製畫面上那串以
gsk_開頭的金鑰。這串字只會完整顯示這一次，先別關掉頁面。 - 回到 App 的視窗，把金鑰貼進輸入欄，按 安全儲存。
預期畫面
- 聽到一聲提示音，接著出現「Groq API Key 已安全儲存」，告訴你可以按 ⌥↑ 開始錄音。
- 按「開始使用」關掉視窗。
金鑰存在 macOS 的鑰匙圈裡。App 不會把它寫進設定檔、記錄檔或任何網頁，這個網站也不會跟你要金鑰。
額度大概夠用多少
Groq 免費方案有速率限制。2026-10-19 在 Groq 官方 Rate Limits 頁面 核對，whisper-large-v3 的公開數字是：
| 限制 | 數值 |
|---|---|
| 每分鐘請求數 | 20 次 |
| 每日請求數 | 2,000 次 |
| 每小時音訊 | 7,200 秒（2 小時） |
| 每日音訊 | 28,800 秒（8 小時） |
一般語音輸入每段大約 5 到 30 秒。就算一天說 200 次、每次 10 秒，也只用掉每日音訊額度的 7% 左右。
Groq 可能調整限制，不同帳號也可能不同，實際數字以你在 Groq Console 看到的為準。這個 App 不會替你購買額度。
金鑰出問題時會看到什麼
| 你看到的訊息 | 代表什麼 | 可以怎麼做 |
|---|---|---|
| 「這看起來不是有效的 Groq API Key」 | 貼上的內容不是 gsk_ 開頭，或沒有貼完整 | 回 Groq Console 重新複製一次 |
| Groq 回傳的錯誤，例如 Invalid API Key，或「Groq 回傳錯誤（HTTP 401）」 | 金鑰被撤銷、打錯，或帳號權限有問題 | 在 Groq Console 建一把新的，從選單「設定／更換 Groq API 金鑰…」換掉 |
| Groq 回傳的錯誤，或「Groq 回傳錯誤（HTTP 429）」 | 用到速率限制了 | 等限制重置後再試；錄音會先保留，不用重講 |
| 「無法把金鑰存入鑰匙圈」 | macOS 鑰匙圈拒絕寫入 | 重開 App 再試一次；仍失敗的話，看 遇到問題 |
保護好你的金鑰
- 金鑰只貼在 App 自己的視窗裡。不要貼進聊天、Email、GitHub Issue 或截圖。
- 如果懷疑金鑰外流了，到 Groq Console 刪掉它、建一把新的，再用選單換掉就好。
- 多帳號或其他方式規避免費限制，違反 Groq 的使用規範，App 也不支援這種做法。
卡住時怎麼辦
按了「開啟 Groq API Keys 網頁」沒反應：直接在瀏覽器打開 console.groq.com/keys 也可以。
不小心按了「稍後設定」：沒關係，選單「設定／更換 Groq API 金鑰…」隨時可以設定。還沒設定金鑰時按快捷鍵，App 不會開始錄音，而是直接跳出設定金鑰的視窗；剪貼簿歷史、桌面小黑貓等其他功能照常可以用。
複製金鑰後關掉了頁面：Groq 不會再完整顯示同一把金鑰。刪掉它、重新建一把就好。
金鑰存好了，下一篇開始說第一句話。
內容和 App 畫面對不上，或步驟走不下去？可以到 GitHub Issues 告訴我們是哪一篇、哪一步。