项目与账号验证
↓ 下载 MarkdownInteractions API
Google AI Studio 和 Gemini API 需要对某些免费层项目和帐户进行移动设备验证。此检查有助于防止自动滥用并为开发人员保留免费套餐。您可以使用手机扫描二维码,而无需共享电话号码或安装应用程序。
付费层项目不需要项目验证。你可以 设置帐单 随时使用付费套餐。
验证要求 #
在两种情况下您可能需要完成移动设备验证:
- 项目验证:对于其他项目或在 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 在项目中的角色。
- 打开错误消息中的验证链接(
https://aistudio.google.com/verify?project=PROJECT_NUMBER),或点击 验证项目 于 项目 页。 - 点击 验证设备.
- 使用 Android 手机或 iPhone 相机扫描二维码,然后按照手机上的提示操作。
- 等待“项目已验证”确认,然后重试您的 API 请求或单击 获取API 密钥.
无需验证即可使用付费套餐 #
如果您不想使用移动设备进行验证,请将您的项目升级到付费级别:
Google 按付费等级使用计费 Gemini API 定价 或从合格学分中扣除。 Google Cloud 免费试用帐户将保留在免费套餐中,直到您升级为止。预付款账户还需要有正的贷方余额。
验证您的帐户 #
如果 Google AI Studio 由于异常活动而提示您验证您的 Google 帐户:
- 打开 aistudio.google.com/verify-account 登录受影响的 Google 帐户时。
- 点击 验证设备 并使用 Android 手机或 iPhone 相机扫描二维码。
- 按照手机上的提示操作,然后单击 前往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,不支持短信、语音通话或硬件安全密钥。
后续步骤 #
- 使用 Gemini API 密钥:为您已验证的项目创建和管理 API 密钥。
- 结算:将项目升级到付费级别并管理预付积分。
- 问题排查指南: 诊断其他
403和 API 错误。