跳到主要内容

Gemini

注意

本教程来自社区贡献，并非 Open WebUI 官方支持内容。它仅作为演示，说明如何按你的具体场景自定义 Open WebUI。欢迎贡献更多内容，可查看 contributing 教程。

Open WebUI 也支持通过 Google AI Studio API（也称 Gemini API）进行图像生成。

初始设置​

  1. 从 Google AI Studio 获取一个 API key——或者从 Google Cloud 获取 API key，并为项目启用 Generative Language API
  2. 大多数情况下，你还需要创建项目、启用 Generative Language API 并配置计费信息，因为图像生成 API 不是免费提供的
注意

如果你使用的是免费 API key，请务必在账户中绑定支付方式。缺少有效支付方式是配置过程中最常见的报错原因之一。

提示

如果你使用的是 Vertex AI，也可以在 Google Cloud 中创建 API key，而不是 service account。只要它具备正确权限，并且项目已启用 Generative Language API，这个 key 同样可正常工作。

配置 Open WebUI​

  1. 在 Open WebUI 中前往 Admin Panel > Settings > Images
  2. 将 Image Generation Engine 设置为 Gemini
  3. 将 API Base URL 设置为 https://generativelanguage.googleapis.com/v1beta
  4. 输入你的 Google AI Studio API key
  5. 输入你想使用的模型名称，可从这些 available models 中选择
  6. 将图像尺寸设为可用的 image sizes 之一

最小配置示例​

创建图像

  • 创建图像模型: gemini-3-pro-image-preview
  • 图像尺寸: 2816x1536
  • 图像提示词生成: 开启
  • 图像生成引擎: Gemini
  • Gemini 基础 URL: https://generativelanguage.googleapis.com/v1beta
  • Gemini API 密钥: 输入你的 API 密钥
  • Gemini 端点方法: generateContent

编辑图像

  • 图像编辑引擎: Gemini
  • 模型: gemini-3-pro-image-preview
  • 图像尺寸: （可留空）
  • Gemini 基础 URL: https://generativelanguage.googleapis.com/v1beta
  • Gemini API 密钥: 输入你的 API 密钥

Open WebUI 图像设置页面截图，已选中 Gemini，并高亮显示 API key、模型和图像尺寸字段。

信息

该功能似乎只适用于支持以下 endpoint 的模型：https://generativelanguage.googleapis.com/v1beta/models/<MODEL_NAME>:predict。
这是 Google 提供的、兼容 OpenAI 的实验性 BETA endpoint。

Google Imagen 模型使用这个 endpoint，而 Gemini 模型则使用另一个以 :generateContent 结尾的 endpoint。

Imagen 模型 endpoint 示例：

  • https://generativelanguage.googleapis.com/v1beta/models/imagen-4.0-generate-001:predict
  • Imagen 模型文档

Gemini 模型 endpoint 示例：

  • https://generativelanguage.googleapis.com/v1beta/models/gemini-3-pro-image-preview:generateContent
  • Gemini 模型文档

如果你尝试调用 gemini-3-pro-image-preview 这类 Gemini 模型，但仍使用图像生成中的 predict endpoint，就会因 endpoint 不匹配而报错：

400: [ERROR: models/gemini-3-pro-image-preview is not found for API version v1beta, or is not supported for predict. Call ListModels to see the list of available models and their supported methods.]

使用 Gemini Endpoints 的 LiteLLM Proxy​

Open WebUI 支持通过使用 Gemini 或 Imagen 端点的 LiteLLM 代理进行图像生成。配置方式如下：

  1. 在 Open WebUI 中前往 Admin Panel > Settings > Images
  2. 将 Image Generation Engine 设置为 Open AI
  3. 将 API endpoint URL 改为 https://<your-litellm-url>:<port>/v1
  4. 输入你的 LiteLLM API 密钥
  5. API version 可留空
  6. 输入你在 LiteLLM 配置中使用的图像模型名称
  7. 将图像尺寸设置为所选模型支持的可用尺寸之一
提示

若要查看 LiteLLM 连接信息，请前往 Admin Panel > Settings > 连接。 你的连接信息会显示在 Gemini API 连接下方。

本内容仅供参考，不构成任何保证、担保或合同承诺。Open WebUI 按“现状”提供。请参阅您的许可协议 以了解适用条款。