跳到主要内容

Gemini

注意

本教程由社区贡献，不受 Open WebUI 团队支持。它仅作为如何针对特定用例自定义 Open WebUI 的演示。想要贡献？请查看贡献教程。

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，而不是服务账号。只要该 API key 被分配了适当的权限，并且项目中启用了 Generative Language API，它就能正常工作。

配置 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. 从这些 可用模型 中输入您希望使用的模型。
  6. 将图像尺寸设置为可用的 图像尺寸 之一。

示例最小化设置​

创建图像

  • Create Image Model: gemini-3-pro-image-preview
  • Image Size: 2816x1536
  • Image Prompt Generation: 开启 (on)
  • Image Generation Engine: Gemini
  • Gemini Base URL: https://generativelanguage.googleapis.com/v1beta
  • Gemini API Key: 输入您的 API Key
  • Gemini Endpoint Method: generateContent

编辑图像

  • Image Edit Engine: Gemini
  • Model: gemini-3-pro-image-preview
  • Image Size: （可以留空）
  • Gemini Base URL: https://generativelanguage.googleapis.com/v1beta
  • Gemini API Key: 输入您的 API Key

在 Gemini 处于选中状态，且 API key、模型和图像尺寸字段均已高亮显示的 Open WebUI 图像设置页面截图。

信息

此功能似乎仅适用于该端点所支持的模型：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-3-pro-image-preview:generateContent。
  • Gemini 模型文档

由于图像生成所支持的端点存在差异，尝试调用 Gemini 模型（例如 gemini-3-pro-image-preview）将导致错误。

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 端点的 LiteLLM 代理​

使用 LiteLLM 代理并通过 Gemini 或 Imagen 端点进行图像生成在 Open WebUI 中也是支持的。请按照以下步骤配置图像生成：

  1. 在 Open WebUI 中，导航至 Admin Panel > Settings > Images 菜单。
  2. 将 Image Generation Engine 字段设置为 Open AI。
  3. 将 API 端点 URL 更改为 https://<your-litellm-url>:<port>/v1。
  4. 输入您的 LiteLLM API key。
  5. API 版本可以留空。
  6. 输入 LiteLLM 配置中显示的图像模型名称。
  7. 将图像尺寸设置为所选模型可用的尺寸之一。
提示

要查找您的 LiteLLM 连接信息，请导航至 Admin Panel > Settings > Connections 菜单。 您的连接信息将列在 Gemini API 连接下方。

This content is for informational purposes only and does not constitute a warranty, guarantee, or contractual commitment. Open WebUI is provided "as is." See your license for applicable terms.