Visão geral
A integração do Meshy com o ComfyUI permite chamar as gerações de Text to 3D, Image to 3D e Multi-Image to 3D do Meshy diretamente de um fluxo de trabalho do ComfyUI usando sua chave de API do Meshy.
Instalação
Instale o pacote de nós personalizados do Meshy por meio do ComfyUI Manager (pesquise por "Meshy") ou clone o repositório de nós na pasta custom_nodes do seu ComfyUI e reinicie o ComfyUI para carregar os novos nós.
Adicionando sua chave de API
Gere uma chave de API nas configurações da sua conta Meshy e cole-a no campo de chave de API do nó do Meshy ou defina-a como uma variável de ambiente, dependendo de como o pacote de nós está configurado. Mantenha essa chave em segredo — ela está vinculada ao saldo de créditos da sua conta.
Nós disponíveis
Nó Text to 3D — gera um modelo a partir de um prompt de texto
Nó Image to 3D — gera um modelo a partir de uma única imagem de referência
Nó Multi-Image to 3D — gera um modelo a partir de várias imagens de referência do mesmo objeto
Cada nó expõe os mesmos parâmetros principais de geração disponíveis no aplicativo web e na API do Meshy.
Erros comuns
Erros de autenticação — geralmente uma chave de API inválida ou ausente; regenere a chave se necessário
Créditos insuficientes — o nó falhará se o saldo da sua conta não puder cobrir o custo da geração
Tempos limite esgotados — gerações longas podem exceder o tempo limite padrão dos nós do ComfyUI; verifique o status da tarefa pela API se um nó parecer travado
Créditos e formatos de saída
As gerações executadas por meio do ComfyUI consomem créditos da sua conta Meshy exatamente como fariam pelo aplicativo web ou pela API. Os modelos de saída normalmente podem ser salvos nos mesmos formatos suportados pela API do Meshy (como GLB, FBX e OBJ), dependendo das opções de exportação do nó.
FAQ
1. As gerações do ComfyUI usam os mesmos créditos do aplicativo web?
Sim, elas são debitadas do mesmo saldo de créditos da conta.
2. Por que meu nó exibe "unauthorized" (não autorizado)?
Sua chave de API provavelmente está ausente, expirada ou foi inserida incorretamente — regenere-a nas configurações da sua conta e cole-a novamente no nó.
3. Posso encadear nós do Meshy com outros nós do ComfyUI?
Sim, as saídas dos nós do Meshy podem ser passadas para nós padrão do ComfyUI que aceitam ativos 3D ou de imagem, dependendo da implementação do pacote de nós.