Gemini Provider

文档首页 · Provider 指南 · 配置 · DeepSeek · OpenAI-compatible · Anthropic · English

当你希望 Sigil 通过 Google streamGenerateContent API 调用 Gemini 模型时，选择 Gemini provider。

最小配置

临时本地使用：

export SIGIL_GEMINI_API_KEY="..."
sigil

可复用配置：

[agent]
provider = "gemini"
model = "gemini-2.5-pro"
tool_timeout_secs = 30

[model_request]
request_timeout_secs = 120
stream_idle_timeout_secs = 180

[providers.gemini]
base_url = "https://generativelanguage.googleapis.com/v1beta"
# 优先使用 SIGIL_GEMINI_API_KEY。
# api_key = "..."

完整起点模板见 gemini.toml。

认证

Sigil 按这个顺序解析 Gemini 认证：

1. SIGIL_GEMINI_API_KEY
2. [providers.gemini].api_key

如果希望 Sigil 使用专属凭据，同时不影响同一个 shell 里的其他 Google 工具，优先使用 SIGIL_GEMINI_API_KEY。

环境变量覆盖

行为说明

Sigil 会为你处理 Gemini 的请求格式、function calling、response、usage 与安全阻断。Gemini 专属选项留在本文；正常的 tool approval、隐私与 session 工作流保持一致。

只有明确识别的 Gemini model id 才能使用图片附件。浮动 latest 名称、未知 id 和未识别 alias 会在 provider transport 前失败。输入方式、本地上限、cache 行为与 resume 建议见图片附件。

Gemini model 名称和 endpoint 可用性可能随账号和区域变化。自动化使用时，请显式配置 [agent].model。

验证

运行：

sigil doctor

检查 provider 名称、model、base URL、timeout 和 API key 来源。

常见问题