跳到主要内容

Gemini API 配置指南

概述​

Gemini API 是由 Google 推出的 AI 接口，通过 Google AI Studio 提供。相比 Google Cloud 的 Vertex AI，AI Studio 提供了更简单的 API Key 认证方式，非常适合快速开发和个人集成。

Gemini 提供多个模型系列，适用于不同性能与成本场景：

模型特点适用场景
gemini-2.0-flash速度快、成本低高并发、日常对话
gemini-1.5-pro高质量多模态复杂任务、长文本理解
gemini-1.5-flash平衡性能与成本通用场景

获取 API Key​

步骤 1：访问 Google AI Studio​

前往 Google AI Studio 并使用你的 Google 账号登录。

步骤 2：生成 API Key​

  1. 在左侧导航栏点击 "Get API key"
  2. 点击 "Create API key in new project"（或选择现有 Google Cloud 项目）
  3. 复制并保存 生成的 API Key

⚠️ 注意：API Key 请妥善保管，不要泄露在公开代码库中。

Gemini API Key

Gemini API Key

配置 PicoClaw​

方式一：使用 WebUI（推荐）​

PicoClaw 提供了 WebUI 界面，您可以在 WebUI 中轻松配置模型，无需手动编辑配置文件。

编辑预设设置，或在右上角点击 "添加模型" 按钮进行配置：

添加模型

字段填写内容
模型别名自定义名称，如 gemini-flash
模型标识符google/gemini-2.0-flash（或其他支持的模型）
API KeyGoogle AI Studio API Key
API Base URL留空（使用默认地址）

方式二：编辑配置文件​

在 config.json 中添加 Gemini 模型，将 auth_method 设置为 api_key：

{
  "model_list": [
    {
      "model_name": "gemini-flash",
      "model": "google/gemini-2.0-flash",
      "auth_method": "api_key",
      "api_key": "YOUR_GEMINI_API_KEY_HERE"
    },
    {
      "model_name": "gemini-pro",
      "model": "google/gemini-1.5-pro",
      "auth_method": "api_key",
      "api_key": "YOUR_GEMINI_API_KEY_HERE"
    }
  ],
  "agents": {
    "defaults": {
      "model": "gemini-flash"
    }
  }
}

限制与配额​

免费层级​

Google AI Studio 为开发者提供免费层级：

  • 免费额度：每日有免费请求配额
  • 速率限制：免费层级有每分钟请求数（RPM）限制
  • 数据隐私：免费层级下，Google 可能会使用输入/输出数据改进模型

付费层级​

如需更高配额或企业级隐私保护，可升级至付费层级或使用 Google Cloud Vertex AI。

常见问题​

API Key 无效​

原因：API Key 过期或被撤销

解决：前往 Google AI Studio 重新生成 API Key

请求超时​

原因：网络问题或请求过于频繁

解决：

  • 检查网络连接
  • 降低请求频率
  • 使用代理（如需要）

模型不可用​

原因：部分模型在特定地区不可用

解决：

  • 检查模型是否在您的地区支持
  • 尝试使用其他 Gemini 模型