Gemini 中文指南
获取 API 密钥 ↗

项目与账号验证

↓ 下载 MarkdownInteractions API

Google AI Studio 和 Gemini API 需要对某些免费层项目和帐户进行移动设备验证。此检查有助于防止自动滥用并为开发人员保留免费套餐。您可以使用手机扫描二维码,而无需共享电话号码或安装应用程序。

付费层项目不需要项目验证。你可以 设置帐单 随时使用付费套餐。

在 AI Studio 中打开项目

验证要求 #

在两种情况下您可能需要完成移动设备验证:

  • 项目验证:对于其他项目或在 Google AI Studio 外部创建的项目的免费套餐是必需的。未经验证的项目显示 需要验证 在 项目 并返回 403 (FREE_TIER_VERIFICATION_REQUIRED).
  • 账户验证:如果 Google AI Studio 检测到您的 Google 帐户存在异常活动,则需要。 Google AI Studio 显示一条“帐户验证需要恢复访问”消息,其中包含 验证您的帐户 链接。

当免费层项目需要验证时,API 会返回一条错误消息,其中包含项目的验证链接:

代码
Project 123456789012 must be verified before it can use the Gemini API Free tier. Verify the project at https://aistudio.google.com/verify?project=123456789012, or set up billing at https://aistudio.google.com/billing to use the paid tier instead. Learn more at https://ai.google.dev/gemini-api/docs/verification.

验证免费套餐项目 #

您需要拥有编辑 Google Cloud 项目的权限才能验证它。确保您的帐户有 业主 或 编辑 IAM 在项目中的角色。

  1. 打开错误消息中的验证链接(https://aistudio.google.com/verify?project=PROJECT_NUMBER),或点击 验证项目 于 项目 页。
  2. 点击 验证设备.
  3. 使用 Android 手机或 iPhone 相机扫描二维码,然后按照手机上的提示操作。
  4. 等待“项目已验证”确认,然后重试您的 API 请求或单击 获取API 密钥.

无需验证即可使用付费套餐 #

如果您不想使用移动设备进行验证,请将您的项目升级到付费级别:

  1. 点击 设置结算 在验证页面或对话框上,或在项目旁边 项目 或 API 密钥.
  2. 为您的项目选择或创建一个有效的 Cloud Billing 帐号并添加 预付积分 如果出现提示。

Google 按付费等级使用计费 Gemini API 定价 或从合格学分中扣除。 Google Cloud 免费试用帐户将保留在免费套餐中,直到您升级为止。预付款账户还需要有正的贷方余额。

验证您的帐户 #

如果 Google AI Studio 由于异常活动而提示您验证您的 Google 帐户:

  1. 打开 aistudio.google.com/verify-account 登录受影响的 Google 帐户时。
  2. 点击 验证设备 并使用 Android 手机或 iPhone 相机扫描二维码。
  3. 按照手机上的提示操作,然后单击 前往AI工作室 一旦验证成功。

如果您不想验证您的帐户, 设置帐单 并在 Google AI Studio 中使用付费层 API 密钥。

设备要求 #

移动设备验证使用 Google reCAPTCHA 检查物理手机上的设备完整性:

  • 安卓:具有 Google Play 服务和互联网连接的 Android 手机。已 root 的手机或具有解锁引导加载程序的手机无法通过。
  • 苹果手机:运行 iOS 16.4 或更高版本的 iPhone,并且已连接互联网并打开 App Clips。扫描二维码即可打开轻量级 App Clip,无需安装应用程序。

台式机、模拟器、虚拟设备无法完成验证。

解决验证问题 #

使用下表来解析 Google AI Studio 中的常见验证消息。

错误信息原因分辨率
We couldn't verify this project with your device您的手机已达到跨项目的验证限制或未通过设备安全检查。尝试另一部符合条件的手机,稍后重试,或者 设置帐单 使用付费套餐。在 iPhone 上,允许应用程序剪辑 设置 > 屏幕时间 > 内容和隐私限制 > 内容限制 > 应用剪辑.
We couldn't verify your account with this device您的手机已达到最近的验证限制或未通过设备安全检查。尝试另一部符合条件的手机,稍后重试,或者 设置帐单 并使用付费层 API 密钥。在 iPhone 上,允许应用程序剪辑 设置 > 屏幕时间 > 内容和隐私限制 > 内容限制 > 应用剪辑.
Something went wrong while verifying your device网络规则或浏览器扩展阻止了 Google reCAPTCHA 脚本。允许 google.com 和 gstatic.com 在 aistudio.google.com、关闭广告拦截器,或在私人窗口中重试。
You need permission to edit this project to verify it您的 Google 帐户可以查看该项目,但缺少 resourcemanager.projects.update 许可。询问项目 业主 或 编辑 来验证它。自定义角色需要 resourcemanager.projects.get 和 resourcemanager.projects.update (见 IAM权限).
Project not found项目编号无效、项目处于非活动状态或您的 Google 帐户缺少 resourcemanager.projects.get 访问。登录具有项目访问权限的 Google 帐户,或在 项目.

限制 #

  • 每个移动设备可以在滚动期内验证有限数量的项目或帐户。
  • 验证需要支持的 Android 手机或 iPhone,不支持短信、语音通话或硬件安全密钥。

后续步骤 #

搜索标题、API 名称或正文内容