Gemini API

本页说明 WebberAI 与 Gemini 协议工具的接入原则。具体可用入口以 WebberAI API Keys 页面生成的配置为准。

适用场景

• Gemini CLI
• 支持 Gemini API 的编辑器插件
• 需要 Gemini 兼容协议的自定义工具

配置原则

1. 在 WebberAI 创建 API Key。
2. 打开该密钥的“使用密钥 / Use Key”弹窗。
3. 如果弹窗提供 Gemini 配置，复制其中的 Base URL、API Key 和模型配置。
4. 如果没有 Gemini 配置，说明当前密钥或平台未开放该协议，优先改用 OpenAI 兼容 API。

Gemini CLI

Gemini CLI 的配置方式会随版本变化。通用原则是把 WebberAI 生成的 Gemini API Key 和 Base URL 写入 CLI 支持的配置项或环境变量。

示例形式：

export GEMINI_API_KEY="YOUR_WEBBERAI_API_KEY"
export GOOGLE_GEMINI_BASE_URL="以 WebberAI 密钥页生成的地址为准"

如果 CLI 不支持自定义 Base URL，则无法直接使用 WebberAI 的 Gemini 兼容入口，建议改用支持 OpenAI Compatible 的工具。

多模态

Gemini 协议常用于图像理解和多模态输入。是否可用取决于模型广场中的模型能力和当前密钥平台。

使用前请确认：

• 模型是否支持图片输入。
• 客户端是否按 Gemini 协议上传图片。
• 当前密钥页是否提供 Gemini 兼容配置。

排查

• 401：API Key 错误或环境变量未生效。
• 404：Base URL 或 Gemini 版本路径不匹配。
• 模型不可用：模型不支持 Gemini 协议或已临时下架。
• 图片失败：模型或客户端不支持当前图片输入格式。