تم تصميم سير عمل HY 3D 2.1 لتحويل صور 2D منفردة إلى نماذج 3D مفصلة باستخدام نموذج Hunyuan3D 2.1 من Tencent. يستفيد سير العمل من سلسلة عُقَد متخصصة لمعالجة صورة وتحويلها إلى شبكة ثلاثية الأبعاد (mesh). تبدأ العملية بعُقَد "ImageOnlyCheckpointLoader" و"LoadImage" لتجهيز الصورة للتحويل ثلاثي الأبعاد. بعد ذلك تطبق عقدة "ModelSamplingAuraFlow" نموذج Hunyuan3D لتوليد تمثيل latent للصورة في فضاء ثلاثي الأبعاد. يتم بعد ذلك تحسين هذه البيانات عبر عقدتَي "EmptyLatentHunyuan3Dv2" و"Hunyuan3Dv2Conditioning" لصقل البنية ثلاثية الأبعاد.
يتابع سير العمل باستخدام عقدة "KSampler" لأخذ عينات من بيانات الـ latent لضمان أن نموذج 3D يكون مفصلًا ودقيقًا قدر الإمكان. تقوم عقدة "VAEDecodeHunyuan3D" بفك ترميز هذه البيانات إلى تمثيل voxels، ثم تُحوَّل إلى mesh باستخدام عقدة "VoxelToMesh". أخيرًا، تقوم عقدة "SaveGLB" بتصدير نموذج 3D بصيغة GLB ليكون جاهزًا للاستخدام في تطبيقات مختلفة. هذا سير العمل مفيد للفنانين والمطورين الذين يريدون إنشاء محتوى 3D من أصول 2D موجودة، مع مسار مبسّط يقلل الحاجة للنمذجة اليدوية.
API
استخدم سير العمل هذا من الكود
كل سير عمل في Comfy هو رسم بياني بصيغة JSON. الحمولة أدناه هي هذا سير العمل بالضبط كما يشغله ComfyUI — يمكنك جلبه من الرابط، حفظه في نظام التحكم بالإصدارات، أو تحميله في ComfyUI وتشغيله عقدة تلو الأخرى.
شغّله من TypeScript أو Python باستخدام Comfy SDK. نفس الكود يعمل على Comfy Cloud أو ComfyUI الذي تستضيفه بنفسك — فقط عنوان URL الأساسي يتغير.
// 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"); // SaveGLBيأخذ SDK سير العمل بصيغة API: افتح هذا سير العمل في ComfyUI واستخدم ملف → تصدير سير العمل (API).
يتطلب الوصول إلى Comfy Cloud API خطة تتضمن مفتاح API.
الأسئلة الشائعة
