ToonCrafter

ToonCrafter

Tencent AI Lab, The Chinese University of Hong Kong, City University of Hong Kong · Vídeo

ToonCrafter é um modelo aberto e gratuito do Tencent AI Lab e da CUHK que cria os quadros intermediários de uma cena de desenho animado a partir de dois quadros-chave, transformando o desenho inicial e o final em um clipe curto.

Prévia da interface de ToonCrafter

Sobre ToonCrafter

About

O que é o ToonCrafter

ToonCrafter é uma ferramenta de animação 2D de laboratório, não um produto por assinatura. Foi desenvolvida pelo Tencent AI Lab com pesquisadores da Universidade Chinesa de Hong Kong e da Universidade da Cidade de Hong Kong, e o trabalho saiu no SIGGRAPH Asia 2024, na revista ACM Transactions on Graphics. O código e os pesos ficaram públicos em 29 de maio de 2024, e qualquer pessoa pode baixar.

O alvo é o preenchimento de intermediários. O animador desenha as poses-chave e depois alguém precisa desenhar tudo o que fica entre elas para o movimento fazer sentido. Interpoladores de vídeo comuns partem do princípio de que o movimento segue em linha reta entre quadros, e em desenho animado isso quase nunca acontece: o corpo estica, achata e passa na frente de outro. O ToonCrafter aprende movimento com material de animação em vez de impor correspondência linear, então os quadros intermediários com IA acompanham um golpe amplo ou um salto seco sem quebrar.

Os limites pesam tanto quanto os recursos. Cada execução gera no máximo 16 quadros em 512x320, algo como dois segundos a 8 fps. O checkpoint completo pede cerca de 24 GB de memória de GPU, e os autores avisam que o resultado não é garantido em toda tomada. Serve para economizar horas de lápis, não para substituir um departamento de animação.

Como começar

  1. Clone o repositório, crie um ambiente com Python 3.8.5 e instale os requisitos.
  2. Baixe o checkpoint ToonCrafter_512 e coloque model.ckpt em checkpoints/tooncrafter_512_interp_v1/.
  3. Abra a interface Gradio com gradio_app.py, ou use o script de shell para rodar em lote. Também existem versões para ComfyUI e Colab.
  4. Carregue o primeiro e o último quadro na mesma proporção, ajuste o número de quadros e o fps, e acrescente um texto-guia ou um esboço se quiser.
  5. Revise os quadros gerados e monte o vídeo no seu editor.

Informações do produto

Uma visão rápida dos preços, das plataformas compatíveis e do desempenho de ToonCrafter.

Plano gratuitoSim
Planos pagosFree (open source, no paid tiers)
PlataformaLinux, Windows (community port), Web (Hugging Face Space, Colab)
DesenvolvedorTencent AI Lab, The Chinese University of Hong Kong, City University of Hong Kong
CategoriaVídeo
Data de lançamentoMay 2024
Última atualizaçãoMar 2025
Visitas ao site20.6K
Ranking global do site1.3M
Disponibilidade da APINão

Ideal para

Os usuários, tarefas e cenários em que esta ferramenta se encaixa melhor.

Usuários

  • Animadores 2D que fazem intermediários
  • Criadores independentes e artistas de jogos
  • Estudantes e pesquisadores

Tarefas

  • Preencher o vão entre duas poses do mesmo personagem
  • Colorir esboços a traço
  • Testar movimento antes de gastar orçamento
  • Montar folhas de sprite para protótipos

Cenários

  • Pré-visualizar uma cena para apresentar a um cliente
  • Construir um pipeline de ComfyUI
  • Reproduzir um resultado de paper para aula ou relatório

Principais recursos

Interpolação de animação cartoon entre duas imagens

A função central é a interpolação de animação cartoon a partir de duas imagens paradas. Você entrega um quadro inicial e um final, e o modelo sintetiza os do meio como sequência contínua. Não precisa de vídeo de origem, e isso o separa dos filtros que só retocam metragem já gravada. Por isso ele é usado como gerador de animação 2D, não como filtro de limpeza.

Prior de movimento ajustado a desenho animado

A base é um modelo de difusão imagem para vídeo treinado com filmagem real, corrigido depois com material de animação. Essa correção mantém a estabilidade de movimento que o modelo original já tinha e a inclina para a física do desenho. Na prática, poses exageradas e arcos rápidos aguentam melhor do que com um interpolador genérico.

Decodificador 3D de referência dupla

Um segundo decodificador puxa detalhe das duas imagens de entrada e injeta nos quadros gerados. Traços finos e áreas de cor chapada são a primeira coisa a borrar num espaço latente comprimido, e esse caminho evita que o contorno vire mancha. Rostos e objetos pequenos se seguram bem melhor por causa dele.

Animação guiada por esboço

Um codificador de esboço deixa você desenhar o movimento desejado e o modelo segue. Como ele trabalha quadro a quadro, dá para marcar a guia em poucos quadros ou em muitos, conforme o controle que a cena pede. É esse recurso que troca o chute por direção, e o motivo principal pelo qual um estúdio se dá ao trabalho de instalar localmente.

Colorização de line art

Além da interpolação, o ToonCrafter faz colorização de line art quando você combina um esboço com uma referência de cor. O modelo transfere paleta e estilo de sombreamento para o desenho em vez de apenas preencher regiões chapadas. Ajuda a testar scripts de cor antes do trabalho de pintura definitivo.

Execução local e por nós

Tudo roda na sua máquina. Há um app Gradio para testes rápidos, um caminho de linha de comando para lotes, um wrapper de ComfyUI e versões da comunidade para Windows e Colab. Um checkpoint fp16 podado derruba a memória para cerca de 12 GB, o que coloca a ferramenta ao alcance de uma placa de consumidor.

Prós e contras

Prós

  • Pesos e código gratuitos, sem conta, sem créditos e sem cobrança por renderização.
  • Lida com movimento exagerado, oclusões e giros amplos que quebram a interpolação de vídeo comum.
  • A guia por esboço dá controle quadro a quadro sobre para onde o personagem vai.
  • Roda em uma GPU só, e a versão fp16 da comunidade baixa o requisito para uns 12 GB.
  • Encaixa no ComfyUI, então convive com upscalers e outros nós de IA no mesmo grafo.

Contras

  • Teto de 16 quadros e 512x320 por execução, então cenas longas exigem várias passadas emendadas.
  • A versão oficial pede cerca de 24 GB de VRAM, e um clipe leva por volta de 24 segundos numa A100 com 50 passos.
  • Não existe API oficial nem serviço hospedado. Sites pagos que usam o nome não são dos autores, e o repositório avisa sobre isso.
  • A qualidade depende de as duas entradas combinarem em estilo e enquadramento. Imagens diferentes geram traços que derivam e transições aleatórias.

Perguntas frequentes

Ele gera os quadros que ficam entre dois desenhos-chave de animação, tarefa que o meio chama de intercalação. Também colore line art e produz testes de movimento curtos. A saída é um clipe breve, não uma cena completa.