WaveSpeedAI

LTX 2.3 GGUF: Fluxo de Trabalho Local de Áudio e Vídeo

Planeje um fluxo de trabalho local com LTX 2.3 GGUF usando ComfyUI-GGUF, Hugging Face e modelos quantizados da comunidade, gerenciando riscos de suporte e licença.

By Dora11 min read

Tenho recebido a mesma mensagem direta duas vezes por semana: “Onde faço o download do ​LTX 2.3 GGUF?​” As pessoas pesquisam, encontram duas páginas de comunidade no Hugging Face e então pausam — nenhuma delas é da Lightricks. Essa hesitação está correta. Ambas as páginas são reais, a comunidade tem as mantido ativamente, mas o suporte, licenciamento e cadência de atualizações não são os mesmos de um lançamento oficial.

LTX 2.3 GGUF é um conjunto de quantizações comunitárias do modelo de áudio-vídeo LTX-2.3 da Lightricks. Os pesos originais são abertos, mas em precisão completa. As versões GGUF são reempacotadas para inferência local com menor VRAM. Este artigo documenta de onde vêm os arquivos, como executá-los no ComfyUI ou via um launcher local, e quando eu pararia de depender da inferência local e migraria para execução hospedada.

De onde vem o LTX 2.3 GGUF

O cenário de quantização comunitária se reduziu a dois mantenedores principais no início de 2026. Ambos publicam na mesma plataforma, ambos seguem o mesmo upstream — os checkpoints LTX-2.3 da Lightricks — mas adotam abordagens ligeiramente diferentes.

Quantização comunitária: QuantStack e Unsloth

A página do LTX-2.3-GGUF da QuantStack no Hugging Face é uma conversão direta dos pesos originais. Disponibiliza variantes de Q2_K a Q8_0 das versões destiladas e completas de 22B. Direto ao ponto. Se você quer o menor arquivo viável, é aqui que você vem.

A página LTX-2.3-GGUF da Unsloth usa o que eles chamam de metodologia Dynamic 2.0 — as camadas mais importantes são mantidas em maior precisão, enquanto o restante é quantizado de forma agressiva. O repositório contém conjuntos dev e destilados, além de seus próprios arquivos de workflow de exemplo. O model card credita o ferramental ComfyUI-GGUF do city96, que é o mesmo pacote de nós que você precisará de qualquer forma.

Eu não fiz uma comparação lado a lado longa o suficiente para publicar números sobre qual produz melhores resultados em um determinado nível de quantização. Isso é um projeto diferente.

Pesos oficiais da Lightricks vs builds GGUF comunitários

A Lightricks publica os pesos originais do LTX-2.3 — safetensors de precisão completa, pipelines de inferência oficiais, nós ComfyUI oficiais (o pacote ComfyUI-LTXVideo, separado do GGUF). Eles também publicam extensões de controle de câmera como o LTX Director, que dependem do formato de peso original. Esses recursos ou não funcionam ou funcionam de forma imperfeita com builds GGUF. Isso é uma perda real, dependendo do que você está fazendo.

As versões GGUF trocam paridade de recursos com o upstream por margem de VRAM. Esse é o acordo completo. Se você precisa de todos os recursos que a Lightricks lança, execute os pesos completos. Se sua máquina não suporta, o GGUF é a troca.

Por que o status de lançamento não oficial importa para suporte e revisão de licença

O que os resultados de busca não dizem claramente: QuantStack e Unsloth são colaboradores comunitários. Eles não são a Lightricks. Se algo quebrar, você está abrindo uma issue em um repositório comunitário, não obtendo suporte do fornecedor. A licença em ambas as páginas comunitárias é ltx-2-community-license-agreement — as mesmas restrições de uso comercial que se aplicam aos pesos originais ainda se aplicam às versões quantizadas. A quantização não remove o licenciamento.

Vale a pena desacelerar neste ponto. Trate a revisão de licença como uma etapa real, não uma caixa de seleção.

Caminhos de configuração local para desenvolvedores

Há aproximadamente três maneiras de executar esses builds GGUF localmente. Elas não são equivalentes. São para públicos diferentes.

Acesso a modelos no Hugging Face

Os arquivos da QuantStack e da Unsloth estão no Hugging Face. Você pode baixá-los com git lfs clone ou via huggingface-cli download. Se você quer apenas o menor arquivo viável, pegue uma das variantes de nível médio — os nomes seguem as convenções padrão do llama.cpp (Q3_K_M, Q4_K_S, Q4_K_M, etc.). Escolha um, baixe e siga em frente.

O que a plataforma não fornece é um runtime. Apenas os arquivos.

ComfyUI + nó ComfyUI-GGUF do city96

