聲筆 Wa-Gong App 圖示聲筆 Wa-Gong

支援與常見問題

從第一次設定到錄音完成後的排除方式，都整理在這一頁。

第一次使用

  1. 先建立 OpenAI API Key。完整流程需要 OpenAI；Groq 可另外選用於語音轉錄。詳細方式請看 API Key 教學。
  2. 打開聲筆主 App，進入「設定 → API 管理」，貼上 OpenAI API Key 並儲存。若要使用 Groq，也在這裡貼上 Groq API Key。
  3. 留在「設定」分頁，在「語音轉錄設定」選擇服務商與模型，並在「處理模式」確認要使用的整理方式。
  4. 前往「iPhone 設定 → 一般 → 鍵盤 → 鍵盤 → 新增鍵盤」，選擇「聲筆 Wa-Gong」。
  5. 在鍵盤清單點進「聲筆 Wa-Gong」，開啟「允許完整取用」。
  6. 回到聲筆主 App，第一次準備語音輸入時，依系統提示允許使用麥克風。
  7. 在備忘錄、訊息或其他文字欄位切換到聲筆鍵盤，點擊麥克風並依畫面指示完成第一次語音輸入。

為什麼需要這兩項權限

允許完整取用

iOS 需要使用者主動開啟「允許完整取用」，鍵盤才能與聲筆主 App 共用語音工作階段、處理模式與完成結果。API Key 仍保存在主 App 的 iOS Keychain，不會顯示在鍵盤中。聲筆不使用自有伺服器代送語音或文字內容。

麥克風

iOS 自訂鍵盤不能直接錄音，因此麥克風由聲筆主 App 使用。聲筆會在你第一次準備語音輸入時要求權限，不會在剛開啟 App 時一次要求所有權限。

常見問題

為什麼要手動滑回原本的 App？

iOS 自訂鍵盤不能直接存取麥克風，因此錄音由主 App 執行。系統不保證鍵盤可以自動把你帶回原本的 App，所以目前流程是開啟主 App 準備錄音，再手動滑回原本的 App，回到鍵盤後開始錄音。

錄音完成後沒有插入文字，怎麼辦？
  • 確認錄音結束時仍在原本的文字欄位。
  • 確認鍵盤有開啟「允許完整取用」。
  • 確認主 App 的 API Key、服務商與模型設定有效。
  • 回到主 App 查看錯誤訊息或最近轉錄，必要時使用複製功能手動貼上。
找不到聲筆鍵盤或允許完整取用，怎麼辦？

先前往「iPhone 設定 → 一般 → 鍵盤 → 鍵盤 → 新增鍵盤」，加入「聲筆 Wa-Gong」。加入後回到鍵盤清單，點進「聲筆 Wa-Gong」，就能看到「允許完整取用」開關。

不小心拒絕麥克風權限，怎麼重新開啟？

前往 iPhone「設定」，找到「聲筆 Wa-Gong」，開啟麥克風權限，再回到主 App 重新準備語音輸入。

停止錄音後，多久會出現文字？

停止錄音後，聲筆會依序完成語音轉錄與文字整理。處理時間會受到錄音長度、所選模型、服務商回應速度與網路狀況影響，完成後會自動插入文字欄位。

OpenAI 訂閱可以直接使用嗎？

不行。ChatGPT 訂閱與 OpenAI API 是分開計費的服務。聲筆 Wa-Gong 需要你自行建立 OpenAI API Key，API 費用由 OpenAI 依你的 API 帳戶收取。

完整版與免費體驗怎麼計算？

每個本機安裝提供成功文字整理輸出累計 10,000 字的完整流程體驗。完整版為一次買斷，正式價格 NT$990，首發上架日起 1 個月優惠價 NT$590，優惠結束後恢復 NT$990。語音轉錄與文字整理的 API 費用不包含在買斷價格內。

如何恢復購買？

在 App 的「設定」中找到「完整版」，點擊「恢復購買」。請使用購買時相同的 Apple 帳號。Apple 退款或撤銷交易後，完整版權益會依 Apple 回傳的交易狀態重新判斷。

如何刪除最近轉錄？

在 App 設定中可以選擇最近轉錄保留數量，也可以選擇「不保留」。最近轉錄頁面也提供逐筆刪除與全部清除。API Key 則可從「API 管理」個別清除。

回報問題

請寄信至 [email protected]。如果可以，請附上 App 版本、iPhone 型號、iOS 版本、使用的服務商與錯誤畫面。請不要把 API Key 寄在信件中。

相關頁面：API Key 教學、隱私權政策。