使用 API Key 访问 Google Gemini 服务，支持多账号负载均衡和模型排除。
Gemini API Key Provider 允许你：
credential_pool:
gemini_api_keys:
- id: "gemini-key-1"
api_key: "AIzaSy..."
disabled: false
credential_pool:
gemini_api_keys:
- id: "gemini-key-1"
api_key: "AIzaSy...01"
base_url: "https://generativelanguage.googleapis.com"
proxy_url: "socks5://proxy1:1080"
excluded_models:
- "gemini-2.5-pro"
- "gemini-2.5-*"
- "*-preview"
disabled: false
- id: "gemini-key-2"
api_key: "AIzaSy...02"
disabled: false
| 配置项 | 类型 | 必填 | 说明 |
|---|---|---|---|
| id | string | ✅ | 凭证唯一标识 |
| api_key | string | ✅ | Gemini API Key |
| base_url | string | ❌ | 自定义 Base URL |
| proxy_url | string | ❌ | 单独的代理 URL |
| excluded_models | array | ❌ | 排除的模型列表 |
| disabled | boolean | ❌ | 是否禁用此凭证 |
支持以下匹配模式：
| 模式 | 说明 | 示例 |
|---|---|---|
| 精确匹配 | 完全匹配模型名称 | gemini-2.5-pro |
| 前缀匹配 | 以指定前缀开头 | gemini-2.5-* |
| 后缀匹配 | 以指定后缀结尾 | *-preview |
| 包含匹配 | 包含指定字符串 | *flash* |
excluded_models:
- "gemini-2.5-pro" # 精确匹配
- "gemini-2.5-*" # 匹配 gemini-2.5-flash, gemini-2.5-pro 等
- "*-preview" # 匹配所有预览版模型
- "*flash*" # 匹配所有包含 flash 的模型
credential_pool:
gemini_api_keys:
# Key 1: 用于所有模型
- id: "gemini-all"
api_key: "AIzaSy...01"
# Key 2: 排除 Pro 模型
- id: "gemini-flash-only"
api_key: "AIzaSy...02"
excluded_models:
- "gemini-*-pro*"
# Key 3: 仅用于预览模型
- id: "gemini-preview"
api_key: "AIzaSy...03"
excluded_models:
- "gemini-2.5-pro"
- "gemini-2.5-flash"
credential_pool:
gemini_api_keys:
- id: "gemini-proxy"
api_key: "AIzaSy..."
base_url: "https://my-proxy.example.com/gemini"
curl http://127.0.0.1:8999/v1/chat/completions \
-H "Authorization: Bearer your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-2.5-flash",
"messages": [{"role": "user", "content": "Hello!"}]
}'
将 Gemini 模型路由到 Gemini API Key Provider：
routing:
rules:
- pattern: "gemini-*"
provider: "gemini_api_key"
priority: 1
AIzaSy 开头）