MiniMax H3 em ComfyUI: fluxos nativos, geração hospedada e ControlNet

Escolha a geração nativa ou hospedada, baixe um fluxo de trabalho de primeiro quadro e um mapa de arquivos e confira os nós, a área de imagem e as referências antes de uma execução real.

Este guia ajuda você a escolher e preparar um fluxo. Ele foi conferido com base na documentação oficial vinculada; nenhuma instalação, geração local ou avaliação de desempenho de hardware foi realizada aqui.

Revisado em 2026-10-05 · Os rascunhos didáticos originais não foram usados em gerações independentes. Não foi realizado nenhum teste comparativo de velocidade ou qualidade.

01. Escolha geração nativa, hospedada ou condicionamento controlado

Responsabilidades no fluxo de trabalho do H3
Via	Você mantém	Use quando
H3 nativo em ComfyUI	Instalação, arquivos de modelo, grafo de nós e recursos computacionais	Você precisa inspecionar ou personalizar o fluxo nativo.
H3 hospedado neste Studio	Entradas autorizadas, configurações do formulário e orçamento da tarefa	Você quer um formulário compatível sem manter os pesos do modelo localmente.
H3 Fun ControlNet	Seu fluxo separado de patch e vídeo de controle	Você precisa do fluxo documentado de condicionamento por pose/profundidade/bordas.

A visão geral oficial do H3 em ComfyUI distingue os fluxos nativos com pesos abertos do acesso hospedado. Sua área de imagem nativa com lado menor de 768 pixels e o processamento posterior de 2K são diferentes de selecionar 2K neste Studio. Não transfira um parâmetro de nó nativo para um formulário hospedado que não o disponibiliza.

02. Confira primeiro o ambiente, o armazenamento e a licença

Abra as instruções oficiais atuais e confira o modelo de fluxo selecionado antes de baixar. Um fluxo nativo exige um ambiente computacional adequado, espaço considerável para armazenar os modelos e nós ComfyUI compatíveis. Este tutorial não afirma que um Mac específico, GPU ou serviço de notebooks consiga executá-lo.

Atualize ComfyUI conforme exigido pelo modelo de fluxo atual; uma instalação mais antiga pode não ter nós H3.
Consulte os modelos a baixar e as pastas de destino nesse mesmo modelo de fluxo e nessa mesma versão.
Consulte a licença atual do modelo e qualquer licença de patch ou nó personalizado na fonte do publicador. Pesos abertos, por si só, não garantem permissão comercial para todos os usos.
Mantenha a permissão de uso das mídias de entrada separada das licenças do software e do modelo.

O processamento local também tem custos de tempo, armazenamento e infraestrutura. A geração hospedada tem o orçamento do serviço selecionado. Nenhuma das opções é automaticamente gratuita.

03. Carregue um modelo de fluxo coerente e os arquivos correspondentes

O tutorial oficial de execução nativa fornece modelos de fluxo para texto para vídeo, imagem para vídeo e referência para vídeo. Comece com um modelo de fluxo atual e mantenha compatíveis seus carregadores, pesos, codificador de texto e componentes de decodificação de áudio e vídeo. Obtenha os nomes exatos dos arquivos e os caminhos nessa fonte, em vez de combinar um grafo de nós aleatório com arquivos antigos.

Responsabilidades dos componentes do modelo de fluxo
Componente	O que verificar
Carregador do modelo	A variante esperada do modelo H3 e o caminho do arquivo
Condicionamento por texto	O codificador correspondente e os campos de prompt previstos
Codificação e decodificação de imagem e áudio	Os componentes compatíveis exigidos para a mídia selecionada
Amostragem e saída	Área de imagem do modelo de fluxo, configurações de quadros e destino de salvamento

Na primeira execução, mantenha o grafo próximo do modelo de fluxo fornecido. Adicione uma referência ou altere um requisito do prompt somente depois que o fluxo básico carregar e produzir uma saída que possa ser avaliada.

