用途:该指南说明如何通过 Gemini 的 OpenAI 兼容端点,将 Gemini 模型接入作为辅助 API 使用,覆盖摘要、纠错、情感分析与视觉等场景。
基础配置:OpenAI 兼容 Base URL 为 https://generativelanguage.googleapis.com/v1beta/openai/。推荐模型方面,Summary / Correction / Vision 使用 gemini-3-flash-preview,Emotion Analysis 使用 gemini-2.5-flash。
控制 Thinking:Gemini 2.5+ 模型需通过 extra_body 控制 thinking 行为。禁用 Thinking 使用 thinking_budget 为 0;低级别 Thinking 使用 thinking_level 为 low 且 include_thoughts 为 False。注意 extra_body 需双层嵌套,外层 extra_body 是传给 OpenAI client 的参数名,内层 google 配置为 Gemini 实际参数;若格式错误可能报 Unknown name 'google' 错误。
响应处理:Gemini 可能返回被 markdown 代码块包装的 JSON,需要先剥离首尾 ``` 行再解析。JSON 解析失败常见原因包括响应被截断(token 限制过小)或包含 markdown 代码块,可通过增加 max_completion_tokens 并添加代码块处理逻辑解决。
配置位置:可在 config/api_providers.json 中把 gemini 加入 assist_api_providers,并在 config/init.py 中添加 EXTRA_BODY_GEMINI 与 MODELS_EXTRA_BODY_MAP;提供有 api_providers.json 示例字段。限制:资料注明该服务国内无法使用,其余价格与速率等信息暂未提供。