获取 API 密钥

您需要拥有 API 密钥才能使用 Gemini API。您可以在 Google AI Studio 中一键创建密钥。

使用 curl 命令验证您的 API 密钥

您可以使用 curl 命令来验证设置。您可以通过以下任一网址传递 API 密钥：

API_KEY="YOUR_API_KEY"
curl -H 'Content-Type: application/json' \
     -d '{"contents":[
            {"role": "user",
              "parts":[{"text": "Give me five subcategories of jazz?"}]}]}' \
     "https://generativelanguage.googleapis.com/v1/models/gemini-pro:generateContent?key=${API_KEY}"

或者在 x-goog-api-key 标头中：

API_KEY="YOUR_API_KEY"
curl -H 'Content-Type: application/json' \
     -H "x-goog-api-key: ${API_KEY}" \
     -d '{"contents":[
            {"role": "user",
              "parts":[{"text": "Give me five subcategories of jazz?"}]}]}' \
     "https://generativelanguage.googleapis.com/v1/models/gemini-pro:generateContent"

保障 API 密钥的安全

确保您的 Gemini API 密钥安全无虞非常重要。在使用 Gemini API 密钥时，请谨记以下几点：

Google AI Gemini API 使用 API 密钥进行授权。如果其他人可以访问您的 Gemini API 密钥，他们就可以使用您的项目配额进行调用，这可能会导致配额丢失或额外费用（如果启用了结算功能）。API 密钥还可保护对调整后的模型和文件的访问。
当您在 Google AI Studio 中点击获取 API 密钥时，您可以选择是在新的或现有的 Google Cloud 项目中配置 Gemini API 密钥。Google AI Studio 中的 API 密钥列表显示了 AI Studio 已配置用于 Google AI Gemini API 的所有 API 密钥（及其所有关联的 Google Cloud 项目）。
- 不过，Google Cloud 项目中的任何 API 密钥都有可能用于调用 Google AI Gemini API。您可以在 Google Cloud 控制台中的“API 和服务”>“凭据”面板中查看和管理项目的所有 API 密钥。
添加 API 密钥限制有助于限制可通过每个 API 密钥使用的界面区域。默认情况下，Google AI Studio 生成的 Genmini API 密钥只能与 Google AI Genmini API（正式称为“Generative Language API”或 generativelanguage.googleapis.com）搭配使用。
- 如果您的 Google Cloud 项目中有任何 API 限制缺少 API 限制，或任何 API 密钥已将 Generative Language API 列入许可名单，则这些密钥可以与 Google AI Gemini API 搭配使用。最佳做法是，仅限每个 API 密钥使用您使用该密钥调用的 API。
- 请注意，即使设置了 API 密钥限制，如果恶意操作者获取了您的 API 密钥，他们也可以使用该 API 密钥，使用您的项目针对该 API 密钥列入许可名单的所有 API 的配额进行调用。
您有责任确保您的 Gemini API 密钥安全无虞。
- 请勿将 Gemini API 密钥签入源代码控制系统。
- 客户端应用（Android、Swift、Web 和 Dart/Flutter）存在泄露 API 密钥的风险，因此我们不建议在正式版应用中使用 Google AI 客户端 SDK 直接从移动应用和 Web 应用调用 Google AI Gemini API。请参阅 SDK 快速入门，了解针对特定语言保护 API 密钥的最佳做法。

如需了解一些常规的最佳做法，您还可以查看这篇支持文章。

后续步骤

请参阅 API 快速入门，了解保护 API 密钥的安全和使用 API 密钥的最佳实践。