תיעוד Nodaroמיקומים
בנו מיקומים ב-Nodaro דרך עוזר AI: צרו ואשרו שוט פותח, הוסיפו וריאנטים של שעות היום, מזג אוויר וזוויות, והפכו את המקום לקליפי אווירה.
כלי המיקומים מאפשרים לעוזר AI לבנות את המקומות בספרייה שלכם ולהשתמש בהם: רחוב, חדר או נוף עם מראה נעול, שנשאר זהה בכל שוט. העוזר יוצר מיקום, יוצר ומאשר את השוט הפותח שלו, מוסיף וריאנטים של שעות היום, מזג אוויר, עונות, זוויות ותאורה, מנפיש קליפי אווירה ומעביר את התמונות כייחוסים ליצירות אחרות. המדריך מיקומים מתאר את אותה עבודה באפליקציה.
מחזור החיים זהה לזה של כלי הדמויות: יצירת המיקום, יצירת תמונה ראשית ואישור שלה, ואז יצירת וריאנטים ותנועה מהתמונה הזו.
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). האישור אף פעם לא נדחה בגלל קרדיטים. כשהיתרה שלכם נמוכה מדי לתיאור, התמונה בכל זאת מאושרת, והתיאור לא נכתב. הריצו אחר כך את 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 ועם פרומפט חדש, למשל אותו שוט עם גשם קל במקום ערפל. הכלי מעבד אז את הקליפ הזה מווידאו לווידאו.
דפים קשורים
מיקומים
נכס מיקום
דמויות
אובייקטים ויצורים
עודכן לאחרונה