Gemini 接入
这篇解决什么
Gemini 平台字符串怎么填、默认打哪个 Google AI Studio 兼容地址。读完能对上 AiPlatformEnum.GEMINI = "Gemini",以及对话选项复用 OpenAiChatOptions。
默认端口 48080。开启见 AI 功能设计。
示意图:包装类复用 OpenAI 客户端。工厂不读密钥 url,主机写死在类常量。
从哪改
| 名称 | 说明 | 仓库路径 |
|---|---|---|
| 密钥 | @RequestMapping("/ai/api-key") | ruoyi-office/yudao-module-ai/.../controller/admin/model/AiApiKeyController.java |
| 工厂 | buildGeminiChatModel(apiKey) | AiModelFactoryImpl |
| 包装 | BASE_URL / COMPLETE_PATH | GeminiChatModel |
| 选项 | OpenAiChatOptions | AiUtils.buildChatOptions |
| YAML | yudao.ai.gemini | ruoyi-office/yudao-server/src/main/resources/application.yaml |
官方菜单:密钥 2761,模型 2767。
默认地址 https://generativelanguage.googleapis.com/v1beta/openai/,补全路径 /chat/completions。类里默认模型名 gemini-2.5-flash,以 Google AI Studio 当前可点名为准。
工厂会取出 YAML 里的 YudaoAiProperties.Gemini,再把库表 apiKey 写进去。YudaoAiProperties.Gemini 没有 baseUrl 字段。
/draw 没有 Gemini 分支。对话用 type=1。
字段
| 名称 | 说明 | 仓库路径 |
|---|---|---|
platform | 必须是 Gemini | AiApiKeyDO / AiModelDO |
apiKey | Google AI Studio 密钥 | AiApiKeyDO |
model | 如 gemini-2.5-flash | AiModelDO |
不是 Google 也不是 Bard
枚举值是 Gemini。密钥 url 当前建客户端用不到。
和 OpenAI 只是选项类复用
platform 必须是 Gemini 才会进 buildGeminiChatModel。填 OpenAI 会打到另一家。YAML 开关是 yudao.ai.gemini.enable。
按本仓库 DO 生成的 ER。
配置与操作
走 API 密钥(2761)建 platform=Gemini。对话选项复用 OpenAiChatOptions,但必须进 buildGeminiChatModel。填 OpenAI 会打到另一家。
YAML yudao.ai.gemini.enable 只控制装配。开启见 AI 功能设计。

本系统截图:AI 大模型 → 控制台 → API 密钥。各厂商共用这一页,用 platform 区分。

本系统截图:控制台 → 模型配置。keyId 必须指向同平台密钥。
