רינדור תלת־ממד Pro

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

רכיב רינדור תלת־ממד Pro רץ רק ב-Nodaro Cloud, ורק כל עוד מנוע התלת־ממד של Nodaro Cloud מציע אותו. המהדורות באירוח עצמי לא מציעות את הרכיב הזה.

מתי להשתמש

• אתם רוצים שוט תלת־ממד מוגמר מתיאור בצעד אחד, ולא הדמיה מוקדמת שתצטרכו לרנדר אחר כך.
• אתם רוצים לייצא שוב סצנה קיימת, בלי לשלם שוב על היצירה שלה.
• אתם רוצים תמונת סטילס אחת לכל שוט, כדי להשתמש בה כתמונת ייחוס ביצירות מאוחרות יותר.
• אתם רוצים יחס גובה־רוחב רחב של 21:9, שרכיב יצירת סצנת תלת־ממד לא מציע.

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

• תפריט הוספת רכיב. ב-Nodaro Cloud, הרכיב נמצא תחת וידאו › כותרות, גרפיקה וכתוביות › רינדור תלת־ממד Pro כל עוד מנוע התלת־ממד מציע אותו. כשהמנוע לא זמין, הרכיב לא מופיע ברשימה בכלל, במקום להופיע כמושבת.
• API ו-SDK. הנתיב GET /v1/3d-scene/capabilities מדווח על pro.available. בהתקנות שבהן הרכיב לא זמין, הנתיב GET /v1/nodes לא כולל אותו, ובקשה נדחית עם 503 SCENE_CAPABILITY_UNAVAILABLE. הבקשה לעולם לא עוברת למנוע הבסיסי כחלופה.
• MCP. הכלי pro_3d_render מופיע ברשימה רק בהתקנות שבהן הרכיב יכול לרוץ, ולכן הנוכחות שלו ברשימת הכלים היא הבדיקה.

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

התחלה מהירה

מקור הסצנה

לכל הרצה יש מקור אחד בדיוק, והמקור קובע גם מה קורה וגם על מה משלמים.

כשהשדה הוראת עריכה (אופציונלי) ריק, ההרצה היא רינדור בלבד. דרך ה-API, כדי לקבל ייצוא פשוט, השמיטו את השדה editPrompt: מחרוזת ריקה היא בקשה אחרת.

מקור רביעי, ייצוא מוגמר מ-Blender במחשב שולחני מקושר, זמין דרך ה-API בהתקנות שתומכות בכך.

קלטים

פלטים

חברו רכיבי וידאו לפלט וידאו, לא לפלט קומפוזיציה: הקומפוזיציה היא סצנה, לא סרטון.

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

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

הגדרות

אין הגדרה של מודל או של חשיבה: המתכנן קבוע, ו-Nodaro מריץ אותו. הסגנון הוא חימר.

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

שימוש בתוצאה כייחוס וידאו

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

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

קרדיטים

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

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

מלבד מעברי התיקון, האומדן יכול לכלול שתי מכסות:

גודל הפריים והאורך. שלב הרינדור מתומחר לפי מספר הפריימים בפלט, ולכן סצנה ארוכה יותר או קצב פריימים גבוה יותר עולים יותר. המחיר לפריים נקבע לפי אותו סולם מחירים לפי גודל הפריים כמו ברכיב רינדור וידאו. פריימים של עד 1920 פיקסלים בצד הארוך מתומחרים בתעריף הבסיסי. פריימים גדולים יותר עולים פי 1.5 מהתעריף הבסיסי עד 5.12 מגה־פיקסלים, ופי 2.5 מעל זה.

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

מה קורה כשהרצה לא עוברת

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

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

כשהרצה נכשלת אבל שומרת את הטיוטה שלה, אין MP4, אבל הטיוטה היא גרסה רגילה של הסצנה:

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

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

שגיאות תכנון

טיפים

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

דרך ה-API

ה-API משתמש בשתי קריאות למשימה אחת בתשלום. הנתיב POST /v1/pro-3d-render/quote מקבל את הבקשה ומחזיר quoteId ו-maxCredits, שהוא התקרה. בשלב אומדן המחיר לא משוריינים ולא נגבים קרדיטים. אחר כך הנתיב POST /v1/pro-3d-render מקבל את אותו גוף בקשה ועוד את ה-quoteId, עם כותרת Idempotency-Key באורך 8–255 תווים, ומחזיר jobId. גוף בקשה ששונה בין שתי הקריאות נדחה, וכך גם אומדן שפג תוקפו. כשאתם שולחים שוב בקשה שנתקלה בפסק זמן, השתמשו שוב באותו Idempotency-Key.

const caps = await client.scene3d.capabilities();
if (!caps.pro?.available) return; // this install cannot run it

// Author a new scene and render it: quotes and runs in one call.
const shot = await client.scene3d.renderProAndWait({
  source: {
    kind: "prompt",
    prompt: "A red suitcase rolls behind a central pillar and reappears. Dolly right over thirty seconds.",
    references: [{ id: "look", kind: "image", role: "appearance", url: appearanceImageUrl }],
  },
  durationSeconds: 30,
  fps: 24,
  aspectRatio: "21:9",
  maxRepairPasses: 2,
});

// Later: render the same revision again, with no authoring charge.
await client.scene3d.renderProAndWait({
  source: { kind: "scene", revisionId: shot.sceneRevisionId, sourceJobId: shotJobId },
});

• משימה שהושלמה כוללת את videoUrl, scenePlan, sceneRevisionId, shotStills ({ shotIndex, frame, assetId, url } אחד לכל שוט), validation ו-metadata עם גודל הפריים, קצב הפריימים, מספר הפריימים ומשך הסרטון.
• מסירה בלי אישור מוסיפה את metadata.review. בדקו את השדה הזה ואת ה-verdict שלו, refused או unavailable, ולא את validation.status, שערכו passed בשני המקרים.
• במשימה שנכשלה עם טיוטה עדיין יש scenePlan, sceneRevisionId ו-validation שה-status שלו הוא failed.
• קצב פריימים. דרך ה-API, השדה fps יכול לקבל כל ערך מ-15 עד 60.

עוזרי AI משתמשים בכלי ה-MCP pro_3d_render, שנותן אומדן מחיר ושולח את הבקשה עם אותם פרמטרים. פירוט של כל שדה, קוד אזהרה ושגיאה נמצא בדף סצנות תלת־ממד דרך MCP ובדף ה-API של סצנות תלת־ממד.