# אובייקטים ויצורים

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

Source: https://nodaro.ai/he/docs/mcp/tools/objects-and-creatures

**כלי האובייקטים והיצורים** מאפשרים לעוזר AI להשתמש באביזרים, במוצרים וביצורים שבספרייה שלכם: פריטים ויצורים עם מראה נעול, שנשארים זהים בכל שוט. העוזר מציג אותם ברשימה וקורא אותם, יוצר תמונות ווריאנטים, מאשר תמונות ראשיות ומנפיש קליפי תנועה קצרים. אובייקטים ויצורים עובדים באותו אופן; ליצורים יש גם מין בטקסט חופשי. המדריכים [אובייקטים ואביזרים](https://nodaro.ai/docs/guides/objects) ו[חיות ויצורים](https://nodaro.ai/docs/guides/creatures) מתארים את אותה עבודה באפליקציה.

אובייקטים ויצורים נוצרים באפליקציה. אין כלי 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](https://nodaro.ai/docs/concepts/credits#llm-calls)). האישור אף פעם לא נדחה בגלל קרדיטים. כשהיתרה שלכם נמוכה מדי לתיאור, התמונה בכל זאת מאושרת, והתיאור לא נכתב. הריצו אחר כך את `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](https://nodaro.ai/docs/concepts/credits#llm-calls)). האישור אף פעם לא נדחה בגלל קרדיטים. כשהיתרה שלכם נמוכה מדי לתיאור, התמונה בכל זאת מאושרת, והתיאור לא נכתב. הריצו אחר כך את `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.

### מה ההבדל בין אובייקט ליצור?

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