获取 API 密钥

如需使用 Gemini API，您需要 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（及其所有关联的 Google Cloud 项目）。
- 不过，Google Cloud 项目中的任何 API 密钥都可能被来调用 Google AI Gemini API。您可以查看和管理项目的 API 密钥 API 和服务 >“凭据”面板 Google Cloud 控制台中。
正在添加 API 密钥限制有助于限制可通过每个 API 密钥使用的表面积。默认情况下， Google AI Studio 生成的 Gemini API 密钥只能用于 Google AI Gemini API（官方名称为“生成式语言 API”或 generativelanguage.googleapis.com）。
- 如果您的 Google Cloud 项目中有任何缺少 API 的 API 密钥限制或任何将生成式语言代码列入许可名单的 API 密钥 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 在正式版应用中直接调用 Google AI Gemini API，移动应用和 Web 应用。查看 SDK 快速入门以了解详情针对特定语言保护 API 密钥的最佳做法。

如需了解一些常规最佳实践支持文章。

后续步骤

查看 API 快速入门，了解最佳做法保护和使用 API 密钥的方法。