04. Baixe um exercício de primeiro quadro com versão fixada

Baixe um exercício de primeiro quadro derivado de um modelo de fluxo oficial I2V com versão fixada. A tarefa é um pequeno movimento da cortina enquanto uma luminária permanece imóvel. O pacote contém JSON e instruções, mas não fotos de entrada, pesos ou um resultado gerado.

Use uma versão coerente

Este grafo foi inspecionado com base no código-fonte de ComfyUI v0.33.0. Todos os tipos de backend 21 do grafo elaborado têm declarações nessa fonte, e suas conexões serializadas passam nas verificações estáticas. A documentação indica 0.30.0+ para a família base; isso não estabelece a versão mínima ou máxima para executar este grafo. O frontend 1.49.6 é apenas a versão usada para criar o modelo de fluxo.

ComfyUI/models/diffusion_models/: minimax_h3_fl2va_pruned_int8_convrot.safetensors
ComfyUI/models/text_encoders/: qwen3vl_32b_minimax_h3_nvfp4_awq.safetensors
ComfyUI/models/vae/: minimax_h3_video_vae_int8_convrot.safetensors
ComfyUI/models/vae/: minimax_h3_audio_vae_fp32.safetensors
ComfyUI/models/loras/: minimax_h3_fl2v_turbo_8step_v1.0_comfyui_bf16.safetensors

Os metadados do publicador totalizam cerca de 40.07 GB para os quatro arquivos principais, ou 42.03 GB incluindo o LoRA referenciado. Esses são tamanhos dos arquivos armazenados, não requisitos de VRAM. O Turbo está desativado, mas seu carregador permanece no grafo; verifique as referências aos arquivos antes de importar.

Siga as conexões

1. LoadImage → first_frame
Selecione sua foto autorizada de luminária e cortina. Deixe last_frame vazio.
2. ResolutionSelector → width / height
O seletor externo prevalece sobre os controles do subgrafo. Verifique primeiro os valores conectados.
3. MiniMaxH3ImageToVideo → BasicGuider
O prompt e o primeiro quadro produzem o condicionamento positivo.
4. MiniMaxH3ImageToVideo → SamplerCustomAdvanced
Siga o caminho dos dados latentes até a amostragem, em vez do caminho da imagem de prévia.
5. Video / audio VAE decode → CreateVideo → SaveVideo
Decodifique vídeo e áudio separadamente, combine-os e depois salve em output/video com o prefixo h3_lamp_curtain.

Importe e prepare a primeira tomada

Prepare sua própria foto 1344 × 768 de luminária e cortina. O nome de arquivo no pacote é um marcador de posição; selecione um arquivo real em LoadImage após a importação.
Arraste o JSON para ComfyUI e expanda o subgrafo I2V. Inspecione cada carregador de modelo, first_frame e o last_frame vazio.
Mantenha o seletor 16:9 definido no exercício, 0.98 MP, múltiplo 32, duração 5, semente 42 e turbo_mode=false. A fórmula verificada produz 1344 × 768. Selecionar 1.0 MP produziria, por sua vez, 1376 × 768.
Mantenha o prompt de cortina que acompanha o exercício. Após verificar o ambiente e os arquivos, execute uma vez e registre a saída real. O modelo de fluxo ajusta a duração 5 para 124 quadros; 124/24 corresponde a cerca de 5.17 segundos, e não a uma duração medida do arquivo salvo.

A inspeção estática não comprova a importação no frontend, o carregamento dos pesos, a adequação da memória, a inferência ou a reprodução de áudio e vídeo. Nenhuma execução de ComfyUI ou GPU foi realizada aqui. Avalie a luminária, o movimento da cortina, o final e o áudio após uma execução real. O aviso MIT mantido no fluxo é separado dos termos do modelo, das mídias e da saída.

Modelo de fluxo oficial com versão fixada · Arquivos do publicador · Escopo da validação estática