Este é o caminho que vejo a maioria das pessoas seguir. O pacote de nós no repositório ComfyUI-GGUF do city96 estende o ComfyUI para carregar modelos UNet GGUF. Instale-o em ComfyUI/custom_nodes, coloque o arquivo GGUF em ComfyUI/models/unet, reinicie o ComfyUI e o carregador GGUF Unet aparecerá na categoria bootleg. A partir daí, você o conecta a um workflow de geração de vídeo da mesma forma que conectaria um UNet normal.

Vale notar: o nó do city96 foi escrito antes do LTX-2 existir. Ele lida com o carregamento GGUF de forma genérica. Se um arquivo LTX-2.3 GGUF específico funciona de ponta a ponta depende do workflow e dos arquivos de codificador de texto e VAE que ele espera junto ao modelo principal. Ambas as páginas comunitárias publicam workflows de exemplo por esse motivo — comece pelos deles.

Pinokio ou workflow de launcher local como caminho secundário

O launcher open-source do Pinokio empacota aplicações de IA com instalação em um clique, gerenciando ambientes Python, dependências e downloads de modelos por trás de uma interface gráfica. Não é um substituto para o ComfyUI. É uma forma de pular a configuração manual se já existir um script para seu aplicativo-alvo no diretório dele.

Para esses modelos quantizados especificamente, o valor do Pinokio depende de existir um script mantido que aponte para a versão atual. Verifique antes de assumir. Se você já está no ComfyUI, o launcher não acrescenta muito. Se você está começando do zero em uma máquina Windows sem configuração Python, ele elimina horas de trabalho doloroso.

Como avaliar variantes GGUF

Escolher um nível de quantização não é simplesmente “menor = qualidade inferior.” As compensações não são lineares e variam por modelo.

Opções de quantização como Q4KM e variantes similares

Q4_K_M é um ponto de partida comum porque fica no meio da faixa padrão do llama.cpp — pequeno o suficiente para caber em GPUs de consumidor, grande o suficiente para preservar a maior parte do comportamento original. Variantes Q3 te colocam em envelopes de VRAM menores, mas a queda de qualidade torna-se visível nos detalhes finos. Q8 preserva mais do original, mas o arquivo fica grande o suficiente para que você tenha em parte derrotado o propósito de executar GGUF localmente.

Eu começo com Q4_K_M nas primeiras execuções. Se os resultados parecerem aceitáveis, fico com ele. Se não parecerem, subo antes de descer.

Registro de prompt, seed e saída

Execuções de teste sem controle de seed não são testes. São suposições. Fixe o seed, escreva o prompt em um arquivo, salve o nome do arquivo de saída com ambos. Quando você trocar de níveis de quantização ou workflows, vai querer comparar como-para-como, e “acho que a versão Q4 pareceu pior” não ajuda se você não conseguir reproduzir a comparação.

Eu mantenho um CSV simples: prompt, seed, nível de quantização, arquivo de workflow, caminho de saída, julgamento em uma linha. Entediante. Eficaz.

Verificações de sincronização áudio-vídeo

O LTX-2 gera áudio e vídeo sincronizados em um único modelo — essa é a funcionalidade principal. A sincronização é o que a quantização GGUF tem mais probabilidade de degradar sutilmente, porque a quantização afeta todas as camadas, incluindo aquelas que gerenciam o alinhamento áudio-visual. Assista as saídas de ponta a ponta, não apenas os primeiros 1-2 segundos. O movimento labial que deriva em relação à faixa de áudio por uma fração de segundo é o modo de falha que mais tenho visto.

É aqui que meus dados terminam. Não fiz medições controladas de deriva, e desconfiaria de qualquer pessoa que as publique sem mostrar a metodologia.

Evite fixar afirmações de hardware sem contexto de teste

Você vai ver threads no Reddit afirmando “Q4_K_M roda a X tokens/seg em uma 3090” ou “12GB de VRAM são suficientes.” Não leve esses dados como portáveis. São um único ponto de dados em um único workflow com tamanhos de lote, resoluções e contagens de frames não declarados. Teste no seu hardware, com seu workflow, e anote o que você mediu.

Compensações de produção na inferência local

Executar esses modelos localmente é adequado para experimentação. A questão é se escala para produção. A resposta é às vezes.

Controle local e privacidade

O argumento para o local é real. Os prompts ficam na sua máquina. As saídas ficam na sua máquina. Sem telemetria de uso, sem limites de taxa, sem surpresas na fatura mensal. Para workflows envolvendo material de cliente sensível ou IP pré-lançamento, isso não é uma consideração pequena.

Risco de manutenção, drivers e dependências

