Mage Flow Edit ComfyUI Workflow: edição de imagem guiada por prompt e multi-referência com estrutura consistente#
Este fluxo de trabalho Mage Flow Edit ComfyUI pronto para RunComfy transforma uma única foto de origem mais múltiplas referências visuais em edições limpas e controladas que preservam identidade, pose, iluminação e perspectiva da câmera. Ele combina o Mage-Flow-Edit oficial da Microsoft com o condicionamento Qwen3-VL 4B e o Mage Flow VAE para entregar resultados fiéis de antes e depois para trocas de fundo, mudanças de guarda-roupa/objetos, restaurações e desenvolvimento de aparência.
Construído para produção prática, o gráfico aceita até quatro imagens de referência, codifica-as junto com seu prompt de instrução, amostra edições com Mage-Flow-Edit, decodifica com o Mage Flow VAE, e salva saídas enquanto fornece um comparador interativo de antes/depois. Se você precisa de um editor de imagem confiável que respeite a integridade do sujeito, este fluxo de trabalho Mage Flow Edit ComfyUI é projetado para você.
- Fonte: JSON do fluxo de trabalho AxiomGraph (para referência e proveniência) link
Modelos principais no fluxo de trabalho Mage Flow Edit ComfyUI#
- Microsoft Mage-Flow-Edit. O modelo principal de edição baseado em instruções usado para aplicar mudanças guiadas por prompt sem desviar identidade ou composição. Veja o cartão do modelo oficial para capacidades e exemplos. microsoft/Mage-Flow-Edit
- Mage Flow VAE. O VAE emparelhado usado para codificar/decodificar latentes na mesma distribuição que Mage-Flow e Mage-Flow-Edit, ajudando a preservar estrutura e detalhes finos ao mover entre imagem e espaços latentes. Os arquivos são reempacotados para ComfyUI. Comfy-Org/Mage-Flow
- Qwen3-VL 4B. Um modelo compacto de visão-linguagem usado aqui como o codificador de texto-imagem para fundir seu prompt de instrução com múltiplas referências visuais para condicionamento do Mage-Flow-Edit. Qwen/Qwen3-VL-4B-Instruct
Para informações sobre a arquitetura e treinamento de resolução nativa que alimentam tanto geração quanto edição, veja o artigo Mage-Flow. arXiv: Mage-Flow
Como usar o fluxo de trabalho Mage Flow Edit ComfyUI#
Este gráfico segue um caminho simples de entradas para saída: carregue uma imagem de origem e referências, prepare a resolução, codifique uma instrução com condicionamento de múltiplas imagens, amostra edições com Mage-Flow-Edit, decodifique com o Mage Flow VAE, depois salve e compare. As subseções abaixo mapeiam as principais etapas e os poucos lugares onde você interage.
Entradas e redimensionamento inteligente#
Use LoadImage (#6) para escolher sua imagem de origem, e LoadImage (#7–#9) para adicionar até três referências visuais para estilo, objetos ou fundos. A fonte é passada através de ImageScaleToTotalPixels (#22) para definir um tamanho de trabalho amigável para edição enquanto mantém a proporção. GetImageSize (#23) lê a largura e altura resultantes para que o restante do pipeline permaneça sincronizado. Manter a fonte como "imagem 1" e referências como "imagem 2–4" corresponde a como o condicionamento é conectado em etapas posteriores. Esta etapa garante que sua edição seja executada de forma eficiente sem artefatos de reamostragem indesejados.
Condicionamento de texto e visual#
CLIPLoader (#4) carrega o codificador Qwen3-VL 4B que entende tanto texto quanto imagens para condicionamento. TextEncodeMageFlowEdit (#1) pega sua instrução positiva, uma instrução negativa opcional, a fonte escalada como image_1, e até três referências como image_2–image_4. Escreva o prompt como um conjunto claro de direções de edição, por exemplo, "substitua o fundo por um pátio ensolarado; mantenha identidade, pose, mãos e perspectiva da lente." O nó produz condicionamento "positivo" e "negativo" além de um latente alinhado que ancora a estrutura do sujeito. Se a fidelidade for crítica, declare explicitamente as restrições de preservação em sua instrução.
Modelo e amostragem#
UNETLoader (#3) carrega mage_flow_edit_bf16.safetensors, o modelo padrão Mage-Flow-Edit para edições de alta qualidade. KSampler (#18) então executa as etapas reais de edição usando o modelo mais seu condicionamento e latente. Orientação, etapas e a força de desnoise determinam quão forte é a edição: desnoise mais baixo favorece mudanças sutis; valores mais altos impulsionam transformações maiores. Bloquear uma semente dá a você resultados repetíveis ao iterar em prompts ou imagens de referência. Se você precisar de pré-visualizações mais rápidas, pode mais tarde trocar o arquivo do modelo para uma variante Turbo como mencionado em Nós principais.
Decodificação latente e salvamento#
VAELoader (#5) fornece mage_flow_vae_bf16.safetensors para que VAEDecode (#19) possa transformar o latente editado de volta para RGB. A imagem decodificada flui para SaveImage (#20), que escreve um arquivo com carimbo de data/hora para que cada execução seja preservada. Esta etapa é automática; geralmente você não precisa mudar nada a menos que queira organizar saídas em diferentes subpastas.
Comparação de antes/depois#
Para verificar se a edição respeita suas restrições, o gráfico inclui Image Comparer (rgthree) (#27). Ele exibe o resultado editado de SaveImage ao lado da fonte escalada de ImageScaleToTotalPixels em uma visualização deslizante. Use-o para verificar rapidamente a retenção de identidade, continuidade de pose e iluminação, e integração de objetos. Isso torna o fluxo de trabalho Mage Flow Edit ComfyUI ideal para QA em pipelines de fotos de produção.
Nós principais no fluxo de trabalho Mage Flow Edit ComfyUI#
TextEncodeMageFlowEdit (#1)#
Este é o coração da edição baseada em instruções para Mage-Flow-Edit. Ele mescla suas instruções positivas e negativas com a imagem de origem e até três referências para produzir condicionamento e um latente alinhado à estrutura. Para uma preservação mais forte, inclua frases explícitas como "preserve identidade, pose, mãos, ângulo da câmera e perspectiva da lente." Se você vir adições indesejadas, adicione breves negativas para desviar o modelo. Este nó se baseia no codificador Qwen3-VL 4B e no Mage Flow VAE descritos acima. Referências: microsoft/Mage-Flow-Edit, Comfy-Org/Mage-Flow, Qwen/Qwen3-VL-4B-Instruct.
KSampler (#18)#
Controla como a edição é aplicada. Etapas e orientação influenciam o detalhe e a adesão à instrução, enquanto a força de desnoise governa o quanto a imagem pode mudar. Mantenha desnoise conservador para trocas de guarda-roupa ou restaurações e aumente para substituição de fundo ou mudanças de estilo pesadas. Fixe a semente ao comparar pequenas alterações de prompt para que as diferenças sejam atribuíveis às suas edições em vez de aleatoriedade.
UNETLoader (#3)#
Carrega o checkpoint específico Mage-Flow-Edit. Para pré-visualizações interativas, você pode alternar para uma variante Turbo para reduzir a latência, depois retornar ao modelo padrão bf16 para qualidade final. Ambientes de baixa VRAM podem usar as variantes INT8 ConvRot com uma pequena perda de qualidade. Veja o conjunto de arquivos prontos para Comfy para opções disponíveis. Comfy-Org/Mage-Flow
ImageScaleToTotalPixels (#22)#
Define uma resolução de trabalho eficiente enquanto mantém a proporção da fonte. Escolha um alvo de pixels total que se encaixe na memória da sua GPU e no nível de detalhe desejado; totais mais altos resultam em resultados mais finos, mas custam mais VRAM e tempo. Mantenha o tamanho de trabalho consistente em todas as iterações para que as comparações A/B sejam significativas. Este nó é a maneira mais fácil de equilibrar velocidade e fidelidade antes das etapas de codificação e amostragem.
Extras opcionais#
- Escreva instruções como edições, não descrições. "Substitua o fundo por um pátio mediterrâneo ensolarado; mantenha identidade e pose" funciona melhor do que um prompt estético genérico.
- Use cortes de referência limpos e bem iluminados que mostrem claramente os atributos que você deseja transferir (por exemplo, cor/texture de vestuário, formato de óculos, materiais de fundo).
- Comece com desnoise conservador para tarefas de preservação, depois aumente gradualmente até que a mudança seja suficiente sem prejudicar a identidade.
- Bloqueie a semente do sampler ao iterar para que você possa avaliar apenas o efeito das mudanças de prompt ou referência.
- Para exploração rápida, experimente uma variante Turbo Mage-Flow-Edit; para finais, volte aos pesos padrão bf16. Comfy-Org/Mage-Flow
Agradecimentos#
Este fluxo de trabalho implementa e se baseia nos seguintes trabalhos e recursos. Agradecemos à Microsoft pelo Mage-Flow e Mage-Flow-Edit, Comfy-Org pelos arquivos de modelo Mage-Flow para ComfyUI, e AxiomGraph pelo "Mage Flow Edit.json" fluxo de trabalho ComfyUI por suas contribuições e manutenção. Para detalhes autoritativos, consulte a documentação original e repositórios vinculados abaixo.
Recursos#
- Microsoft/Mage-Flow
- GitHub: microsoft/Mage
- Hugging Face: microsoft/Mage-Flow
- arXiv: 2607.19064
- Docs / Notas de Lançamento: Mage-Flow project page
- Microsoft/Mage-Flow-Edit
- Hugging Face: microsoft/Mage-Flow-Edit
- arXiv: 2607.19064
- Comfy-Org/Mage-Flow
- Hugging Face: Comfy-Org/Mage-Flow
- AxiomGraph/Mage Flow Edit.json
- GitHub: axiomgraph/ComfyUIWorkflow
Nota: O uso dos modelos, conjuntos de dados e códigos referenciados está sujeito às respectivas licenças e termos fornecidos por seus autores e mantenedores.
