תיעוד Nodaroאובייקטים ויצורים
דרך עוזר AI: הציגו וקראו את האובייקטים והיצורים השמורים שלכם, צרו תמונות ווריאנטים, אשרו תמונות ראשיות והנפישו קליפי סיבוב ותנועה במנוחה.
כלי האובייקטים והיצורים מאפשרים לעוזר AI להשתמש באביזרים, במוצרים וביצורים שבספרייה שלכם: פריטים ויצורים עם מראה נעול, שנשארים זהים בכל שוט. העוזר מציג אותם ברשימה וקורא אותם, יוצר תמונות ווריאנטים, מאשר תמונות ראשיות ומנפיש קליפי תנועה קצרים. אובייקטים ויצורים עובדים באותו אופן; ליצורים יש גם מין בטקסט חופשי. המדריכים אובייקטים ואביזרים וחיות ויצורים מתארים את אותה עבודה באפליקציה.
אובייקטים ויצורים נוצרים באפליקציה. אין כלי MCP שיוצר אותם.
כלי אובייקטים
list_objects
מחזיר את האובייקטים שלכם: אביזרים, אקססוריז ופריטים פיזיים שאתם משתמשים בהם שוב ושוב בשוטים שונים. בכל שורה מופיעים השם, התיאור, התמונה הראשית ומספר הווריאנטים. הסדר הוא מהחדש לישן.
הרשאה: assets:read. קרדיטים: חינם.
| פרמטר | סוג | הערות |
|---|---|---|
search | string | עד 5 מילים ועד 200 תווים. כל מילה חייבת להופיע בשם האובייקט או בתיאור שלו, בלי הבדל בין אותיות גדולות לקטנות. ערך ריק פירושו שאין חיפוש. כדאי להשתמש בו כשמבקשים אובייקט בשמו. |
limit | integer | מ-1 עד 100. ברירת המחדל: 50. |
מה חוזר: האובייקטים. לכתובות של הווריאנטים, קראו ל-get_object.
get_object
מחזיר אובייקט אחד במלואו: כל וריאנט עם השם והכתובת שלו, ותמונות הייחוס.
הרשאה: assets:read. קרדיטים: חינם.
| פרמטר | סוג | הערות |
|---|---|---|
id | string | נדרש. מזהה האובייקט מ-list_objects. |
מה חוזר: האובייקט. כשהוא לא קיים או לא שייך לכם, חוזרת שגיאה.
generate_object
יוצר תמונה של אובייקט (kind: "main") או וריאנט של האובייקט (kind: "asset"). התוצאה לא נשמרת באובייקט.
הרשאה: workflows:execute. קרדיטים: המחיר של מודל התמונה.
| פרמטר | סוג | הערות |
|---|---|---|
name | string | נדרש. שם האובייקט. |
kind | string | main (ברירת המחדל) או asset. |
description, style | string | איך האובייקט נראה. |
category | string | furniture, vehicle, weapon, food, clothing, electronics, nature, tool, animal או other. |
asset_type | string | עבור asset: angles, materials, variations או custom. |
variant | string | עבור asset: למשל front, wood או weathered. |
model | string | מודל התמונה. ברירת המחדל: gpt-image-2. |
source_image_url | string | תמונת מקור. |
מה חוזר: מזהה משימה.
approve_object_main_image
הופך מועמד מוכן לתמונה הראשית של האובייקט, ומבקש ממודל ראייה לתאר בתיאור הקנוני את הצורה, החומר, המצב והייעוד שלו.
הרשאה: assets:write. קרדיטים: קריאה אחת למודל הראייה Claude Sonnet 4.6 לכתיבת התיאור, שמחויבת לפי הטוקנים שהיא השתמשה בהם (איך מחויבות קריאות LLM). האישור אף פעם לא נדחה בגלל קרדיטים. כשהיתרה שלכם נמוכה מדי לתיאור, התמונה בכל זאת מאושרת, והתיאור לא נכתב. הריצו אחר כך את recaption_object כדי לכתוב אותו.
| פרמטר | סוג | הערות |
|---|---|---|
object_id | string | נדרש. האובייקט. |
candidate_job_id | string | נדרש. משימת תמונה שלכם שהושלמה, כמו תוצאה של הכלי generate_object. משימה שנוצרה בשביל אובייקט אחר מחזירה candidate_object_mismatch. |
expected_updated_at | string | ה-updatedAt של האובייקט. כשהאובייקט השתנה מאז, הקריאה מחזירה concurrent_modification עם הערך החדש. |
מה חוזר: כתובת התמונה הראשית והתיאור. כשכתיבת התיאור נכשלת, התמונה בכל זאת נקבעת והתיאור נשאר ריק; הריצו את recaption_object.
recaption_object
מבקש ממודל הראייה לתאר שוב את התמונה הראשית הנוכחית, בתיאור של בין 80 ל-120 מילים בערך, ושומר אותו כתיאור הקנוני.
הרשאה: assets:write. קרדיטים: קריאה אחת למודל הראייה Claude Sonnet 4.6, שמחויבת לפי הטוקנים שהיא השתמשה בהם, כמו התיאור שנכתב באישור.
| פרמטר | סוג | הערות |
|---|---|---|
object_id | string | נדרש. האובייקט. |
מה חוזר: התיאור החדש. כשאין לאובייקט תמונה ראשית, הכלי מחזיר main_image_required, וכשכתיבת התיאור נכשלת, הוא מחזיר caption_failed.
generate_object_motion
הופך אובייקט לקליפ קצר, כגון "slow 360-degree rotation" (סיבוב איטי של 360 מעלות), "object hovering with subtle bob" (האובייקט מרחף עם נדנוד עדין) או "parallax pan from left to right" (פאן פרלקסה משמאל לימין).
הרשאה: workflows:execute. קרדיטים: המחיר של מודל הווידאו. מודל ברירת המחדל, Kling 2.5 Turbo Pro, יוצר קליפ של 5 שניות תמורת 138 קרדיטים.
| פרמטר | סוג | הערות |
|---|---|---|
motion_prompt | string | נדרש. התנועה של האובייקט או של המצלמה, עד 2,000 תווים. |
source_image_url | string | נדרש. הפריים הראשון, בדרך כלל התמונה הראשית המאושרת של האובייקט. |
name | string | נדרש. שם האובייקט, שמשמש כהקשר בפרומפט. |
provider | string | kling-turbo (ברירת המחדל), kling, kling-3.0, minimax, hailuo-2.3, wan-i2v, seedance-2-mini או bytedance-lite. |
aspect_ratio | string | 1:1 (ברירת המחדל, למסגור של מוצר), 3:4, 16:9, 9:16 או 4:3. |
attach_to_object_id | string | שומר את הקליפ בקליפי התנועה של האובייקט. הבעלות על האובייקט נבדקת לפני שמשוריינים קרדיטים. |
attach_name | string | השם של הקליפ השמור. |
refine_from_video_url | string | מעדן קליפ קיים עם פרומפט חדש, מווידאו לווידאו, למשל "same shot but faster rotation" (אותו שוט, אבל עם סיבוב מהיר יותר). |
canonical_description, category, style | string | הקשר נוסף לפרומפט. |
מה חוזר: מזהה משימה. הכרטיס מציג את הקליפ כשהוא מוכן.
כלי יצורים
list_creatures
מחזיר את היצורים שלכם: חיות ויצורים לא אנושיים עם מראה נעול. בכל שורה מופיעים השם, התיאור, התמונה הראשית ומספר הווריאנטים. הסדר הוא מהחדש לישן.
הרשאה: assets:read. קרדיטים: חינם.
| פרמטר | סוג | הערות |
|---|---|---|
search | string | עד 5 מילים ועד 200 תווים. כל מילה חייבת להופיע בשם היצור או בתיאור שלו, בלי הבדל בין אותיות גדולות לקטנות. ערך ריק פירושו שאין חיפוש. |
limit | integer | מ-1 עד 100. ברירת המחדל: 50. |
מה חוזר: היצורים. לכתובות של הווריאנטים, קראו ל-get_creature.
get_creature
מחזיר יצור אחד במלואו: כל וריאנט עם השם והכתובת שלו, תמונות הייחוס והקול השמור שלו.
הרשאה: assets:read. קרדיטים: חינם.
| פרמטר | סוג | הערות |
|---|---|---|
id | string | נדרש. מזהה היצור מ-list_creatures. |
מה חוזר: היצור. כשהוא לא קיים או לא שייך לכם, חוזרת שגיאה.
generate_creature
יוצר תמונה של יצור (kind: "main") או וריאנט של היצור (kind: "asset"). התוצאה לא נשמרת ביצור.
הרשאה: workflows:execute. קרדיטים: המחיר של מודל התמונה.
| פרמטר | סוג | הערות |
|---|---|---|
name | string | נדרש. שם היצור. |
kind | string | main (ברירת המחדל) או asset. |
species | string | טקסט חופשי, כגון dragon, wolf או griffin, עד 200 תווים. |
category | string | טקסט חופשי, כגון mammal, mythical או reptile. |
style | string | טקסט חופשי, כגון realistic, anime, 3d-pixar או illustration. |
description | string | איך היצור נראה. |
asset_type | string | עבור asset: angles, poses, variations או custom. |
variant | string | עבור asset: למשל front, standing או weathered. |
model | string | מודל התמונה. ברירת המחדל: gpt-image-2. |
source_image_url | string | תמונת מקור. |
מה חוזר: מזהה משימה.
approve_creature_main_image
הופך מועמד מוכן לתמונה הראשית של היצור, ומבקש ממודל ראייה לתאר בתיאור הקנוני את המין, האנטומיה, הצבעים והמצב שלו.
הרשאה: assets:write. קרדיטים: קריאה אחת למודל הראייה Claude Sonnet 4.6 לכתיבת התיאור, שמחויבת לפי הטוקנים שהיא השתמשה בהם (איך מחויבות קריאות LLM). האישור אף פעם לא נדחה בגלל קרדיטים. כשהיתרה שלכם נמוכה מדי לתיאור, התמונה בכל זאת מאושרת, והתיאור לא נכתב. הריצו אחר כך את recaption_creature כדי לכתוב אותו.
| פרמטר | סוג | הערות |
|---|---|---|
creature_id | string | נדרש. היצור. |
candidate_job_id | string | נדרש. משימת תמונה שלכם שהושלמה, כמו תוצאה של הכלי generate_creature. משימה שנוצרה בשביל יצור אחר מחזירה candidate_creature_mismatch. |
expected_updated_at | string | ה-updatedAt של היצור. כשהיצור השתנה מאז, הקריאה מחזירה concurrent_modification. |
מה חוזר: כתובת התמונה הראשית והתיאור. כשכתיבת התיאור נכשלת, הריצו את recaption_creature.
recaption_creature
מבקש ממודל הראייה לתאר שוב את התמונה הראשית הנוכחית, בתיאור של בין 80 ל-120 מילים בערך, ושומר אותו כתיאור הקנוני.
הרשאה: assets:write. קרדיטים: קריאה אחת למודל הראייה Claude Sonnet 4.6, שמחויבת לפי הטוקנים שהיא השתמשה בהם, כמו התיאור שנכתב באישור.
| פרמטר | סוג | הערות |
|---|---|---|
creature_id | string | נדרש. היצור. |
מה חוזר: התיאור החדש. כשאין ליצור תמונה ראשית, הכלי מחזיר main_image_required, וכשכתיבת התיאור נכשלת, הוא מחזיר caption_failed.
generate_creature_motion
הופך יצור לקליפ קצר של תנועה במנוחה, כגון "creature breathing with subtle idle sway" (היצור נושם ומתנדנד קלות במקום), התגנבות, נפנוף כנפיים או פאן פרלקסה.
הרשאה: workflows:execute. קרדיטים: המחיר של מודל הווידאו. מודל ברירת המחדל, Kling 2.5 Turbo Pro, יוצר קליפ של 5 שניות תמורת 138 קרדיטים.
| פרמטר | סוג | הערות |
|---|---|---|
motion_prompt | string | נדרש. התנועה של היצור או של המצלמה, עד 2,000 תווים. |
source_image_url | string | נדרש. הפריים הראשון, בדרך כלל התמונה הראשית המאושרת של היצור. |
name | string | נדרש. שם היצור. |
provider | string | kling-turbo (ברירת המחדל), kling, kling-3.0, minimax, hailuo-2.3, wan-i2v, seedance-2-mini או bytedance-lite. |
aspect_ratio | string | 1:1 (ברירת המחדל), 3:4, 16:9, 9:16 או 4:3. |
attach_to_creature_id | string | שומר את הקליפ בקליפי התנועה של היצור. הבעלות על היצור נבדקת לפני שמשוריינים קרדיטים. |
attach_name | string | השם של הקליפ השמור. |
refine_from_video_url | string | מעדן קליפ קיים עם פרומפט חדש, מווידאו לווידאו. |
canonical_description, category, style | string | הקשר נוסף לפרומפט. |
מה חוזר: מזהה משימה. הכרטיס מציג את הקליפ כשהוא מוכן.
שאלות נפוצות
האם עוזר AI יכול ליצור אובייקט או יצור חדש?
עוזר AI לא יכול ליצור אובייקט או יצור כרשומה שמורה: אין כלי שיוצר אובייקטים או יצורים, ולכן יוצרים אותם באפליקציה. אחר כך העוזר יכול להציג אותם ברשימה, לקרוא אותם, ליצור בשבילם תמונות וקליפים ולאשר תמונות ראשיות שנוצרו בשבילם.
למה אישור של תמונה ראשית נכשל עם שגיאת אי־התאמה?
אישור של משימת מועמד שנוצרה בשביל אובייקט אחר או יצור אחר מחזיר את השגיאה candidate_object_mismatch או candidate_creature_mismatch. אפשר לאשר מועמד שלא מקושר לאף רשומה, כמו תוצאה של הכלי generate_object.
אילו קליפי תנועה אפשר ליצור למוצר?
למוצר אפשר ליצור קליפים קצרים, כגון סיבוב איטי של 360 מעלות, ריחוף עם נדנוד עדין או פאן פרלקסה. הכלי generate_object_motion משתמש כברירת מחדל במסגור ריבועי וב-Kling 2.5 Turbo Pro.
מה ההבדל בין אובייקט ליצור?
אובייקט הוא אביזר, מוצר, רכב או פריט פיזי אחר. יצור הוא חיה או יצור אחר שהוא לא אדם, עם מין שכותבים בטקסט חופשי, כגון דרקון או זאב, ועם וריאנטים של תנוחה במקום וריאנטים של חומר.
דפים קשורים
אובייקטים ואביזרים
חיות ויצורים
נכס אובייקט/אביזר
נכס חיה/יצור
דמויות
עודכן לאחרונה
מיקומים
בנו מיקומים ב-Nodaro דרך עוזר AI: צרו ואשרו שוט פותח, הוסיפו וריאנטים של שעות היום, מזג אוויר וזוויות, והפכו את המקום לקליפי אווירה.
רצף שוטים ובמאי וידאו
הפרמטרים של כלי במאי הווידאו ב-MCP של Nodaro, שיוצרים סרטון גרפיקת תנועה עם קריינות בקריאה אחת, ושל כלי רצף השוטים, שמתזמנים חשיפות לקריינות.