סצנות תלת־ממד

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

הכלים

כל כלי דורש את ההרשאה workflows:execute ומחזיר מזהה משימה; קבלו את התוצאה עם get_job או wait_for_job. משימה של סצנה מחזירה output_data.scenePlan, ורינדור מחזיר כתובת של סרטון. הפרמטרים נמצאים במדריך הכלים.

מחזור העבודה

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

מה הגרסה הראשונה יודעת לעשות

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

מנועים

הכלים generate_3d_scene ו-edit_3d_scene מקבלים engine: basic (ברירת המחדל), blender-cloud או blender-local. מנוע מתקדם חייב להיות זמין בפריסה; בקשה למנוע שלא זמין נדחית, ולעולם לא עוברת ל-basic כחלופה. המנועים המתקדמים משתמשים במתכנן קבוע, ולכן אל תעבירו איתם llm_model ו-reasoning_effort, וקבעו את תקציב התיקונים שלהם עם max_repair_passes.

עם מנוע מתקדם שיודע לייבא אותם, generate_3d_scene מקבל גם input_assets: עד 8 מודלי תלת־ממד קיימים בפורמט GLB, כל אחד בצורה { id, revisionId, assetId, label }. השאירו תמונות וסרטונים ב-references. כשהמנוע לא יודע לייבא, ייבוא נדחה לפני כל חיוב, והשרת טוען את הקבצים בעצמו, ולכן לעולם אל תשלחו כתובות או גיבובים.

כמה עולה רינדור

המחיר של רינדור נקבע לפי גודל הפריים בתוכנית שאתם מעבירים:

הגדירו במודע את width ואת height בתוכנית הסצנה: סצנה של 2560 × 2560 עולה פי 2.5 מסצנה של 1920 × 1080, ואילו 1920 × 1920 עולה כמו 1920 × 1080. הטבלה המלאה נמצאת בדף של רכיב רינדור וידאו.

קריאת התוצאה של מנוע מתקדם

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

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

כשסצנה שהושלמה לא אושרה

משימה שהושלמה יכולה לכלול metadata.review, ופירוש הדבר שהסצנה נמסרה בלי אישור של הבדיקה החזותית. בדקו אם metadata.review קיים, ולא את הסטטוס או את מספר האזהרות, וקראו את ה-verdict שלו לפני שאתם אומרים למשתמש משהו:

• refused: תקציב התיקונים נגמר, כל בדיקות החובה עברו, והבדיקה החזותית עדיין הסתייגה. הסצנה מגיעה עם ההסתייגויות ועם אזהרת SCENE_REVIEW_REFUSED אחת לכל הסתייגות.
• unavailable: הבדיקה החזותית לא נתנה הכרעה שאפשר להשתמש בה במספר הניסיונות שב-attempts. הערך של reason הוא provider כשהבדיקה בכלל לא הגיעה למודל שלה, ו-unusable כשאי אפשר היה להשתמש בתשובה. אף אחד לא שפט את הסצנה, ו-validation.warnings[] מתחיל ב-SCENE_REVIEW_UNAVAILABLE. אל תדווחו על הסתייגות של הבדיקה כשאף אחד לא בדק את הסצנה.

בשני המקרים הערך של validation.status הוא עדיין passed, ורשימת ההסתייגויות יכולה להיות ריקה.

כשמשימה במנוע מתקדם נכשלה

משימה שנכשלה עם SCENE_QUALITY_FAILED מיצתה את התקציב שלה בלי סצנה שהמנוע יכול לעמוד מאחוריה. בדקו את ה-output_data שלה לפני שאתם מריצים אותה שוב:

• נבנתה טיוטה. המשימה שנכשלה מפנה אליה עם scenePlan, sceneRevisionId, deliveryId ו-posterAssetId, ו-validation.status הוא failed. הטיוטה היא גרסה רגילה: העבירו אותה ל-edit_3d_scene או ל-render_3d_scene.
• שום דבר לא עבר הידור. אין scenePlan, אבל למשימה עדיין יש deliveryId, ו-validation.sourceRetained מציין אם המתכון נשמר. שלפו את המסירה מה-REST API עם GET /v1/3d-scene/deliveries/{deliveryId}, ואז את הקובץ source-json שלה. הקריאה לא עולה קרדיטים, והיא דורשת את פרטי הגישה שלכם עצמכם והרשאת עריכה לתהליך של המשימה; אין לכך כלי MCP.

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

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

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

הפלט כולל גם shotStills, תמונת סטילס אחת לכל שוט בקומפוזיציה, לפי סדר השוטים: { shotIndex, frame, assetId, url }. השדה shotIndex נספר מ-0, והשדה frame הוא הפריים הראשון של השוט, כך שכל תמונת סטילס מתאימה למקום שלה ב-MP4. בסצנה עם שוט אחד יש בדיוק תמונת סטילס אחת, בפריים 0. התמונות מגיעות מאותה הרצה, בלי עלות נוספת. השתמשו בתמונת הסטילס של שוט כתמונת ייחוס כשאתם יוצרים את השוט הזה במודל וידאו.

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

לחלופה הזולה יותר, הדמיה מוקדמת מחימר שאפשר לערוך אותה, השתמשו ב-generate_3d_scene, ב-edit_3d_scene וב-render_3d_scene. לפורמט המדויק של הסצנה ולערכי ברירת המחדל הנוכחיים, בקשו מהעוזר לקרוא ל-get_node_skill עם generate-3d-scene או edit-3d-scene.