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

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

Source: https://nodaro.ai/he/docs/nodes/video/edit-3d-scene

רכיב **עריכת סצנת תלת־ממד** יוצר גרסה חדשה של סצנת תלת־ממד קיימת. מתארים את השינוי במילים פשוטות, למשל "Move the pillar back one meter and keep the suitcase path unchanged" (הזז את העמוד מטר אחורה והשאר את המסלול של המזוודה ללא שינוי). מודל AI מבצע את השינוי, והאובייקטים שנעלתם נשארים בדיוק כמו שהם. חברו סצנה מרכיב [יצירת סצנת תלת־ממד](https://nodaro.ai/docs/nodes/video/generate-3d-scene) לקלט **סצנה** של הרכיב, וייצאו את התוצאה בעזרת רכיב [רינדור וידאו](https://nodaro.ai/docs/nodes/video/render-video).

- Found in: Video › Titles, Graphics & Captions
- Output: data
- API type: `edit-3d-scene`

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

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

## התחלה מהירה
### הוספת הרכיב
הקישו Tab על הקנבס ובחרו **וידאו › כותרות, גרפיקה וכתוביות › עריכת סצנת תלת־ממד**.

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

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

### כתיבת השינוי והרצה
תחת **הוראת עריכה**, תארו את השינוי, למשל `Move the camera lower and push the back wall two metres further away` (הנמך את המצלמה והרחק את הקיר האחורי בשני מטרים). לחצו על **הרצה**. הגרסה החדשה מופיעה בתצוגה המקדימה.

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

- יצירת סצנת תלת־ממד → עריכת סצנת תלת־ממד (סצנה)
- עריכת סצנת תלת־ממד → רינדור וידאו (קומפוזיציה)

## קלטים
| קלט | מקבל | מה הוא עושה |
| --- | --- | --- |
| **סצנה** | הפלט **קומפוזיציה** של הרכיבים יצירת סצנת תלת־ממד, עריכת סצנת תלת־ממד או רינדור תלת־ממד Pro | הסצנה שמשנים. נדרש. |
| **ייחוסים** | רכיבי תמונה ווידאו | אופציונלי. עוד הכוונה לשינוי: מראה, פריסה או תנועה. כל הייחוסים יחד כפופים למגבלות של רכיב יצירת סצנת תלת־ממד: עד 8 ייחוסים, ומתוכם סרטון אחד לכל היותר. |

הפלט, **קומפוזיציה**, הוא הגרסה החדשה. חברו אותו לרכיב [רינדור וידאו](https://nodaro.ai/docs/nodes/video/render-video), או לרכיב עריכת סצנת תלת־ממד נוסף.

## הגדרות
| הגדרה | מה היא עושה |
| --- | --- |
| **מנוע יצירה** | מוצג רק כשההתקנה שלכם מציעה מנוע מתקדם. סצנה שנוצרה במנוע מתקדם נערכת באותו מנוע: האפשרות **בסיסי** מושבתת עבורה. |
| **מודל AI** | מודל השפה שמבצע את ההוראה. ברירת המחדל היא **Claude Sonnet 5.5**. הקריאה מחויבת לפי הטוקנים שהיא השתמשה בהם, בתעריף של המודל. |
| **מאמץ חשיבה** | מוצג במודלים שתומכים בחשיבה. לרמה אין מחיר משלה: ברמה גבוהה יותר המודל כותב בדרך כלל יותר טוקנים, ומשלמים על הטוקנים האלה. |
| **הוראת עריכה** | השינוי, במילים פשוטות. |
| **ייחוסים** | תפקיד אחד לכל ייחוס מחובר: **מראה**, **פריסה** או **תנועה**. |
| **טקסט לפני ואחרי** | טקסט שמתווסף לפני ההוראה ואחריה בזמן ההרצה. ראו את הדף [טקסט לפני ואחרי הפרומפט](https://nodaro.ai/docs/concepts/prompt-pre-post-text). |

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

## שתי דרכים לעריכה
| | הוראת עריכה | עריכות ישירות |
| --- | --- | --- |
| **איך** | כותבים את השינוי ולוחצים על **הרצה** | משנים ערכים בתצוגה המקדימה, או שולחים פעולות עריכה דרך ה-API |
| **מודל AI** | כן, המודל שבחרתם | לא |
| **קרדיטים** | הטוקנים שהמודל השתמש בהם, בתעריף שלו, ב-Nodaro Cloud | לא עולות כלום |
| **תוצאה** | גרסה חדשה | גרסה חדשה |

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

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

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

קובץ MP4 הוא לא סצנה שאפשר לערוך. כדי לעבוד מסרטון, חברו אותו כייחוס לרכיב [יצירת סצנת תלת־ממד](https://nodaro.ai/docs/nodes/video/generate-3d-scene) וערכו את הסצנה שהרכיב בונה.

## קרדיטים
| פעולה | קרדיטים ב-Nodaro Cloud |
| --- | --- |
| עריכות ישירות ופעולות עריכה של ה-API | לא עולות כלום |
| הוראת עריכה | הטוקנים שמודל ה-AI השתמש בהם, בתעריף של המודל. הכפתור **הרצה** מציג אומדן (`≈` ומספר) של עריכה טיפוסית. |
| ייחוס וידאו | המחיר של רכיב [ניתוח וידאו](https://nodaro.ai/docs/nodes/video/video-analysis#credits) לאותו סרטון |
| רינדור הגרסה החדשה ברכיב רינדור וידאו | 55 עד 1920 פיקסלים בצד הארוך, 83 עד 5.12 מגה־פיקסלים, 138 מעבר לזה |

הוראת עריכה מתומחרת כמו בניית סצנה ברכיב [יצירת סצנת תלת־ממד](https://nodaro.ai/docs/nodes/video/generate-3d-scene#credits). הכללים המלאים מפורטים בסעיף [איך מחויבות קריאות LLM](https://nodaro.ai/docs/concepts/credits#llm-calls). הרינדור הוא תמיד שלב נפרד. ראו את הסעיף [כמה עולה רינדור של סצנת תלת־ממד](https://nodaro.ai/docs/nodes/video/render-video#what-a-3d-scene-render-costs) בדף רינדור וידאו. במהדורות Community ו-Business אין חיוב בקרדיטים.

## טיפים
- **נעלו לפני שאתם נותנים הוראה.** אובייקט נעול חייב לחזור ללא שינוי, ו-Nodaro בודק זאת אחרי שהמודל עונה.
- **השתמשו בעריכה ישירה לערכים מדויקים.** כשאתם יודעים את המספר, כגון גובה של מצלמה או מיקום של אובייקט, הקלידו אותו בתצוגה המקדימה. העריכה מיידית ולא עולה כלום.
- **השוו לפני הרינדור.** הגרסאות הקודמות נשארות ברשימת הגרסאות, כך שאפשר להשוות ביניהן ולשחזר אחת מהן לפני הייצוא.
- **קצצו קודם את ייחוסי הווידאו.** ייחוס וידאו משמש במלואו, כקליפ שלם. השתמשו ברכיב [קיצוץ וידאו](https://nodaro.ai/docs/nodes/video/trim-video) כדי להשאיר רק את החלק שאתם צריכים.

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

| פעולה | שדות |
| --- | --- |
| `set-object` | `objectId`, `changes` (כל שדה של האובייקט חוץ מהמזהה) |
| `add-object` | `object` |
| `remove-object` | `objectId` |
| `set-camera` | `changes` |
| `set-lighting` | `changes` |
| `set-background` | `color` |

```typescript
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` עם הרשימה המלאה כדי להחליף את כולם, או עם רשימה ריקה כדי להסיר את כולם.
- **מנועים מתקדמים.** סצנה שנוצרה במנוע מתקדם נערכת באותו מנוע, ובקשה למנוע הבסיסי נדחית. עריכה בהוראה במנוע מתקדם מדווחת על אותם פרטים כמו סצנה חדשה, כולל תוצאות שנמסרו בלי אישור של הבדיקה החזותית וטיוטות שנשמרו מהרצות שנכשלו. ראו את הסעיף [מה קורה כשהרצה לא עוברת](https://nodaro.ai/docs/nodes/video/pro-3d-render#what-happens-when-a-run-does-not-pass) בדף רינדור תלת־ממד Pro.

עוזרי AI משתמשים בכלי ה-MCP `edit_3d_scene`, עם `locked_object_ids` לנעילות. ראו את הדף [סצנות תלת־ממד דרך MCP](https://nodaro.ai/docs/mcp/3d-scenes).

## שאלות נפוצות

### האם עריכה של סצנת תלת־ממד עולה קרדיטים?

עריכות ישירות של סצנת תלת־ממד בתצוגה המקדימה ופעולות העריכה של ה-API לא עולות קרדיטים, כי שום מודל לא רץ. הוראת עריכה פונה למודל ה-AI. ב-Nodaro Cloud הקריאה מחויבת לפי הטוקנים שהיא השתמשה בהם, בתעריף של המודל.

### איך שומרים על אובייקט בדיוק כמו שהוא?

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

### האם אפשר לערוך קובץ MP4 ברכיב עריכת סצנת תלת־ממד?

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

### האם אפשר לחזור לגרסה קודמת של הסצנה?

כן. כל עריכה של סצנת תלת־ממד יוצרת גרסה חדשה ושומרת את הישנה. בחרו גרסה כלשהי ברשימת הגרסאות כדי להפוך אותה שוב לפעילה.

### מה קורה אם עריכה של המודל מסתיימת אחרי ששיניתי את הסצנה ידנית?

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