# Gemini API

本页说明 WebberAI 与 Gemini 协议工具的接入原则。具体可用入口以 WebberAI [API Keys](https://webberai.top/keys) 页面生成的配置为准。

## 适用场景

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

## 配置原则

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

## Gemini CLI

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

示例形式：

```bash
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 协议或已临时下架。
- 图片失败：模型或客户端不支持当前图片输入格式。