עריכת סצנת תלת־ממד

רכיב עריכת סצנת תלת־ממד יוצר גרסה חדשה של סצנת תלת־ממד קיימת. מתארים את השינוי במילים פשוטות, למשל "Move the pillar back one meter and keep the suitcase path unchanged" (הזז את העמוד מטר אחורה והשאר את המסלול של המזוודה ללא שינוי). מודל AI מבצע את השינוי, והאובייקטים שנעלתם נשארים בדיוק כמו שהם. חברו סצנה מרכיב יצירת סצנת תלת־ממד לקלט סצנה של הרכיב, וייצאו את התוצאה בעזרת רכיב רינדור וידאו.

מתי להשתמש

• ההעמדה כמעט נכונה, ואתם רוצים לשנות את המצלמה, אובייקט אחד או את התזמון בלי להתחיל מחדש.
• אתם רוצים לנסות וריאציות של סצנה אחת ולשמור את כל הגרסאות.
• אתם רוצים להוסיף תמונות ייחוס או סרטון כדי לכוון את השינוי.

איפה הרכיב זמין

רכיב עריכת סצנת תלת־ממד נמצא בתפריט הוספת רכיב בכל מהדורה, תחת וידאו › כותרות, גרפיקה וכתוביות. קוד ועוזרי AI יכולים להריץ אותו דרך ה-API, דרך ה-SDK ודרך כלי ה-MCP edit_3d_scene.

התחלה מהירה

קלטים

הפלט, קומפוזיציה, הוא הגרסה החדשה. חברו אותו לרכיב רינדור וידאו, או לרכיב עריכת סצנת תלת־ממד נוסף.

הגדרות

מתחת להוראה, החלונית מציינת כמה אובייקטים נעולים. הנעילות נבדקות אחרי שהמודל עונה: כל אובייקט נעול חייב לחזור ללא שינוי.

שתי דרכים לעריכה

עריכות ישירות בתצוגה המקדימה חלות על הפריים שאתם רואים. בערוץ מונפש, שינוי מעדכן או מוסיף פריים מפתח בפריים הנוכחי. בערוץ שלא מונפש, שינוי מזיז את האובייקט בכל הפריימים.

כל עריכה נבדקת מול הסצנה כולה: מזהי האובייקטים, ההיררכיה של האובייקטים ופריימי האנימציה. עריכה אף פעם לא משאירה מצביע לאובייקט אב, או כל מצביע אחר, למשהו שלא קיים. הסצנה שממנה התחלתם נשארת ללא שינוי, והגרסה החדשה רושמת אותה כגרסת האב שלה.

גרסאות

• שום דבר לא נדרס. כל עריכה יוצרת גרסה חדשה. הגרסאות הקודמות נשמרות ברשימת הגרסאות, כך שאפשר להשוות ביניהן או לשחזר אחת מהן.
• העריכות שלכם גוברות. אם עריכה של המודל מסתיימת אחרי ששיניתם את הסצנה ידנית, השינויים שלכם נשארים פעילים. הודעה מציעה לבחור בין השתמשו בחדשה לבין השאירו את שלי.
• כל קובץ MP4 מבוסס על גרסה אחת. רכיב רינדור וידאו מייצא את הגרסה שפעילה ברגע שהוא רץ.

קובץ MP4 הוא לא סצנה שאפשר לערוך. כדי לעבוד מסרטון, חברו אותו כייחוס לרכיב יצירת סצנת תלת־ממד וערכו את הסצנה שהרכיב בונה.

קרדיטים

הוראת עריכה מתומחרת כמו בניית סצנה ברכיב יצירת סצנת תלת־ממד. הכללים המלאים מפורטים בסעיף איך מחויבות קריאות LLM. הרינדור הוא תמיד שלב נפרד. ראו את הסעיף כמה עולה רינדור של סצנת תלת־ממד בדף רינדור וידאו. במהדורות Community ו-Business אין חיוב בקרדיטים.

טיפים

• נעלו לפני שאתם נותנים הוראה. אובייקט נעול חייב לחזור ללא שינוי, ו-Nodaro בודק זאת אחרי שהמודל עונה.
• השתמשו בעריכה ישירה לערכים מדויקים. כשאתם יודעים את המספר, כגון גובה של מצלמה או מיקום של אובייקט, הקלידו אותו בתצוגה המקדימה. העריכה מיידית ולא עולה כלום.
• השוו לפני הרינדור. הגרסאות הקודמות נשארות ברשימת הגרסאות, כך שאפשר להשוות ביניהן ולשחזר אחת מהן לפני הייצוא.
• קצצו קודם את ייחוסי הווידאו. ייחוס וידאו משמש במלואו, כקליפ שלם. השתמשו ברכיב קיצוץ וידאו כדי להשאיר רק את החלק שאתם צריכים.

דרך ה-API

הנתיב POST /v1/3d-scene/edit מקבל את scenePlan ואת expectedRevisionId, ובנוסף prompt או רשימה של operations. בקשה שמבוססת על גרסה לא עדכנית נדחית. עריכה שהצליחה מחזירה משימה, וב-output_data.scenePlan שלה נמצאת הגרסה החדשה, יחד עם changeSummary.

const edited = await client.nodes.runAndWait("edit-3d-scene", {
  scenePlan: scene.scenePlan,
  expectedRevisionId: scene.scenePlan.revisionId,
  operations: [{ op: "set-camera", changes: { focalLengthMm: 50 } }],
});

• פעולות משנות בדיוק את השדות שאתם שולחים. כדי לשנות תנוחה שמוגדרת בפריימי מפתח, כללו גם את השינויים בפריימי המפתח שלה.
• נעילות. השדה lockedObjectIds מפרט את האובייקטים שחייבים לחזור ללא שינוי.
• ייחוסים. ייחוסים חדשים מתמזגים עם הקיימים לפי מזהה, וייחוס עם אותו מזהה מחליף את הקיים. שלחו replaceReferences: true עם הרשימה המלאה כדי להחליף את כולם, או עם רשימה ריקה כדי להסיר את כולם.
• מנועים מתקדמים. סצנה שנוצרה במנוע מתקדם נערכת באותו מנוע, ובקשה למנוע הבסיסי נדחית. עריכה בהוראה במנוע מתקדם מדווחת על אותם פרטים כמו סצנה חדשה, כולל תוצאות שנמסרו בלי אישור של הבדיקה החזותית וטיוטות שנשמרו מהרצות שנכשלו. ראו את הסעיף מה קורה כשהרצה לא עוברת בדף רינדור תלת־ממד Pro.

עוזרי AI משתמשים בכלי ה-MCP edit_3d_scene, עם locked_object_ids לנעילות. ראו את הדף סצנות תלת־ממד דרך MCP.