O argumento contra o local também é real, e aparece mais tarde. Atualizações do ComfyUI podem quebrar a compatibilidade de nós personalizados. Atualizações de drivers CUDA podem quebrar o PyTorch. Uma atualização do Windows pode mover caminhos de arquivo. A pilha local que você conseguiu fazer funcionar na terça-feira pode não funcionar na sexta. Isso não é um problema de qualidade de software — é o custo de executar uma pilha de grau de pesquisa fora de um ambiente gerenciado.

Para trabalho solo, isso é irritante. Para produção em equipe, torna-se um trabalho de meio período que ninguém pediu.

Quando a inferência hospedada é mais segura

Há um limiar de uso acima do qual executar o LTX-2.3 — quantizado ou não — no seu próprio hardware deixa de fazer sentido. Os sinais: você está gerando múltiplos vídeos por dia, precisa de saída consistente entre membros da equipe em diferentes máquinas, ou precisa de throughput que não dependa de a atualização do driver da noite anterior ter quebrado o ComfyUI. Passado esse ponto, a inferência hospedada — onde outra pessoa gerencia a GPU, os arquivos de modelo e a pilha de dependências — geralmente vence.

Hospedado tem suas próprias compensações: os dados saem da sua máquina, o custo por geração é medido, a escolha de modelo é o que o provedor suporta. Mas o fardo de manutenção vai a zero, o que para equipes de produção geralmente é a troca certa.

Pesquisas GGUF adjacentes para tratar com cuidado

Se você tem pesquisado por LTX 2.3 GGUF, provavelmente também viu o Sulphur 2 GGUF aparecer nos mesmos resultados. Não são a mesma coisa.

Por que o Sulphur 2 GGUF é provavelmente uma intenção separada

Sulphur 2 GGUF é um fine-tune comunitário do LTX-2.3 distribuído pelo Civitai em vez dos mantenedores acima, voltado para conteúdo NSFW com sua própria dependência de nó personalizado (smthemex/ComfyUI_LTX2_SM, não o pacote do city96). Modelo diferente, workflow diferente, público diferente. Se você chegou aqui procurando por isso, você está no artigo errado.

Quando separar a comparação GGUF em outro artigo

Eu escreveria o Sulphur 2 GGUF separadamente. O público, a revisão de licença e a configuração de runtime são diferentes o suficiente para que misturar a comparação diluiria ambos os artigos. A ser verificado — não o testei pessoalmente, e qualquer escrita futura começaria com essa divulgação.

FAQ

O LTX 2.3 GGUF é um lançamento oficial da Lightricks?

Não. O termo refere-se a quantizações mantidas pela comunidade publicadas pela QuantStack e Unsloth no Hugging Face. São conversões diretas dos pesos LTX-2.3 upstream da Lightricks, mas a própria Lightricks publica apenas checkpoints de precisão completa. Consulte a documentação oficial da Lightricks para o estado atual de qualquer lançamento GGUF direto.

Como executo o LTX 2.3 GGUF no ComfyUI?

Instale o nó ComfyUI-GGUF do city96 em ComfyUI/custom_nodes, coloque o arquivo GGUF em ComfyUI/models/unet, reinicie o ComfyUI e use o carregador GGUF Unet na categoria bootleg. Você também precisará dos arquivos de codificador de texto e VAE correspondentes referenciados no workflow comunitário que você estiver seguindo. As páginas da Unsloth e da QuantStack ambas disponibilizam workflows de exemplo que vale a pena usar como ponto de partida.

Quais são os riscos de usar modelos quantizados pela comunidade?

Três principais. Sem suporte do fornecedor se algo quebrar — você está nos rastreadores de issues da comunidade. A revisão de licença continua sendo sua responsabilidade: a licença da comunidade LTX-2 ainda se aplica, e os termos oficiais de licença estão publicados no repositório LTX-2 da Lightricks. E lacunas de recursos em relação aos pesos oficiais — extensões como o LTX Director ou novas atualizações de pipeline oficial podem não funcionar corretamente com builds GGUF. Consulte a documentação mais recente da Lightricks para o estado atual da paridade de recursos oficiais.

Devo usar Pinokio, Hugging Face, ComfyUI ou inferência hospedada?

Depende do que você está fazendo. Pinokio para pular a configuração se já existir um script para seu aplicativo-alvo. Hugging Face para obter os arquivos diretamente. ComfyUI com o nó GGUF do city96 para realmente executar e ajustar workflows. Inferência hospedada quando a sobrecarga de manutenção local supera o valor de manter a execução na sua própria máquina. O limite geralmente é se você está enviando saídas para alguém além de você mesmo.

Posts anteriores:

Compartilhar