BYOKGemini API 密钥操作指南阅读约 5 分钟
如何将 Google Gemini API 密钥连接到 QKeyboard
了解如何从 Google AI Studio 获取免费的 Gemini API 密钥，并通过 QKeyboard 的 BYOK 功能连接自己的 Google 账户来改写文字。
QKeyboard·
Google Gemini 是比较容易上手的 BYOK 选项之一，主要是因为 Google AI Studio 提供免费的 API 使用额度。如果你想先试着把自己的密钥连接到 QKeyboard，再决定是否使用付费服务商，它会是一个不错的起点。
第 1 步：从 Google AI Studio 获取密钥
- 前往 Google AI Studio，并使用 Google 账户登录。
- 打开 API 密钥部分。
- 创建新的 API 密钥，可以选择新项目或现有项目。
- 生成密钥后复制它。
与一些其他服务商不同，Google AI Studio 通常允许你在添加付款方式之前生成可用的密钥，因为免费额度内的使用不要求先启用结算。
为什么免费额度对 BYOK 很重要
有些用户选择 Gemini 的一个重要原因是，轻量、日常的改写通常可以留在 Google 的免费使用额度内。这样一来，只要使用量没有超过免费额度的限制，你就能获得 BYOK 的好处——自己的密钥、自己的账户，以及直接发往服务商的请求——而不一定需要额外付费。使用量较大时，最终仍需要启用结算，因此如果你经常写作，最好查看 Google 当前的免费额度条款。
第 2 步：在 QKeyboard 中连接密钥
- 从 App 或键盘菜单打开 QKeyboard 的设置。
- 前往 AI 服务商 / BYOK 部分。
- 从服务商列表中选择 Google Gemini。
- 粘贴从 AI Studio 复制的 API 密钥。
- 选择一个模型。
- 保存。
和任何 BYOK 服务商一样，密钥会存储在设备的 Apple 钥匙串中，而不是 QKeyboard 的服务器上；它只会用于将你的改写请求直接发送给 Google。
使用 BYOK 时的每日限制
QKeyboard 内置 AI 在免费方案中每天最多改写 20 次。连接 Gemini 密钥后，免费方案的每日额度会提高到 100 次。QKeyboard Pro 会完全移除每日上限，无论是否使用 BYOK。
即使使用免费额度，使用量也受 Google 自己的限制和条款约束，与 QKeyboard 能控制的内容分开。
常见问题
- 如果请求失败，请确认密钥是为正确的 Google Cloud 项目生成的，并且该项目已启用 Gemini API。
- 如果达到免费额度上限，可以等待额度重置，或为 Google 账户添加结算信息以继续使用。
- 你可以随时从同一个设置页面切回 QKeyboard 的内置 AI。