# 项目与账号验证

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

付费层项目不需要项目验证。你可以 [设置帐单](/docs/billing#setup-billing) 随时使用付费套餐。

{% button href="https://aistudio.google.com/projects" variant="ais" %}在 AI Studio 中打开项目{% /button %}

## 验证要求  {% #when-required %}

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

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

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

```none
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.
```

## 验证免费套餐项目  {% #verify-project %}

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

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

{% callout type="note" %}
在同一未经验证的项目中创建新的 API 密钥不会绕过验证。 Google 在 Google Cloud 项目级别应用验证。
{% /callout %}

## 无需验证即可使用付费套餐  {% #use-paid-tier %}

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

1. 点击 **设置结算** 在验证页面或对话框上，或在项目旁边 [项目](https://aistudio.google.com/projects) 或 [API 密钥](https://aistudio.google.com/api-keys).
1. 为您的项目选择或创建一个有效的 Cloud Billing 帐号并添加 [预付积分](/docs/billing#prepay) 如果出现提示。

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

## 验证您的帐户  {% #verify-account %}

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

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

如果您不想验证您的帐户， [设置帐单](/docs/billing#setup-billing) 并在 Google AI Studio 中使用付费层 API 密钥。

## 设备要求  {% #device-requirements %}

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

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

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

## 解决验证问题  {% #troubleshoot %}

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

| 错误信息                                                    | 原因                                                                 | 分辨率                                                                                                                                                             |
| ------------------------------------------------------- | ------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `We couldn't verify this project with your device`      | 您的手机已达到跨项目的验证限制或未通过设备安全检查。                                         | 尝试另一部符合条件的手机，稍后重试，或者 [设置帐单](/docs/billing#setup-billing) 使用付费套餐。在 iPhone 上，允许应用程序剪辑 **设置 > 屏幕时间 > 内容和隐私限制 > 内容限制 > 应用剪辑**.                                      |
| `We couldn't verify your account with this device`      | 您的手机已达到最近的验证限制或未通过设备安全检查。                                          | 尝试另一部符合条件的手机，稍后重试，或者 [设置帐单](/docs/billing#setup-billing) 并使用付费层 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权限](/docs/troubleshoot-ai-studio#iam-permissions)). |
| `Project not found`                                     | 项目编号无效、项目处于非活动状态或您的 Google 帐户缺少 `resourcemanager.projects.get` 访问。 | 登录具有项目访问权限的 Google 帐户，或在 [项目](https://aistudio.google.com/projects).                                                                                            |

## 限制  {% #limitations %}

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

## 后续步骤  {% #whats-next %}

* [使用 Gemini API 密钥](/docs/api-key)：为您已验证的项目创建和管理 API 密钥。
* [结算](/docs/billing)：将项目升级到付费级别并管理预付积分。
* [问题排查指南](/docs/troubleshooting): 诊断其他 `403` 和 API 错误。
