يحوّل سير عمل «صورة إلى 3D» صورة مرجعية واحدة إلى مشهد 3D Gaussian Splat خفيف، ثم يعرض فيديو دوران (turntable) ويصدّر ملف 3D لاستخدامه لاحقًا. يبدأ بـ LoadImage لإدخال المصدر، ثم يمرره إلى عقدة تقدير 3D لصورة واحدة (b64333d5-4e6f-4e99-9506-2ec4f63259fe) التي تتنبأ بتمثيل نقاط/سْبلات ثلاثي الأبعاد من الصورة. تبني CreateCameraInfo مسار كاميرا دوران (نصف القطر، الارتفاع، وعدد الإطارات)، وتقوم RenderSplat بعرض التسلسل على طول هذا المسار. تجمع CreateVideo الإطارات وتكتب SaveVideo مقطع الدوران النهائي على القرص.
للتصدير ثلاثي الأبعاد، يمكن أن يسلك مشهد السبلات طريقين: تقوم SplatToFile3D بحفظ ملف 3D مباشر (غالبًا .obj)، بينما تحول SplatToMesh السبلات إلى شبكة مثلثات مناسبة لـ SaveGLB (لـ .glb). مسار السبلات سريع ويحافظ على إعادة البناء، بينما يزيد مسار الشبكة من التوافق مع أدوات DCC ومحركات الألعاب. وبما أن هذا إعادة بناء تجريبية من صورة واحدة، فهو يعمل أفضل مع صور لأجسام في الوسط وخلفيات نظيفة—المناطق المحجوبة أو غير المرئية يُستدل عليها بشكل تقريبي وقد تحتاج تنظيفًا في أداة 3D التي تفضلها.
API
استخدم سير العمل هذا من الكود
كل سير عمل في Comfy هو رسم بياني بصيغة JSON. الحمولة أدناه هي هذا سير العمل بالضبط كما يشغله ComfyUI — يمكنك جلبه من الرابط، حفظه في نظام التحكم بالإصدارات، أو تحميله في ComfyUI وتشغيله عقدة تلو الأخرى.
شغّله من TypeScript أو Python باستخدام Comfy SDK. نفس الكود يعمل على Comfy Cloud أو ComfyUI الذي تستضيفه بنفسك — فقط عنوان URL الأساسي يتغير.
// 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");يأخذ SDK سير العمل بصيغة API: افتح هذا سير العمل في ComfyUI واستخدم ملف → تصدير سير العمل (API).
يتطلب الوصول إلى Comfy Cloud API خطة تتضمن مفتاح API.
الأسئلة الشائعة
