From 299090dc5d422a7d1cd55004bedc34f94afcc3b7 Mon Sep 17 00:00:00 2001 From: silentoplayz Date: Wed, 19 Nov 2025 12:34:30 -0500 Subject: [PATCH 1/2] docs: Enhance Gemini documentation Adds several key clarifications to the Gemini image generation page: - A warning that a payment method is required for paid API keys. - A tip that a Google Cloud API key from Vertex AI can be used as an alternative to a service account. - A minimal working setup example to guide users in their configuration. --- .../image-generation-and-editing/gemini.md | 32 ++++++++++++++++++- 1 file changed, 31 insertions(+), 1 deletion(-) diff --git a/docs/features/image-generation-and-editing/gemini.md b/docs/features/image-generation-and-editing/gemini.md index ae0c5b759..b3443fda2 100644 --- a/docs/features/image-generation-and-editing/gemini.md +++ b/docs/features/image-generation-and-editing/gemini.md @@ -14,6 +14,14 @@ Open WebUI also supports image generation through the **Google AI Studio API** a 1. Obtain an [API key](https://aistudio.google.com/api-keys) from Google AI Studio. 2. You may need to create a project and enable the `Generative Language API` in addition to adding billing information. +:::warning +If you are utilizing a free API key, it is imperative to have a payment method on file. The absence of a valid payment method is a frequent cause of errors during the setup process. +::: + +:::tip +Alternatively, if you are using Vertex AI, you can create an API key in Google Cloud instead of a service account. This key will function correctly, provided it is assigned the appropriate permissions. +::: + ### Configuring Open WebUI 1. In Open WebUI, navigate to the **Admin Panel** > **Settings** > **Images** menu. @@ -23,6 +31,28 @@ Open WebUI also supports image generation through the **Google AI Studio API** a 5. Enter the model you wish to use from these [available models](https://ai.google.dev/gemini-api/docs/imagen#model-versions). 6. Set the image size to one of the available [image sizes](https://ai.google.dev/gemini-api/docs/image-generation#aspect_ratios). +### Example Minimal Setup + +One minimalistic working setup for Gemini can look like this: + +#### Create Image + +- **Create Image Model**: `gemini-2.5-flash-image` +- **Image Size**: `2816x1536` +- **Image Prompt Generation**: on +- **Image Generation Engine**: `Gemini` +- **Gemini Base URL**: `https://generativelanguage.googleapis.com/v1beta` +- **Gemini API Key**: Enter your API Key +- **Gemini Endpoint Method**: `generateContent` + +#### Edit Image + +- **Image Edit Engine**: `Gemini` +- **Model**: `gemini-2.5-flash-image` +- **Image Size**: (can be left empty) +- **Gemini Base URL**: `https://generativelanguage.googleapis.com/v1beta` +- **Gemini API Key**: Enter your API Key + ![Screenshot of the Open WebUI Images settings page with Gemini selected and the API key, model, and image size fields highlighted.](/images/image-generation-and-editing/gemini-settings.png) :::info @@ -65,4 +95,4 @@ Image generation with a LiteLLM proxy using Gemini or Imagen endpoints is suppor To find your LiteLLM connection information, navigate to the **Admin Panel** > **Settings** > **Connections** menu. Your connection information will be listed under the Gemini API connection. -::: \ No newline at end of file +::: From 65567490eaa6dcab6bdd07d0796e4753e96a4fe9 Mon Sep 17 00:00:00 2001 From: silentoplayz Date: Wed, 19 Nov 2025 12:36:18 -0500 Subject: [PATCH 2/2] imperative -> vital --- docs/features/image-generation-and-editing/gemini.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/features/image-generation-and-editing/gemini.md b/docs/features/image-generation-and-editing/gemini.md index b3443fda2..58764f794 100644 --- a/docs/features/image-generation-and-editing/gemini.md +++ b/docs/features/image-generation-and-editing/gemini.md @@ -15,7 +15,7 @@ Open WebUI also supports image generation through the **Google AI Studio API** a 2. You may need to create a project and enable the `Generative Language API` in addition to adding billing information. :::warning -If you are utilizing a free API key, it is imperative to have a payment method on file. The absence of a valid payment method is a frequent cause of errors during the setup process. +If you are utilizing a free API key, it is vital to have a payment method on file. The absence of a valid payment method is a frequent cause of errors during the setup process. ::: :::tip