05. Defina as referências e um plano de aceitação para a primeira tomada

Uma referência de aparência, um primeiro ou último quadro e um guia de linha do tempo têm funções diferentes nos fluxos nativos. Siga os campos e rótulos do modelo de fluxo selecionado. Uma imagem conectada a uma âncora da linha do tempo não se torna automaticamente uma referência acessível pelo texto em todos os campos de prompt; a documentação específica de Adicionar guia explica essa distinção.

Use uma imagem autorizada de uma lanterna ao lado de uma cortina. Sua primeira tarefa é um pequeno movimento da cortina enquanto a lanterna permanece imóvel. Este é um breve resumo da intenção do exercício baixado; adapte-o aos campos reais do modelo de fluxo. Nenhuma das versões foi executada aqui.

A referência define a aparência da lanterna, da cortina e do cômodo. Uma câmera fixa mantém a lanterna e a cortina visíveis. A cortina balança suavemente uma vez e depois para. A lanterna permanece imóvel, com luz quente constante. Nenhum objeto novo, movimento novo de câmera ou mudança de cena. Termine em um estado de repouso claramente perceptível.

Verifique separadamente o movimento, a forma dos objetos e o final. Escolha a quantidade de quadros, a área de imagem e as opções de salvamento no modelo de fluxo nativo; configure separadamente a duração hospedada e a quantidade de quadros nativa.

06. Trate Fun ControlNet como um fluxo separado

A página oficial de Fun ControlNet descreve um patch H3 separado para vídeos de controle de pose, profundidade ou contornos. Use a preparação dos controles e as conexões do patch documentadas nela. Isso é diferente de enviar um vídeo comum de ação para o formulário de referência do H3 hospedado.

Se você precisa apenas de uma referência geral de ação, o fluxo adicional de controle pode ser desnecessário. Se precisar do caminho de condicionamento dele, primeiro verifique se a fonte e o patch selecionado são adequados; escrever “controle de pose” em um prompt hospedado não instala nem ativa esse patch.

ComfyUI: H3 Fun ControlNet

07. Localize a falha antes de substituir o fluxo

Verificações da primeira execução nativa
Sintoma	Primeira verificação	Próxima ação
Nó H3 ausente	Versão do núcleo e erros de importação na inicialização	Siga o requisito de atualização do modelo de fluxo; não escolha por palpite um pacote sem relação com ele.
Modelo não encontrado	Nome do arquivo, conclusão do download e caminho do carregador	Use a lista oficial atual de arquivos e a pasta correspondente.
Erro de codificação ou decodificação	Compatibilidade dos componentes e tipos de entrada	Volte a um modelo de fluxo coerente antes de adicionar mais mídias.
Falha de memória ou de carregamento	Pesos escolhidos, área de imagem e ambiente de processamento	Consulte os requisitos documentados; considere uma opção hospedada se manter esse ambiente não for adequado.
A saída não segue uma referência	Função da entrada, conflitos no prompt e conexões efetivas do guia	Simplifique para uma função e uma ação, depois inspecione a saída.

Salve a versão do modelo de fluxo, as configurações e a mensagem de erro. Não trate uma falha de carregamento local como evidência de que o modelo hospedado não consegue realizar a tarefa, nem um sucesso hospedado como prova de que seu ambiente local está configurado corretamente.

08. Escolha um próximo passo em vez de baixar tudo

Leia primeiro o modelo de fluxo oficial atual se seu objetivo for a execução nativa. Para as entradas exatas do nó de guia, use Adicionar guia; para o pacote de direção da comunidade, mantido separadamente, consulte a própria fonte e versão dele. A habilidade de escrita de prompts do publicador auxilia na escrita, mas não renderiza.

Para a alternativa hospedada, selecione os materiais compatíveis no formulário do Studio e confira o orçamento. Este site não executa seu grafo ComfyUI nem disponibiliza os controles dos nós de linha do tempo dele.