Visão Geral
A integração Meshy ComfyUI permite chamar a geração 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 nodes personalizados Meshy pelo ComfyUI Manager (pesquise por "Meshy") ou clone o repositório de nodes na pasta custom_nodes do seu ComfyUI e reinicie o ComfyUI para carregar os novos nodes.
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 node Meshy ou defina-a como uma variável de ambiente, dependendo de como o pacote de nodes está configurado. Mantenha essa chave privada — ela está vinculada ao saldo de créditos da sua conta.
Nodes Disponíveis
Node Text to 3D — gera um modelo a partir de um prompt de texto
Node Image to 3D — gera um modelo a partir de uma única imagem de referência
Node Multi-Image to 3D — gera um modelo a partir de várias imagens de referência do mesmo objeto
Cada node 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 node falhará se o saldo da sua conta não cobrir o custo da geração
Tempos limite — gerações longas podem exceder o tempo limite padrão do node do ComfyUI; verifique o status da tarefa pela API se um node parecer travado
Créditos e Formatos de Saída
As gerações executadas pelo 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 node.
FAQ
1. As gerações do ComfyUI usam os mesmos créditos que o aplicativo web?
Sim, elas usam o mesmo saldo de créditos da conta.
2. Por que meu node diz "não autorizado"?
Sua chave de API provavelmente está ausente, expirada ou inserida incorretamente — regenere-a nas configurações da sua conta e cole-a novamente no node.
3. Posso encadear nodes do Meshy com outros nodes do ComfyUI?
Sim, as saídas dos nodes do Meshy podem ser passadas para nodes padrão do ComfyUI que aceitam ativos 3D ou de imagem, dependendo da implementação do pacote de nodes.