Guia de instalação local
Como executar FLUX 3 Klein no ComfyUI
O FLUX 3 Klein é publicado com pesos abertos e um template de ComfyUI, então você pode rodá-lo na sua própria GPU sem chave de API e sem créditos por imagem. Aqui está o que instalar, onde cada arquivo vai, como os quatro workflows incluídos diferem e o que a licença permite.
ComfyUI local ou no navegador
O ComfyUI local mantém todo o ciclo na sua máquina: prompts, fotos de referência e arquivos de saída não saem do disco, e não há cobrança por imagem. Em troca, é o caminho com mais configuração, porque os templates esperam uma versão específica do ComfyUI, cinco arquivos e o checkpoint certo para cada tarefa.
Se você só quer ver o que o modelo faz com a sua redação, pode pular a instalação. Este site roda o FLUX 3 Klein nos próprios servidores e aceita até três imagens de referência, então um prompt escrito aqui volta em um minuto.
Este campo abre o gerador com o FLUX 3 Klein, o único modelo deste site. Não há nada para instalar nem arquivo para baixar.
O que você precisa antes de começar
Os templates foram feitos para uma combinação específica de versão, arquivos e checkpoints. Se um destes quatro pontos estiver errado, o workflow não carrega ou falha na amostragem.
ComfyUI 0.41.0 ou mais recente
Os templates do FLUX 3 Klein exigem ComfyUI 0.41.0 ou superior e chegaram no backport 0.41.1. Se o template não aparecer na lista, atualize o ComfyUI primeiro.
Acesso ao repositório de pesos com acesso restrito
Os pesos ficam em black-forest-labs/flux-3-image-klein-comfy no Hugging Face. Abra o repositório e aceite a licença com a sessão iniciada, senão os arquivos continuam bloqueados.
Cinco arquivos em três pastas
Dois checkpoints de difusão, um codificador de texto, o upsampler de prompts e o VAE do FLUX.2, colocados em models/diffusion_models/, models/text_encoders/ e models/vae/.
VRAM suficiente para o checkpoint escolhido
A documentação do ComfyUI não informa requisito algum. A Black Forest Labs indica os pesos do gerador em 11,2 GB em BF16 e 5,6 GB em FP8, e afirma que a versão INT8 roda em placas NVIDIA RTX com apenas 8 GB de VRAM; o código de referência atinge picos maiores em 1024x1024. Os números completos estão nas FAQ.
Arquivos do modelo e a pasta de cada um
Os templates carregam os checkpoints de arquivo único em int8 (convrot); as versões bf16 e nvfp4 ficam no mesmo repositório. Coloque os arquivos baixados nestas pastas.
| Pasta | Usado por | |
|---|---|---|
| flux3_image_klein_base_int8_convrot.safetensors | models/diffusion_models/ | Checkpoint completo do FLUX 3 Klein; os templates de texto para imagem e de edição o carregam |
| flux3_image_klein_sd_int8_convrot.safetensors | models/diffusion_models/ | Checkpoint destilado para execuções de 4 a 16 passos |
| qwen3vl_4b_int8_convrot.safetensors | models/text_encoders/ | Codificador de texto dos dois checkpoints; carregue com CLIPLoader e type flux3 |
| qwen3.5_9b_flux3_prompt_upsampler_w4a8.safetensors | models/text_encoders/ | Upsampler de prompts usado pelos templates de texto para imagem |
| flux2-vae.safetensors | models/vae/ | VAE do FLUX 3 Klein, ou seja, o VAE do FLUX.2 |
Os caminhos são relativos à sua pasta do ComfyUI. O repositório tem acesso restrito: aceite a licença em huggingface.co/black-forest-labs/flux-3-image-klein-comfy antes de os arquivos liberarem. Fonte: docs.comfy.org/tutorials/flux/flux-3-klein, consultada em 17 de outubro de 2026.
Os quatro workflows, passo a passo
A biblioteca de templates traz quatro workflows do FLUX 3 Klein: texto para imagem e edição de imagem, cada um em versão completa e destilada.
Texto para imagem, checkpoint completo
Abra «FLUX 3 Image Klein: Text to Image», digite o prompt no subgraph, defina largura e altura ou escolha um enquadramento no ResolutionSelector, e deixe steps em 50 com cfg 3.5. O upsampler Qwen3.5 9B vem ligado; desligue enable_prompt_upsampler para amostrar suas próprias palavras.
Texto para imagem, destilado
Este workflow carrega flux3_image_klein_sd_int8_convrot.safetensors e roda em 16 passos com cfg fixo em 1, então aumentar o cfg não ajuda. Para uma passada rápida você pode descer até 4 passos.
Edição de imagem, checkpoint completo
Carregue a foto original no nó LoadImage e conecte-a ao Set Reference Multi Latent. Escreva a instrução como descrição completa da imagem final; o prompt do exemplo incluído é «In <ref_image_0>, change the dress color <obj_1> to red». A tela vem do Empty Flux 2 Latent, 1024x1024 no template, e aqui o guidance é 1.
Edição de imagem, destilado
Uma referência, uma instrução, 16 passos e nenhum guidance. Mantenha steps entre 4 e 16, deixe cfg em 1 e compare a entrada com o resultado no ImageCompare.
Dicas de prompt e referência que mudam o resultado
Cinco detalhes da documentação do ComfyUI. Eles pesam mais no resultado do que qualquer ajuste de sampler.
Descreva o resultado, não a mudança
Os templates de edição esperam uma descrição completa da imagem final com a mudança já embutida: por isso o exemplo incluído descreve a cor nova e o objeto a que se aplica, em vez de dizer «mude isto».
O ComfyUI numera as referências a partir de zero
Conecte imagens extras ao Set Reference Multi Latent em ordem e refira-se a elas como <ref_image_0>, <ref_image_1> e assim por diante. Atenção à diferença: os templates do ComfyUI começam em <ref_image_0>, enquanto o gerador deste site começa em <ref_image_1> e aceita até três imagens.
O tamanho da referência é um botão de custo
Os templates redimensionam cada referência para cerca de 1 milhão de pixels, e o latent de saída assume esse tamanho. Uma referência no tamanho nativo leva mais detalhe para a edição e custa mais.
O número de passos segue o checkpoint
50 passos e guidance 3.5 em texto para imagem no checkpoint completo, guidance 1 no workflow de edição dele, e 16 passos com guidance fixo em 1 no destilado. Não misture os dois conjuntos de ajustes.
Há um nó Create Bounding Boxes
Ele serve para planejar edições por região: desenha caixas sobre a imagem original e o Preview Any lista todas.
O que a licença diz
Apenas o que o editor declara, citado como publicado. Isto não é uma leitura da licença: se pretende vender o que gerar, leia o texto completo.
| Como publicado | |
|---|---|
| Pesos do FLUX 3 Klein | FLUX Kommunity License: uso não comercial, mais geração de saída comercial por Qualifying Users com menos de 5 milhões de dólares de receita anual bruta, sujeito aos termos da licença |
| Codificador de texto (Qwen3-VL-4B-Instruct) | Apache-2.0 |
| Acesso ao repositório | Com acesso restrito no Hugging Face; você aceita a licença antes de os arquivos liberarem |
| Texto completo da licença | LICENSE.md dentro do repositório de pesos (link abaixo) |
Fontes: bfl.ai/blog/flux-3-image-klein, huggingface.co/black-forest-labs/flux-3-image-klein-base e o LICENSE.md do repositório de pesos com acesso restrito, consultadas em 17 de outubro de 2026. Apenas condições publicadas; nada aqui é aconselhamento jurídico.
Onde baixar os pesos
Este site roda o FLUX 3 Klein nos próprios servidores e não hospeda nem vende os pesos: não há nada para baixar aqui. Os arquivos ficam no Hugging Face e os passos acima vêm da documentação do ComfyUI.
Executar o FLUX 3 Klein em local
Qual versão do ComfyUI eu preciso para o FLUX 3 Klein?
0.41.0 ou mais recente. Os templates chegaram no backport 0.41.1, então se «FLUX 3 Image Klein» não estiver na sua lista de templates, atualize o ComfyUI e olhe de novo.
Posso baixar os pesos do FLUX 3 Klein neste site?
Não. Este site executa o modelo no navegador e não hospeda os arquivos. Baixe-os do repositório com acesso restrito black-forest-labs/flux-3-image-klein-comfy no Hugging Face, depois de aceitar a licença.
De quanta VRAM o FLUX 3 Klein precisa?
A documentação do ComfyUI não informa nenhuma. A Black Forest Labs indica os pesos do gerador em 11,2 GB em BF16 e 5,6 GB em FP8, e afirma que a versão INT8 roda em placas RTX com 8 GB de VRAM. O código de referência chega, em 1024x1024, a 31 GB em BF16, 29 GB em FP8 ou 26 GB em NVFP4, e o upsampler acrescenta cerca de 28 GB numa placa de 80 GB. São números do próprio fabricante.
Por que o workflow reescreve meu prompt antes da amostragem?
Porque os templates de texto para imagem rodam por padrão o upsampler de prompts Qwen3.5 9B, que transforma um pedido curto em uma descrição de cena completa. Coloque enable_prompt_upsampler em off para amostrar suas próprias palavras.
Os templates do ComfyUI usam a mesma numeração de referências deste gerador?
Não. O ComfyUI começa em <ref_image_0> e o gerador deste site em <ref_image_1>. Reescreva os tokens ao levar um prompt de um lado para o outro.
Teste o prompt antes de instalar
Escreva o prompt no campo acima, rode uma vez e só então leve para o ComfyUI a redação de que gostou.