Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -0,0 +1,40 @@
---
sidebar_position: 7
title: "Lumenfall"
---

:::warning
This tutorial is a community contribution and is not supported by the Open WebUI team. It serves only as a demonstration on how to customize Open WebUI for your specific use case. Want to contribute? Check out the contributing tutorial.
:::

Open WebUI also supports image generation through [Lumenfall](https://lumenfall.ai), an AI media gateway that unifies all popular image models on many different providers into an OpenAI-compatible API. Free models are available.

### Initial Setup

1. Create a free account at [lumenfall.ai](https://lumenfall.ai).
2. Generate an API key from your [dashboard](https://lumenfall.ai/app/api_keys).

### Configuring Image Generation

1. In Open WebUI, navigate to the **Admin Panel** > **Settings** > **Images** menu.
2. Set the `Image Generation Engine` field to `Open AI` (Lumenfall uses the same syntax as OpenAI).
3. Change the API endpoint URL to `https://api.lumenfall.ai/openai/v1`.
4. Enter your Lumenfall API key.
5. The API version can be left blank.
6. Enter the model you wish to use. For example: `gemini-3-pro-image`, `gpt-image-1.5`, or `flux.2-max`. See all available models at [lumenfall.ai/models](https://lumenfall.ai/models).
7. Set the image size (e.g. `1024x1024`). Supported sizes depend on the model - if unsure, `1024x1024` works with most models.

![Screenshot of the Open WebUI Images settings page configured with Lumenfall.](/images/image-generation-and-editing/lumenfall-settings.png)

### Configuring Image Editing

Lumenfall also supports image editing through the same API:

1. On the same **Images** settings page, scroll to the **Edit Image** section.
2. Toggle **Image Edit** to on.
3. Set the `Image Edit Engine` to `Open AI`.
4. Enter the same API endpoint URL: `https://api.lumenfall.ai/openai/v1`.
5. Enter your Lumenfall API key.
6. Choose a model that supports editing (e.g. `gpt-image-1.5`).

For more details, see the [Lumenfall documentation](https://docs.lumenfall.ai/integrations/openwebui).
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.