如何將 Google Gemini API 金鑰連接到 QKeyboard

Google Gemini 是較容易入門的 BYOK 選項之一，主要是因為 Google AI Studio 提供免費的 API 使用額度。如果你想先試著將自己的金鑰連接到 QKeyboard，再決定是否使用付費服務商，這會是很好的起點。

第 1 步：從 Google AI Studio 取得金鑰

1. 前往 Google AI Studio，使用 Google 帳戶登入。
2. 開啟 API 金鑰區段。
3. 建立新的 API 金鑰，可以在新專案或現有專案中建立。
4. 金鑰產生後將它複製下來。

和部分其他服務商不同，Google AI Studio 通常允許你在一開始不必先加入付款方式就產生可用的金鑰，因為免費額度內的使用不需要啟用計費。

為什麼免費額度對 BYOK 很重要

有些人選擇 Gemini 作為 BYOK 服務商，一個實際原因是日常輕度改寫通常可以留在 Google 的免費使用額度內。這表示你能享有 BYOK 的好處——使用自己的金鑰和帳戶，讓請求直接傳給服務商——只要使用量不超過免費額度，通常不必額外付費。使用量較大時，最後仍可能需要啟用計費，因此如果你經常寫作，值得查看 Google 目前的免費額度條款。

第 2 步：在 QKeyboard 中連接金鑰

1. 從 App 或鍵盤選單開啟 QKeyboard 的設定。
2. 前往 AI 服務商 / BYOK 區段。
3. 從服務商列表中選擇 Google Gemini。
4. 貼上從 AI Studio 複製的 API 金鑰。
5. 選取模型。
6. 儲存。

和其他 BYOK 服務商一樣，金鑰會儲存在裝置的 Apple 鑰匙圈，而不是 QKeyboard 的伺服器上；它只會用來將你的改寫請求直接傳送給 Google。

使用 BYOK 時的每日額度

QKeyboard 內建的 AI 在免費方案中每天限 20 次改寫。連接 Gemini 金鑰後，免費方案的額度會提高到每天 100 次改寫。QKeyboard Pro 會完全移除每日上限，無論是否使用 BYOK 都一樣。

即使使用免費額度，實際使用仍受 Google 自己的限制與條款規範，與 QKeyboard 能控制的項目分開計算。

常見問題

• 如果請求失敗，請確認金鑰是為正確的 Google Cloud 專案建立，並確認該專案已啟用 Gemini API。
• 如果用完免費額度，可以等待額度重設，或在 Google 帳戶中加入帳單資料以繼續使用。
• 你隨時可以從同一個設定畫面切回 QKeyboard 的內建 AI。