
O fluxo 'HY 3D: Imagem para Modelo' no ComfyUI é uma ferramenta poderosa para converter imagens 2D em modelos 3D detalhados, completos com geometria e texturas PBR (Physically Based Rendering). Este fluxo utiliza o modelo Hunyuan3D, conhecido por sua capacidade avançada de interpretar dados de imagem e gerar representações 3D precisas. O processo começa com o nó LoadImage, permitindo que o usuário faça upload da imagem desejada. A transformação principal é realizada pelo TencentImageToModelNode, que processa os dados da imagem e constrói o modelo 3D. Este nó utiliza algoritmos sofisticados para garantir que o modelo resultante mantenha alta fidelidade aos traços da imagem original.
Após a geração do modelo, o nó SaveGLB é usado para exportar o modelo no formato GLB, amplamente suportado para ativos 3D e que garante fácil integração em diversas aplicações. O nó Preview3D oferece visualização em tempo real do modelo, permitindo inspecionar geometria e texturas antes de finalizar a saída. Este fluxo é especialmente útil para artistas e desenvolvedores que desejam prototipar rapidamente ativos 3D a partir de designs 2D, oferecendo uma transição fluida do conceito ao modelo 3D.
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: Imagem para Modelo" (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("api_hunyuan3d_image_to_model_api.json");
const asset = client.assets.fromFile("input.png");
wf.setInput("1", "image", asset); // LoadImage
const job = await client.run(wf);
await job.getOutputs("14")[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













