Este tutorial é uma contribuição da comunidade e não é suportado pela equipe do Open WebUI. Ele serve apenas como uma demonstração de como personalizar o Open WebUI para seu caso de uso específico. Quer contribuir? Confira o tutorial de contribuição.
🎨 Geração de Imagens
O Open WebUI suporta geração de imagens por meio de três backends: AUTOMATIC1111, ComfyUI e OpenAI DALL·E. Este guia ajudará você a configurar e usar qualquer uma dessas opções.
AUTOMATIC1111
O Open WebUI suporta geração de imagens através da API do AUTOMATIC1111. Aqui estão os passos para começar:
Configuração Inicial
-
Certifique-se de que você tem o AUTOMATIC1111 instalado.
-
Inicie o AUTOMATIC1111 com flags adicionais para habilitar o acesso à API:
./webui.sh --api --listen
-
Para instalação no Docker do WebUI com as variáveis de ambiente pré-configuradas, use o seguinte comando:
docker run -d -p 3000:8080 --add-host=host.docker.internal:host-gateway -e AUTOMATIC1111_BASE_URL=http://host.docker.internal:7860/ -e ENABLE_IMAGE_GENERATION=True -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main
Configurando o Open WebUI com AUTOMATIC1111
-
No Open WebUI, acesse o menu Painel de Administração > Configurações > Imagens.
-
Configure o campo
Motor de Geração de Imagens
paraPadrão (Automatic1111)
. -
No campo URL da API, insira o endereço onde a API do AUTOMATIC1111 está acessível:
http://<seu_endereço_automatic1111>:7860/
Se você estiver executando uma instalação Docker do Open WebUI e AUTOMATIC1111 no mesmo host, use
http://host.docker.internal:7860/
como seu endereço.
ComfyUI
O ComfyUI fornece uma interface alternativa para gerenciar e interagir com modelos de geração de imagens. Saiba mais ou baixe-o em sua página do GitHub. Abaixo estão as instruções de configuração para usar o ComfyUI junto com suas outras ferramentas.
Configuração Inicial
-
Baixe e extraia o pacote de software ComfyUI do GitHub no diretório desejado.
-
Para iniciar o ComfyUI, execute o seguinte comando:
python main.py
Para sistemas com pouca VRAM, inicie o ComfyUI com flags adicionais para reduzir o uso de memória:
python main.py --lowvram
-
Para instalação no Docker do WebUI com as variáveis de ambiente pré-configuradas, use o seguinte comando:
docker run -d -p 3000:8080 --add-host=host.docker.internal:host-gateway -e COMFYUI_BASE_URL=http://host.docker.internal:7860/ -e ENABLE_IMAGE_GENERATION=True -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main
Configurando o Open WebUI com ComfyUI
Configurando Modelos FLUX.1
- Checkpoints do Modelo:
- Baixe o modelo
FLUX.1-schnell
ouFLUX.1-dev
da página HuggingFace black-forest-labs. - Coloque os arquivos de checkpoint do modelo tanto nos diretórios
models/checkpoints
quantomodels/unet
do ComfyUI. Alternativamente, você pode criar um link simbólico entre os diretórios para garantir que ambos contenham os mesmos arquivos.
- Modelo VAE:
- Baixe o
ae.safetensors
VAE aqui. - Coloque-o no diretório
models/vae
do ComfyUI.
- Modelo CLIP:
- Baixe o
clip_l.safetensors
aqui. - Coloque-o no diretório
models/clip
do ComfyUI.
- Modelo T5XXL:
- Baixe o
t5xxl_fp16.safetensors
out5xxl_fp8_e4m3fn.safetensors
aqui. - Coloque-o no diretório
models/clip
do ComfyUI.
Para integrar o ComfyUI ao Open WebUI, siga estes passos:
Passo 1: Configure as Configurações do Open WebUI
- Acesse o Painel de Administração no Open WebUI.
- Clique em Configurações e selecione a guia Imagens.
- No campo
Motor de Geração de Imagens
, escolhaComfyUI
. - No campo URL da API, insira o endereço onde a API do ComfyUI está acessível, seguindo este formato:
http://<seu_endereço_comfyui>:8188/
.- Defina a variável de ambiente
COMFYUI_BASE_URL
para este endereço para garantir que ela persista no WebUI.
- Defina a variável de ambiente
Passo 2: Verifique a Conexão e Habilite a Geração de Imagens
- Certifique-se de que o ComfyUI esteja funcionando e que você tenha verificado com sucesso a conexão com o Open WebUI. Não será possível prosseguir sem uma conexão bem-sucedida.
- Uma vez verificada a conexão, habilite Geração de Imagens (Experimental). Mais opções serão apresentadas a você.
- Continue para a etapa 3 para os passos finais de configuração.
Etapa 3: Configurar as Configurações do ComfyUI e Importar Fluxo de Trabalho
- Ative o modo de desenvolvedor dentro do ComfyUI. Para fazer isso, procure o ícone de engrenagem acima do botão Queue Prompt no ComfyUI e habilite a alternância
Dev Mode
. - Exporte o fluxo de trabalho desejado do ComfyUI no formato
API
usando o botãoSave (API Format)
. O arquivo será baixado comoworkflow_api.json
se realizado corretamente. - Volte para o Open WebUI e clique no botão Clique aqui para fazer upload de um arquivo workflow.json.
- Selecione o arquivo
workflow_api.json
para importar o fluxo de trabalho exportado do ComfyUI para o Open WebUI. - Após importar o fluxo de trabalho, você deve mapear os
ComfyUI Workflow Nodes
de acordo com os IDs dos nós de fluxo de trabalho importados. - Configure
Set Default Model
com o nome do arquivo do modelo sendo usado, comoflux1-dev.safetensors
.
Você pode precisar ajustar uma ou duas Input Key
dentro da seção ComfyUI Workflow Nodes
do Open WebUI para corresponder a um nó dentro do seu fluxo de trabalho.
Por exemplo, seed
pode precisar ser renomeado para noise_seed
para corresponder a um ID de nó dentro do seu fluxo de trabalho importado.
Alguns fluxos de trabalho, como os que usam qualquer um dos modelos Flux, podem utilizar vários IDs de nós que são necessários para preencher seus campos de entrada de nós dentro do Open WebUI. Se um campo de entrada de nó exigir vários IDs, os IDs dos nós devem ser separados por vírgulas (por exemplo, 1
ou 1, 2
).
- Clique em
Save
para aplicar as configurações e aproveite a geração de imagens com o ComfyUI integrado ao Open WebUI!
Após concluir essas etapas, sua configuração do ComfyUI deverá estar integrada ao Open WebUI, e você poderá usar os modelos Flux.1 para geração de imagens.
Configurando com SwarmUI
SwarmUI utiliza ComfyUI como seu backend. Para que o Open WebUI funcione com o SwarmUI, você precisará adicionar ComfyBackendDirect
ao ComfyUI Base URL
. Além disso, será necessário configurar o SwarmUI com acesso LAN. Após os ajustes mencionados, configurar o SwarmUI para funcionar com o Open WebUI será igual ao Passo um: Configurar Configurações do Open WebUI conforme descrito acima.
SwarmUI API URL
O endereço que você deverá inserir como ComfyUI Base URL será semelhante a: http://<seu_endereço_swarmui>:7801/ComfyBackendDirect
OpenAI DALL·E
O Open WebUI também suporta geração de imagens através das APIs OpenAI DALL·E. Esta opção inclui um seletor para escolher entre DALL·E 2 e DALL·E 3, cada um suportando diferentes tamanhos de imagens.
Configuração Inicial
- Obtenha uma chave API da OpenAI.
Configurando o Open WebUI
- No Open WebUI, navegue até o menu Painel Administrativo > Configurações > Imagens.
- Defina o campo
Image Generation Engine
comoOpen AI (Dall-E)
. - Insira sua chave API da OpenAI.
- Escolha o modelo DALL·E que deseja usar. Note que as opções de tamanho de imagem dependerão do modelo selecionado:
- DALL·E 2: Suporta imagens de
256x256
,512x512
ou1024x1024
. - DALL·E 3: Suporta imagens de
1024x1024
,1792x1024
ou1024x1792
.
- DALL·E 2: Suporta imagens de
Azure OpenAI
Usar diretamente Azure OpenAI DALL·E não é suportado, mas você pode configurar um proxy LiteLLM que é compatível com o Open AI (Dall-E)
Image Generation Engine.
Usando a Geração de Imagens
- Primeiro, use um modelo de geração de texto para escrever um prompt para a geração de imagens.
- Após a resposta terminar, você pode clicar no ícone de imagem para gerar uma imagem.
- Depois que a imagem terminar de ser gerada, ela será retornada automaticamente no chat.
Você também pode editar a resposta do LLM e inserir seu prompt de geração de imagens como a mensagem para enviar para geração de imagens em vez de usar a resposta real fornecida pelo LLM.