Google Gemini API 文档
    Google Gemini API 文档
    • 获取 API 密钥
    • API 版本说明
    • 下载内容
    • 在Google Cloud上运行Gemini
    • 模型功能
      • 概览
      • 长上下文
      • 数据化输出
      • 文档理解
      • 图片理解
      • 视频理解
      • 音频理解
      • 文本生成
        • 文字输入
        • 图片输入
        • 流式输出
        • 多轮对话
        • 多轮对话(流式)
        • 配置参数
      • 图片生成
        • 使用 Gemini 生成图片
        • 使用 Gemini 编辑图片
        • 使用 Imagen 3 生成图片
      • Gemini 思考
        • 使用思维模型
        • 为思考模型设置预算
      • 函数调用
        • 使用 Gemini API 进行函数调用
    • 模型
      • 所有模型
      • 价格
      • 速率限制
      • 账单信息
    • 安全
      • 安全设置
      • 安全指导

    获取 API 密钥

    如需使用该 API,您需要拥有 API 密钥。 只需在 Google AI Studio 中点击一下,即可创建密钥。
    获取 API 密钥

    使用 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 密钥限制有助于限制每个 API 密钥可使用的范围。
    您有责任确保 Gemini API 密钥的安全。
    请勿将 Gemini API 密钥签入源代码控制系统。
    客户端应用(Android、Swift、Web 和 Dart/Flutter)可能会泄露 API 密钥。我们不建议在正式版应用中使用 Google AI 客户端 SDK 直接从移动应用和 Web 应用调用 Google AI Gemini API。
    如需了解一些常规最佳实践,您还可以参阅这篇支持文章。
    下一页
    API 版本说明
    Built with