O fluxo de trabalho HY 3D 2.1 foi projetado para transformar imagens 2D em modelos 3D detalhados usando o modelo Hunyuan3D 2.1 da Tencent. O fluxo utiliza uma série de nós especializados para processar a imagem e convertê-la em uma malha 3D. O processo começa com os nós 'ImageOnlyCheckpointLoader' e 'LoadImage', que preparam a imagem para a transformação 3D. O nó 'ModelSamplingAuraFlow' aplica o modelo Hunyuan3D para gerar uma representação latente da imagem no espaço 3D. Esses dados latentes são refinados pelos nós 'EmptyLatentHunyuan3Dv2' e 'Hunyuan3Dv2Conditioning' para aprimorar a estrutura 3D.
O fluxo segue com o nó 'KSampler', que amostra os dados latentes para garantir que o modelo 3D seja o mais detalhado e preciso possível. O nó 'VAEDecodeHunyuan3D' decodifica esses dados em uma representação voxel, que é então convertida em malha pelo nó 'VoxelToMesh'. Por fim, o nó 'SaveGLB' exporta o modelo 3D em formato GLB, pronto para uso em diversas aplicações. Este fluxo é especialmente útil para artistas e desenvolvedores que desejam criar conteúdo 3D a partir de ativos 2D, oferecendo um processo simplificado que minimiza o trabalho manual de modelagem.
API
Use este workflow a partir do código
Todo workflow Comfy é um grafo JSON. O payload abaixo é este workflow, exatamente como o ComfyUI executa — obtenha-o pela URL, mantenha-o no controle de versão ou carregue-o no ComfyUI e execute nó por nó.
Execute a partir de TypeScript ou Python com o Comfy SDK. O mesmo código serve para o Comfy Cloud ou um ComfyUI hospedado por você — apenas a URL base muda.
// Install (beta)
npm i @comfyorg/sdk
// Run "Hunyuan3D 2.1" (TypeScript)
import { Comfy } from "@comfyorg/sdk";
const client = new Comfy({ apiKey: "comfyui-..." });
// This workflow, exported in API format (see note below)
const wf = await client.workflows.fromFile("3d_hunyuan3d-v2.1_api.json");
const asset = client.assets.fromFile("input.png");
wf.setInput("2", "image", asset); // LoadImage
const job = await client.run(wf);
await job.getOutputs("10")[0].toFile("output.png"); // SaveGLBO SDK utiliza um workflow no formato API: abra este workflow no ComfyUI e use Arquivo → Exportar Workflow (API).
O acesso à API do Comfy Cloud requer um plano com chave de API.
FAQ
