פיצול לשכבות

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

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

מתי להשתמש

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

התחלה מהירה

קלטים

פלטים

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

תמונת הבסיס וכל השכבות נשמרות גם בספרייה שלכם. כל שכבה נשמרת בשם שלה.

נתוני השכבות

הפלט נתוני שכבות נראה כך:

[
  {
    "name": "Arctic fox",
    "description": "The full body of the standing white arctic fox, with no background.",
    "zIndex": 1,
    "width": 1108,
    "height": 946,
    "box": { "x1": 228, "y1": 482, "x2": 897, "y2": 1070 },
    "boxNormalized": { "x1": 223, "y1": 314, "x2": 875, "y2": 696 },
    "url": "https://…/layer.png",
    "baseUrl": "https://…/base.png"
  }
]

כמה תמונות בהרצה אחת

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

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

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

[
  { "name": "Fox", "zIndex": 1, "url": "https://…/fox.png", "baseUrl": "https://…/base-1.png", "row": 0 },
  { "name": "Owl", "zIndex": 1, "url": "https://…/owl.png", "baseUrl": "https://…/base-3.png", "row": 2 }
]

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

הגדרות

בשדה מה להפריד אפשר לסמן איפה נמצא אלמנט בעזרת <bbox>x1 y1 x2 y2</bbox>. המספרים הם הפינות, בסולם מ-0 עד 1000 של התמונה. למשל:

Separate the title <bbox>179 58 809 197</bbox> and the parrot <bbox>330 274 641 991</bbox>

באפליקציה שפורסמה

אפליקציה שבנויה על תהליך עם הרכיב הזה יכולה לאפשר למשתמשים שלה לקבוע את ההגדרה מקסימום שכבות, במחוון מ-1 עד 20, ואת ההגדרה גודל, עם אחת מהאפשרויות אוטומטי, 1K, 1.5K או 2K. המחוון של האפליקציה וכל דריסה של ערכים בהרצת תהליך מוגבלים לערכים האלה. כל ערך אחר נדחה לפני שההרצה מתחילה.

אפליקציה שולחת רק את הערכים שהמשתמש שלה שינה. בהרצה שלא משנה את ההגדרה מקסימום שכבות, נשאר הערך שהיוצר שמר ברכיב, עד 99 שכבות, והקרדיטים משוריינים לפי הערך הזה. למשל, כשברכיב שמורות 50 שכבות, משוריינים קרדיטים ל-51 תמונות. כשהמחוון בקצה העליון שלו, ל-20 שכבות ב-2K משוריינים 369 קרדיטים.

קרדיטים

להרצה משוריינים קרדיטים למספר התמונות המרבי שהיא יכולה להחזיר: הערך של מקסימום שכבות ועוד תמונת הבסיס. ההרצה מחויבת רק לפי התמונות שהיא מחזירה בפועל: תמונת הבסיס וכל שכבה. הגדלים 1K ו-1.5K עולים אותו דבר, והגודל 2K והאפשרות אוטומטי עולים יותר. הכפתור הרצה מציג את השריון לפי ההגדרות שבחרתם.

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

מהדורת Community ומהדורת Business באירוח עצמי לא משתמשות בקרדיטים.

טיפים

• הרכיבו מחדש לפי הסדר. כדי לבנות תמונה מחדש, הציבו כל שכבה על תמונת הבסיס במיקום ה-box שלה, לפי הסדר של zIndex.
• בחרו כמה לקבץ. ערך נמוך יותר בהגדרה מקסימום שכבות מקבץ אלמנטים יחד, למשל כותרת שלמה בשכבה אחת. ערך גבוה יותר שומר אותם בנפרד.
• ציינו את האלמנטים שאתם צריכים. כשהאלמנטים העיקריים הם לא אלה שאתם רוצים, תארו אותם בשדה מה להפריד, למשל "the logo and the price tag" (הלוגו ותג המחיר).

פתרון בעיות

דרך ה-API

הנתיב POST /v1/split-into-layers עם { imageUrl, maxLayers?, size?, prompt?, sessionId?, origin? } מכניס משימה לתור ומחזיר את ה-jobId שלה. בקשה פגומה נדחית עם 400 validation_error לפני שמשהו משוריין. השדה sessionId שומר את המשימה באחד הסשנים שלכם, והשדה origin מתייג אותה ב-slug של האפליקציה שלכם. הכותרת Idempotency-Key גורמת לניסיון חוזר לקבל את המשימה שהבקשה הראשונה התחילה ({ jobId, deduped: true }), במקום להתחיל משימה שנייה.

במשימה שהושלמה, השדה output_data.imageUrl הוא תמונת הבסיס, והשדה output_data.layers מפרט את קובצי השכבות לפי הסדר. השדה output_data.layerData הוא נתוני השכבות שלמעלה. השדה output_data.layerCount הוא מספר השכבות שנשמרו, והשדה output_data.layersNotSaved הוא מספר השכבות שלא נשמרו (0 כשכל השכבות נשמרו).

כדי לקבל את השריון לפני ההרצה, שלחו { "type": "split-into-layers", "params": { … } } לנתיב POST /v1/quote, עם אותו גוף בקשה. שום הרצה לא מתחילה. השדה identifier בתגובה הוא מזהה המחיר שלפיו הקרדיטים משוריינים (split-into-layers:<1k|2k>:<images>), והשדה reserve הוא הקרדיטים המשוריינים: 64 קרדיטים כשבהגדרה מקסימום שכבות הערך הוא 5 ב-1K, ו-104 קרדיטים בברירת המחדל. ב-SDK, קראו למתודה client.nodes.quote("split-into-layers", body). כשאי אפשר להריץ את הרכיב, אומדן המחיר נדחה כמו ההרצה, עם 403 node_not_available.

המתודה ב-SDK היא client.media.splitIntoLayers, כלי ה-MCP הוא split_into_layers, והפקודה ב-CLI היא nodaro media split-layers. ראו את דפי ה-API הרצת רכיב יחיד ומשימות, את הדף מדיה והעלאות ב-SDK ואת מדריך כלי ה-MCP.