פלטות ומודבורדים

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

פלטות ומודבורדים יוצרים ב-REST API, ב-SDK, ב-CLI או עם עוזר AI דרך MCP. בעורך אין מסך שבו יוצרים או עורכים אותם. הם עובדים בכל מהדורה.

מה כל אחד כולל

שניהם שייכים לכם בלבד. מזהה של אדם אחר נדחה עם 404, כמו מזהה שלא קיים.

איך פלטה מכוונת תמונה

ההרצה מציינת בפרומפט כל צבע מהפלטה, בסדר שלכם, בצורה color palette: <name> <hex>, …. כל צבע מקבל את השם היומיומי הקרוב ביותר אליו — כי מודל נצמד בצורה אמינה יותר לצבע שיש לו שם — ואת הקוד ההקסדצימלי המדויק שלו. ההערה של הפלטה מיועדת לכם ולא נוספת לפרומפט.

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

איך מודבורד מכוון תמונה

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

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

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

האזהרה כשתמונות לא נשלחות

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

5 of the 12 images of moodboard "Nordic calm" were not sent as style references: the model (nano-banana-pro) takes at most 8 reference images, and your own references come first.

מגבלות

• קישורים לתמונות, לא עותקים. כל תמונה היא קישור http או https ציבורי של עד 2,048 תווים, וכיתוב מוגבל ל-200 תווים. קישור לרשת פרטית נדחה. תמונה שמחקתם, או תמונה שנמחקה בתום תקופת שמירת המדיה של התוכנית שלכם, נעלמת גם מהמודבורד.
• יצירת תמונה בלבד. בקשת וידאו שמציינת פלטה או מודבורד נדחית עם 400.
• לא יחד עם ערכה באותה בקשה. קריאה שמחילה ערכה (presetId) לא יכולה להשתמש בפלטה או במודבורד, ונדחית עם 400. זה כולל ערכה שנשמרה עם אחד מהם בשדה direction שלה.
• ההרצה משתמשת בגרסה האחרונה. ההרצה רושמת את המזהים, לא עותק. אם משנים פלטה, ההרצה הבאה משתמשת בצבעים החדשים. אם מוחקים אותה, הרצה שעדיין מציינת אותה נדחית עם 404.
• השגיאות מגיעות לפני כל חיוב. מזהה פגום נדחה עם 400, ומזהה שלא שייך לכם או שכבר לא קיים נדחה עם 404. על מזהה מובנה לא מוכר מדלגים, אבל מפלטה או ממודבורד שלכם לעולם לא מתעלמים בשקט.

כמה זה עולה

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

בתוך תהליך

כשה-direction של רכיב יצירת תמונה מציין פלטה או מודבורד, הם נטענים מחדש בכל פעם שהתהליך רץ, כולל הרצות של אפליקציות, תזמונים ו-Webhooks. רכיב כזה נכתב לתוך התהליך מקוד, או שעוזר AI כותב אותו.

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

יצירה ושימוש מקוד