取得 API Key，開始使用語音輸入

聲筆 Wa-Gong 不代替你支付語音與文字 API 費用。語音轉錄可使用 OpenAI 或 Groq；文字整理可使用 OpenAI、Google Gemini 或 Claude。若處理模式關閉文字整理 API，停止錄音後會直接使用轉錄結果。

1建立語音轉錄 KeyOpenAI 或 Groq

2需要時建立文字整理 KeyOpenAI、Gemini 或 Claude

3回到 App 設定貼上 Key 並選擇模型

先注意幾件事

語音轉錄至少需要 OpenAI 或 Groq API Key，請依「語音轉錄設定」中選擇的服務商建立對應 Key。
文字整理可選擇 OpenAI、Gemini 或 Claude。若處理模式關閉「使用文字整理 API」，則不需要文字整理服務商 Key，停止錄音後會直接插入轉錄結果。
ChatGPT、Gemini 或 Claude 的訂閱不包含這裡使用的 API 額度；Claude Pro／Max 也不能代替 Anthropic API Key。
API 使用量由 OpenAI、Google Gemini、Anthropic 或 Groq 依你的帳戶計費，請自行設定用量或支出限制。
API Key 等同密碼。不要貼到公開文章、截圖、GitHub 或寄給任何人；如果懷疑外洩，請立即撤銷並建立新 Key。

API 費用參考

以下為參考價格：既有模型於 2026 年 8 月 21 日查閱，新增 Claude Haiku 4.5 於 2026 年 9 月 16 日核對，金額為美元，未包含稅金、匯率或你的服務商帳戶條件。價格可能調整，實際費用請以官方定價頁與帳戶用量頁為準。

語音轉錄

語音轉錄模型費用參考
服務商	模型	參考費用	計費單位
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 語音轉錄費用，查看 Groq 語音轉錄文件。

文字整理

文字整理模型費用參考
服務商	模型	輸入價格	輸出價格	計費單位
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
Google Gemini	`gemini-3.5-flash-lite`	US$0.30	US$2.50	每 1M tokens
Anthropic	Claude Haiku 4.5 `claude-haiku-4-5-20251001`	US$1.00	US$5.00	每 1M tokens

文字整理實際費用會依模型、輸入文字、提示詞與輸出文字長度計算。查看 OpenAI 文字模型定價，查看 Gemini API 定價，查看 Anthropic 官方定價。Claude 列出一般 API 費率，不含快取或批次折扣。

提醒：買斷價格只包含聲筆 Wa-Gong App 本身，不包含 OpenAI、Google Gemini、Anthropic 或 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 模型；也可以關閉文字整理 API，直接使用轉錄結果。

選用 Gemini 文字整理

開啟 Google AI Studio API Keys。
登入 Google 帳戶，建立新的 Gemini API Key，建立後立即複製。
回到聲筆 Wa-Gong，進入「設定」→「API 管理」，在 Gemini 欄位貼上並儲存。
前往「處理模式」，開啟「使用文字整理 API」，選擇 Gemini 與 gemini-3.5-flash-lite。

聲筆使用 Gemini 的串流文字產生 API。gemini-3.5-flash-lite 是預設模型，也可在 App 內選擇 gemini-3.1-flash-lite。Gemini API 的 Key、模型清單與計費由 Google 管理，請以 Google AI Studio 與官方定價頁顯示內容為準。

選用 Claude 文字整理

需使用已提供 Claude 選項的 App 版本。若「文字服務商」沒有「建立 Claude 設定」，請等待支援版本更新。

開啟 Claude Console，登入並建立 Anthropic API Key，依帳戶要求設定付款與支出限制。
回到聲筆 Wa-Gong，進入「設定 → API 金鑰 → Claude」，輸入金鑰，通過驗證後儲存。
進入「設定 → 文字服務商」，點選「建立 Claude 設定」。已建立時直接使用既有設定，不必重填金鑰。
進入「文字處理模式」，編輯要使用的模式，啟用文字整理 API，選擇 Claude 與 Claude Haiku 4.5，再儲存。

Claude 只負責文字整理，語音轉錄仍須另設服務商。既有模式不會自動切換。可先用「試跑目前設定」檢查結果，試跑不扣 App 的體驗字數，但 Anthropic 仍會依 API 使用量計費。

選用 Groq 語音轉錄

開啟 Groq API Keys。
登入或建立 GroqCloud 帳號，必要時先選擇或建立 Project。
建立新的 API Key，建立後立即複製。
回到聲筆 Wa-Gong，進入「設定」→「API 管理」，在 Groq 欄位貼上並儲存。
在「語音轉錄設定」選擇 Groq，再選擇 whisper-large-v3-turbo 或其他可用模型。

Groq 在聲筆中只用於語音轉錄。文字整理可另外選擇 OpenAI、Gemini 或 Claude，或關閉文字整理 API 以直接使用轉錄結果。Groq 的 API Key、模型清單與計費由 Groq 管理，請以 Groq Console 顯示內容為準。

回到 App 後怎麼設定

聲筆設定畫面中的 API 管理、語音服務商、模型與 API Key 狀態 — 在「設定」中管理 API Key，再選擇語音服務商與模型。

打開聲筆 Wa-Gong 主 App。
進入「API 管理」，貼上對應服務商的 API Key。
留在「設定」分頁，在「語音轉錄設定」選擇服務商與模型。
在「處理模式」確認文字服務商、模型與整理方式；若希望停止後更快插入，可關閉「使用文字整理 API」。
先念一段不含機密資料的短句測試。

API Key 設定完成後：接著新增聲筆鍵盤、開啟「允許完整取用」，並在第一次準備錄音時允許麥克風。請查看完整的第一次使用步驟。

如何更換或清除 Key

回到「設定」→「API 管理」，選擇服務商後輸入新 Key 並儲存。要停止使用某個服務商，可以清除該欄位。

API 金鑰以 iOS Keychain 加密保存在你的裝置上，僅限本機、不隨 iCloud 同步。所有請求由你的裝置直接送往你選擇的服務商，不經過任何我方伺服器，我們無法看到你的金鑰或語音內容。語音資料的後續處理與保存，依你所選服務商的隱私政策而定。

官方連結

如果 API Key 遺失、費用異常或帳戶被鎖定，請直接聯絡對應 API 服務商。聲筆 Wa-Gong 無法查看或恢復你的 API Key。