Skip to main content

Gemini

warning

此教程为社区贡献，不属于 Open WebUI 官方支持。它仅作为如何针对特定用例自定义 Open WebUI 的演示。想要贡献？请查看贡献教程。

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

初始设置​

  1. 从 Google AI Studio 获取 API 密钥。
  2. 您可能需要创建一个项目并启用 Generative Language API，此外还需要添加账单信息。
warning

如果您使用的是免费 API 密钥，请务必记录一种付款方式。缺少有效的付款方式是设置过程中出错的常见原因。

tip

另外，如果您使用的是 Vertex AI，您可以在 Google Cloud 中创建 API 密钥，而不是使用服务账号。只要分配了适当的权限，该密钥就可以正常工作。

配置 Open WebUI​

  1. 在 Open WebUI 中，导航至 管理面板 > 设置 > 图像 菜单。
  2. 将 图像生成引擎 字段设置为 Gemini。
  3. 将 API 基础 URL 设置为 https://generativelanguage.googleapis.com/v1beta。
  4. 输入您的 Google AI Studio API 密钥。
  5. 从这些 可用模型 中输入您希望使用的模型。
  6. 将图像尺寸设置为可用的 图像尺寸 之一。

最小化设置示例​

一个适用于 Gemini 的最小化工作设置如下所示：

创建图像​

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

编辑图像​

  • 图像编辑引擎: Gemini
  • 模型: gemini-2.5-flash-image
  • 图像尺寸: (可留空)
  • Gemini 基础 URL: https://generativelanguage.googleapis.com/v1beta
  • Gemini API 密钥: 输入您的 API 密钥

Open WebUI 图像设置页面截图，已选择 Gemini 并突出显示了 API 密钥、模型和图像尺寸字段。

info

此功能似乎仅适用于支持此端点的模型：https://generativelanguage.googleapis.com/v1beta/models/<MODEL_NAME>:predict。 这是 OpenAI BETA 端点，Google 为实验性 OpenAI 兼容性提供。

Google Imagen 模型使用此端点，而 Gemini 模型使用以 :generateContent 结尾的不同端点。

Imagen 模型端点示例：

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

Gemini 模型端点示例：

  • https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash-image:generateContent
  • Gemini 模型文档

尝试调用 Gemini 模型（如 gemini-2.5-flash-image，又名 Nano Banana）会由于图像生成的支持端点差异而导致错误。

400: [ERROR: models/gemini-2.5-flash-image 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 端点的 LiteLLM 代理​

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

  1. 在 Open WebUI 中，导航至 管理面板 > 设置 > 图像 菜单。
  2. 将 图像生成引擎 字段设置为 Open AI。
  3. 将 API 端点 URL 更改为 https://<您的-litellm-url>:<端口>/v1。
  4. 输入您的 LiteLLM API 密钥。
  5. API 版本可以留空。
  6. 输入您的 LiteLLM 配置中显示的图像模型名称。
  7. 将图像尺寸设置为所选模型的可用尺寸之一。
tip

要查找您的 LiteLLM 连接信息，请导航至 管理面板 > 设置 > 外部链接 菜单。 您的连接信息将列在 Gemini API 连接下。