O fluxo de trabalho Imagem para 3D transforma uma imagem de referência em uma cena 3D Gaussian Splat leve, renderiza um vídeo orbital e exporta um arquivo 3D para uso posterior. Começa com LoadImage para importar a imagem, depois passa para um nó estimador 3D de imagem única (b64333d5-4e6f-4e99-9506-2ec4f63259fe), que prevê uma representação 3D de pontos/splats a partir da foto. CreateCameraInfo constrói um caminho de câmera orbital (raio, elevação e número de quadros), e RenderSplat renderiza a sequência ao longo desse caminho. CreateVideo monta os quadros e SaveVideo salva o vídeo orbital no disco.
Para exportação 3D, a cena splat pode seguir dois caminhos: SplatToFile3D salva um arquivo 3D direto (geralmente .obj), enquanto SplatToMesh converte os splats em uma malha triangular adequada para SaveGLB (para .glb). O caminho splat é rápido e fiel à reconstrução, enquanto o caminho mesh aumenta a compatibilidade com ferramentas DCC e engines de jogos. Por ser uma reconstrução experimental de imagem única, funciona melhor com fotos centralizadas no objeto e fundo limpo—regiões ocultas ou não vistas são inferidas de forma plausível e podem precisar de ajustes em seu software 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 this workflow (TypeScript)
import { Comfy } from "@comfyorg/sdk";
const client = new Comfy({ apiKey: "comfyui-..." });
const wf = await client.workflows.fromFile("workflow_api.json");
const job = await client.run(wf);
await job.getOutputs("<output-node-id>")[0].toFile("output.png");O 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
