取得 API Key，開始使用語音輸入
聲筆 Wa-Gong 不代替你支付語音與文字 API 費用。完整流程需要 OpenAI API Key；如果想使用 Groq 進行語音轉錄，再另外建立 Groq API Key。
1先建立 OpenAI Key完整流程必要
2需要時建立 Groq Key語音轉錄選用
3回到 App 設定貼上 Key 並選擇模型
先注意三件事
- OpenAI API Key 是目前完整流程的必要設定；Groq 只能選用於語音轉錄，不能取代文字整理所需的 OpenAI API Key。
- ChatGPT Plus 或其他 ChatGPT 訂閱，不等於 OpenAI API 額度。
- API 使用量由 OpenAI 或 Groq 依你的帳戶計費，請自行設定用量或支出限制。
- API Key 等同密碼。不要貼到公開文章、截圖、GitHub 或寄給任何人；如果懷疑外洩，請立即撤銷並建立新 Key。
API 費用參考
以下是 2026 年 8 月 21 日查閱官方頁面時的參考價格，金額為美元，未包含稅金、匯率或你的服務商帳戶條件。價格可能調整，實際費用請以官方定價頁與帳戶用量頁為準。
語音轉錄
| 服務商 | 模型 | 參考費用 | 計費單位 |
|---|---|---|---|
| OpenAI | gpt-4o-mini-transcribe |
約 US$0.003 | 每分鐘 |
| OpenAI | gpt-4o-transcribe |
約 US$0.006 | 每分鐘 |
| Groq | whisper-large-v3-turbo |
約 US$0.04 | 每小時 |
| Groq | whisper-large-v3 |
約 US$0.111 | 每小時 |
文字整理
| 服務商 | 模型 | 輸入價格 | 輸出價格 | 計費單位 |
|---|---|---|---|---|
| OpenAI | gpt-5.6-luna |
US$0.20 | US$1.20 | 每 1M tokens |
| OpenAI | gpt-5.6-terra |
US$2.00 | US$12.00 | 每 1M tokens |
| OpenAI | gpt-5.6-sol |
US$5.00 | US$30.00 | 每 1M tokens |
文字整理實際費用會依模型、輸入文字、提示詞與輸出文字長度計算。查看 OpenAI 文字模型定價。
提醒：買斷價格只包含聲筆 Wa-Gong App 本身，不包含 OpenAI 或 Groq 的 API 使用費。API 費用直接由你選擇的服務商向你的帳戶收取。
想先估算每月成本？請到 首頁的 API 費用試算，選擇模型與使用量後查看粗估結果。
先設定 OpenAI
- 開啟 OpenAI API Keys。
- 登入或建立 OpenAI API 帳號。
- 建立新的 API Key，建立後立即複製。完整 Key 通常只會在建立時顯示。
- 如果帳戶需要付款設定，請在 OpenAI 平台完成 Billing 設定與用量限制。
- 回到聲筆 Wa-Gong，進入「設定」→「API 管理」，在 OpenAI 欄位貼上並儲存。
OpenAI 語音轉錄可選擇 gpt-4o-mini-transcribe 或 gpt-4o-transcribe。文字整理目前使用 OpenAI Responses API，模型可在處理模式內選擇。
選用 Groq 語音轉錄
- 開啟 Groq API Keys。
- 登入或建立 GroqCloud 帳號，必要時先選擇或建立 Project。
- 建立新的 API Key，建立後立即複製。
- 回到聲筆 Wa-Gong，進入「設定」→「API 管理」，在 Groq 欄位貼上並儲存。
- 在「語音轉錄設定」選擇 Groq，再選擇
whisper-large-v3-turbo或其他可用模型。
Groq 在聲筆中只用於語音轉錄。文字整理仍需要 OpenAI API Key。Groq 的 API Key、模型清單與計費由 Groq 管理，請以 Groq Console 顯示內容為準。
回到 App 後怎麼設定
- 打開聲筆 Wa-Gong 主 App。
- 進入「API 管理」，貼上對應服務商的 API Key。
- 留在「設定」分頁，在「語音轉錄設定」選擇服務商與模型。
- 在「處理模式」確認文字服務商、模型與整理方式。
- 先念一段不含機密資料的短句測試。
API Key 設定完成後：接著新增聲筆鍵盤、開啟「允許完整取用」，並在第一次準備錄音時允許麥克風。請查看 完整的第一次使用步驟。
如何更換或清除 Key
回到「設定」→「API 管理」，選擇服務商後輸入新 Key 並儲存。要停止使用某個服務商，可以清除該欄位。
API 金鑰以 iOS Keychain 加密保存在你的裝置上，僅限本機、不隨 iCloud 同步。所有請求由你的裝置直接送往你選擇的服務商，不經過任何我方伺服器，我們無法看到你的金鑰或語音內容。語音資料的後續處理與保存，依你所選服務商的隱私政策而定。
官方連結
如果 API Key 遺失、費用異常或帳戶被鎖定，請直接聯絡對應 API 服務商。聲筆 Wa-Gong 無法查看或恢復你的 API Key。