# מיקומים

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

Source: https://nodaro.ai/he/docs/mcp/tools/locations

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

מחזור החיים זהה לזה של [כלי הדמויות](https://nodaro.ai/docs/mcp/tools/characters): יצירת המיקום, יצירת תמונה ראשית ואישור שלה, ואז יצירת וריאנטים ותנועה מהתמונה הזו.

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

**הרשאה:** `assets:read`. **קרדיטים:** חינם.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `search` | string | עד 5 מילים ועד 200 תווים. כל מילה חייבת להופיע בשם המיקום או בתיאור שלו, בלי הבדל בין אותיות גדולות לקטנות. ערך ריק פירושו שאין חיפוש. |
| `archived` | boolean | הערך `true` מחזיר במקום זאת את המיקומים שבארכיון. |

**מה חוזר:** המיקומים. לכתובות של התמונות, קראו ל-`get_location`.

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

**הרשאה:** `assets:read`. **קרדיטים:** חינם.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `id` | string | **נדרש.** מזהה המיקום מ-`list_locations`. |

**מה חוזר:** המיקום, כולל `updatedAt` לשימוש ב-`update_location`, והיצירות שעדיין רצות בשבילו. כשהמיקום לא קיים או לא שייך לכם, חוזרת שגיאה.

## `create_location`
יוצר מיקום עם הזהות שלו. למיקום עדיין אין תמונה ראשית: צרו אותה בשלב הבא עם `generate_location`.

**הרשאה:** `assets:write`. **קרדיטים:** חינם.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `name` | string | **נדרש.** שם התצוגה, כגון `Rainy Tokyo Alley` (סמטה גשומה בטוקיו), עד 200 תווים. |
| `description` | string | עד 2,000 תווים. |
| `category` | string | תגית קטגוריה, כגון `interior`, `exterior` או `urban`, עד 50 תווים. |
| `style` | string | תגית סגנון, כגון `cinematic`, `documentary` או `noir`, עד 50 תווים. |
| `projectId`, `workflowId`, `nodeId` | string | קישורים אופציונליים לפרויקט, לתהליך או לרכיב על הקנבס. בדרך כלל משמיטים אותם. |

**מה חוזר:** המזהה של המיקום החדש.

## `update_location`
משנה את הזהות של מיקום. רק השדות שאתם שולחים נכתבים. אי אפשר לערוך כאן את הווריאנטים; כלי היצירה מוסיפים אותם.

**הרשאה:** `assets:write`. **קרדיטים:** חינם.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `id` | string | **נדרש.** מזהה המיקום. |
| `name`, `description`, `category`, `style` | string | כמו ב-`create_location`. |
| `canonicalDescription` | string | תיאור הסצנה, עד 4,000 תווים. הטקסט שלכם מחליף את התיאור שנכתב אוטומטית. |
| `styleLock` | boolean | כשהערך הוא `true`, כל יצירה של וריאנט מקבלת גם את התמונה הראשית כייחוס, כדי שהפריסה תישאר עקבית. |
| `expectedUpdatedAt` | string | הערך `updatedAt` מ-`get_location`. השינוי נדחה אם המיקום השתנה מאז שקראתם אותו. |

**מה חוזר:** אישור, או שגיאת התנגשות כשהערך של `expectedUpdatedAt` לא עדכני.

## `approve_main_image`
הופך תוצאה מוכנה של `generate_location` לתמונה הראשית של המיקום, ומבקש ממודל ראייה לתאר אותה כדי למלא את התיאור הקנוני של המיקום.

**הרשאה:** `assets:write`. **קרדיטים:** קריאה אחת למודל הראייה Claude Sonnet 4.6 לכתיבת התיאור, שמחויבת לפי הטוקנים שהיא השתמשה בהם ([איך מחויבות קריאות LLM](https://nodaro.ai/docs/concepts/credits#llm-calls)). האישור אף פעם לא נדחה בגלל קרדיטים. כשהיתרה שלכם נמוכה מדי לתיאור, התמונה בכל זאת מאושרת, והתיאור לא נכתב. הריצו אחר כך את `recaption_location` כדי לכתוב אותו.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `location_id` | string | **נדרש.** המיקום. |
| `candidate_job_id` | string | **נדרש.** משימת `generate_location` שלכם שהושלמה. |

**מה חוזר:** כתובת התמונה הראשית והתיאור. כשכתיבת התיאור נכשלת, התמונה בכל זאת נקבעת והתיאור נשאר ריק; הריצו את `recaption_location`.

## `recaption_location`
מבקש ממודל הראייה לתאר שוב את התמונה הראשית הנוכחית, ושומר את התיאור הקנוני החדש.

**הרשאה:** `assets:write`. **קרדיטים:** קריאה אחת למודל הראייה Claude Sonnet 4.6, שמחויבת לפי הטוקנים שהיא השתמשה בהם, כמו התיאור שנכתב באישור.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `location_id` | string | **נדרש.** המיקום. |

**מה חוזר:** התיאור החדש. כשאין למיקום תמונה ראשית, הכלי מחזיר `400 no_source_image`.

## `generate_location`
יוצר שוט פותח של מיקום (`kind: "main"`) או וריאנט של המיקום (`kind: "asset"`).

**הרשאה:** `workflows:execute`. **קרדיטים:** המחיר של מודל התמונה.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `name` | string | **נדרש.** שם המיקום. |
| `kind` | string | `main` (ברירת המחדל) או `asset`. |
| `description`, `style` | string | הזהות, לתמונה ראשית. |
| `category` | string | `indoor`, `outdoor`, `urban`, `nature`, `fantasy`, `sci-fi`, `historical`, `futuristic` או `other`. |
| `model` | string | מודל התמונה. ברירת המחדל: `gpt-image-2`. |
| `asset_type` | string | עבור `asset`: `timeOfDay`, `weather`, `seasons`, `angles`, `lighting` או `custom`. |
| `variant` | string | עבור `asset`: למשל `dawn`, `noon`, `dusk` או `night`; `rain`, `snow` או `fog`; מ-`spring` עד `winter`; `aerial`, `street-level` או `wide`; `golden-hour`, `overcast` או `neon`; או תווית קצרה משלכם. |
| `attach_to_location_id` | string | שומר את התוצאה במיקום הזה ומשתמש בתמונה הראשית המאושרת שלו כמקור. בלי תמונה ראשית מאושרת, הקריאה מחזירה `main_image_required`. |
| `attach_to_column` | string | נדרש עם `attach_to_location_id` בווריאנט `custom`: `time_of_day`, `weather`, `seasons`, `angles`, `lighting`, `atmosphere_motions`, `sheets` או `detail_closeups`. |
| `attach_name` | string | השם של הווריאנט השמור. ברירת המחדל: הערך של `variant`. |
| `source_image_url` | string | תמונת מקור, כשלא שומרים את התוצאה במיקום. |

**מה חוזר:** מזהה משימה. כשמדובר בתמונה ראשית, העבירו את המשימה ל-`approve_main_image` אם התוצאה מוצאת חן בעיניכם.

## `generate_location_motion`
הופך מיקום לקליפ אווירה: תנועת מצלמה, ובתוך הסצנה תזוזה עדינה, כגון "slow dolly-in, leaves drift across frame" (דולי־אין איטי, עלים עפים לרוחב הפריים) או "drone fly-over, neon signs flicker" (מעוף רחפן, שלטי ניאון מהבהבים).

**הרשאה:** `workflows:execute`. **קרדיטים:** המחיר של מודל הווידאו.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `motion_prompt` | string | **נדרש.** תנועת המצלמה והתזוזה בסצנה, עד 2,000 תווים. |
| `source_image_url` | string | **נדרש.** הפריים הראשון, בדרך כלל התמונה הראשית המאושרת של המיקום. |
| `name` | string | **נדרש.** שם המיקום, שמשמש כהקשר בפרומפט. |
| `provider` | string | `kling` (ברירת המחדל), `kling-turbo`, `kling-3.0`, `wan-i2v`, `wan-2.7-i2v` או `seedance-2`. |
| `attach_to_location_id` | string | שומר את הקליפ בקליפי האווירה של המיקום. |
| `attach_name` | string | השם של הקליפ השמור. |
| `refine_from_video_url` | string | מעדן קליפ קיים עם פרומפט חדש, מווידאו לווידאו, במקום להתחיל מהתמונה. |
| `canonical_description`, `category`, `style` | string | הקשר נוסף לפרומפט. |

**מה חוזר:** מזהה משימה. הכרטיס מציג את הקליפ כשהוא מוכן.

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

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

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

### אילו וריאנטים יכולים להיות למיקום?

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

### מה עושה הפרמטר styleLock?

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

### איך מעדנים קליפ אווירה בלי להתחיל מההתחלה?

קראו שוב לכלי generate_location_motion, עם הקליפ בפרמטר refine_from_video_url ועם פרומפט חדש, למשל אותו שוט עם גשם קל במקום ערפל. הכלי מעבד אז את הקליפ הזה מווידאו לווידאו.