常见问题解答和问题排查

iOS+ Android Web Flutter

本页提供了有关 Gemini API 和 Vertex AI in Firebase SDK 的常见问题解答 (FAQ)。如有其他问题，请参阅 Google Cloud 文档中的 Gemini API 常见问题解答。

必须启用哪些 API 才能使用 Vertex AI in Firebase SDK？如何启用这些功能？

如需使用 Vertex AI in Firebase SDK，您的项目必须启用以下两个 API：

• Vertex AI API (aiplatform.googleapis.com)
• Vertex AI in Firebase API (firebasevertexai.googleapis.com)

您只需在 Firebase 控制台中点击几下，即可启用以下 API：

1. 前往使用 Gemini 构建页面。

2. 点击 Vertex AI in Firebase 卡片以启动启用这两个 API 的工作流。此工作流还会将 Vertex AI in Firebase API 添加到您的 Firebase API 密钥的许可名单。

或者，您也可以使用 Google Cloud 控制台（需要手动完成更多步骤）：

1. 点击此常见问题解答条目顶部的每个 API 链接，然后点击每个 API 页面中的启用。

2. 按照 Google Cloud 文档中添加 API 限制中的说明，将 Vertex AI in Firebase API 添加到您的 Firebase API 密钥的许可名单。

注意：Vertex AI in Firebase 的预览版需要 Firebase ML API (firebaseml.googleapis.com)，但现在 Vertex AI in Firebase 已正式发布 (GA)，因此不再需要该 API。

使用 Vertex AI in Firebase SDK 需要哪些权限？

操作	必需的 IAM 权限	默认包含所需权限的 IAM 角色
将结算升级为随用随付 (Blaze) 定价方案	firebase.billingPlans.update resourcemanager.projects.createBillingAssignment resourcemanager.projects.deleteBillingAssignment	Owner
在项目中启用 API	serviceusage.services.enable	编辑者 所有者
创建 Firebase 应用	firebase.clients.create	Firebase Admin Editor Owner

哪些模型可与 Vertex AI in Firebase SDK 搭配使用？

您可以将 Vertex AI in Firebase SDK 与了解 Gemini 模型中列出的任何 Gemini 基础模型搭配使用。

您无法通过 Vertex AI in Firebase SDK 使用非基础 Gemini 模型，例如 PaLM 模型、经调整的模型或基于 Gemma 的模型。

我们经常为 SDK 添加新功能，因此请密切关注此常见问题解答，了解最新动态（以及版本说明、博客和社交帖子）。

如何修复 400 错误 Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.？

如果您尝试使用 Cloud Storage for Firebase 网址发送多模态请求，则可能会遇到以下 400 错误：
Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.

此错误是由某个项目在启用 Vertex AI API 时未正确自动预配所需服务代理引起的。这是某些项目的已知问题，我们正在努力解决这一问题。

下面介绍了如何修复项目并正确预配这些服务代理，以便您可以开始在多模态请求中包含 Cloud Storage for Firebase 网址。您必须是项目的 Owner，且只需为项目完成这组任务一次。

1. 使用 gcloud CLI 进行访问和身份验证。
   最简单的方法是通过 Cloud Shell 执行此操作。如需了解详情，请参阅 Google Cloud 文档。

2. 如果出现提示，请按照终端中显示的说明针对您的 Firebase 项目运行 gcloud CLI。

   您将需要自己的 Firebase 项目 ID，该 ID 可在 Firebase 控制台的 项目设置顶部找到。

3. 运行以下命令，在项目中预配所需的服务代理：

   curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"  https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/endpoints -d ''
   

4. 请等待几分钟，确保服务代理已预配，然后重新尝试发送包含 Cloud Storage for Firebase 网址的多模态请求。

如果等待几分钟后仍然出现此错误，请与 Firebase 支持团队联系。

就您使用 Vertex AI in Firebase 的体验提供反馈