# תמונה

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

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

**כלי התמונה** מאפשרים לעוזר AI ליצור ולשנות תמונות ב-Nodaro: ליצור תמונה מפרומפט, להמיר או לערוך תמונה קיימת, ליצור מסכה, לשלב כמה תמונות או שכבות, ולתאר מה רואים בתמונה. כל כלי חוץ מ-`suggest_overlay_placement`, מ-`save_image_defaults` ומכלי הפלטות והמודבורדים מתחיל משימה ומחזיר את המזהה שלה, והתוצאה נשמרת בספרייה שלכם. כל כלי תמונה, חוץ מכלי הפלטות והמודבורדים, צריך את ההרשאה `workflows:execute`.

| כלי | מה הוא עושה | קרדיטים |
| --- | --- | --- |
| [`generate_image`](#generate_image) | טקסט לתמונה, עם ייחוסים והשלמה אופציונלית | המחיר של המודל |
| [`modify_image`](#modify_image) | עורך תמונה קיימת, משנה את הסגנון שלה או ממיר אותה | המחיר של המודל |
| [`image_to_image`](#image_to_image) | תמונה לתמונה לפי פרומפט, עם מסכות וכמה ייחוסים | המחיר של המודל |
| [`edit_image`](#edit_image) | הגדלה, הסרת רקע ועריכות ממוקדות | המחיר של הפעולה |
| [`generate_mask`](#generate_mask) | מסכה בשחור־לבן של מה שאתם מתארים | 55 |
| [`image_collage`](#image_collage) | 2–30 תמונות בתמונה גדולה אחת | 22 ב-2K, 44 ב-4K |
| [`image_overlay`](#image_overlay) | לוגואים, טקסט, קודי QR וצורות על תמונה, בלי AI | 11, ויותר עם גדלים נוספים |
| [`suggest_overlay_placement`](#suggest_overlay_placement) | איפה למקם לוגו או טקסט על תמונה | תיאור תמונה אחד |
| [`image_to_text`](#image_to_text) | תיאור של תמונה, או תשובה לשאלה עליה | לפי הטוקנים שנעשה בהם שימוש, בתעריף של המודל |
| [`save_image_defaults`](#save_image_defaults) | מודל התמונה וההגדרות שלכם כברירת מחדל | חינם |
| [`list_palettes`](#list_palettes), [`save_palette`](#save_palette) | פלטות הצבעים שלכם, כדי לכוון את `generate_image` | חינם |
| [`list_moodboards`](#list_moodboards), [`save_moodboard`](#save_moodboard) | המודבורדים שלכם, כדי לכוון את `generate_image` | חינם |

## `generate_image`
יוצר תמונה מפרומפט טקסט עם אחד ממודלי התמונה של Nodaro. זה הכלי שמאחורי בקשות כגון ״צור תמונה של…״, והוא עובד כמו רכיב [יצירת תמונה](https://nodaro.ai/docs/nodes/image/generate-image).

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

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `prompt` | string | תיאור התמונה, עד 4,000 תווים. נדרש, אלא אם ערכה מספקת אותו. |
| `model` | string | מזהה המודל. ברירת המחדל: `gpt-image-2`. מזהה לא מוכר מוחלף בברירת המחדל. ראו את הכלי [`list_models`](https://nodaro.ai/docs/mcp/tools/models-and-credits#list_models). |
| `aspect_ratio` | string | למשל `16:9`, `9:16`, `1:1`, `4:3`, `3:4` או `21:9`. ברירת המחדל: `16:9`. הכלי מקבל גם כתיבה כגון `16x9`, ויחס שהמודל לא תומך בו מוחלף ביחס שהוא כן תומך בו. הערך `auto` שומר בכל מודל על הצורה של התמונה שלכם: התמונה ב-`base_image_url` כשהוא מוגדר, ואחרת תמונת הייחוס הראשונה. מודל עם הגדרת `auto` משלו מקבל אותה, וכל מודל אחר משתמש ביחס הנתמך שהכי קרוב לתמונה הזאת. בלי תמונה, `auto` נותן את ה-`auto` של המודל עצמו כשיש לו כזה, אחרת `16:9` כשהוא מופיע ברשימה של המודל, ואחרת את היחס הראשון ברשימה שלו. |
| `resolution` | string | `1K`, `2K` או `4K`, במודלים שתומכים בזה. הכלי משתמש בערך הנתמך הקרוב ביותר. |
| `quality` | string | `medium` או `high`, במודלים שיש להם הגדרת איכות. |
| `negative_prompt` | string | ממה להימנע, עד 2,000 תווים. |
| `reference_image_urls` | array | עד 14 תמונות ייחוס, ככתובות או כמזהים של Nodaro, כדי לשמור על אדם, דמות, מוצר או סגנון. התשובה מאשרת כמה תמונות צורפו. |
| `count` | integer | מ-1 עד 4 תמונות לכל מודל. כל תמונה היא משימה משלה. |
| `models` | array | מ-2 עד 4 מזהים של מודלי תמונה, במקום `model`. אותה בקשה רצה בכל מודל. |
| `presetId` | string | ערכה מ-[`list_node_presets`](https://nodaro.ai/docs/mcp/tools/models-and-credits#list_node_presets), שמוחלת כמו שהעורך מחיל אותה. שדות שאתם שולחים גוברים עליה. ראו את הסעיף [החלת ערכה](#apply-a-preset). |
| `variables` | object | ערכים למשתנים של ערכה שאין להם ברירת מחדל, למשל `{ "BRAND": "Acme" }`. |
| `palette_id` | string | פלטה מ-[`list_palettes`](#list_palettes). הצבעים שלה מצוינים בשמם בפרומפט. |
| `moodboard_id` | string | מודבורד מ-[`list_moodboards`](#list_moodboards). התיאור שלו מתווסף לפרומפט, והתמונות שלו נשלחות למודל כייחוסי סגנון. |
| `subject` | object | מי מופיע בתמונה, כמזהים מהקטלוג, בצורה `{ field: id }` או `{ field: [ids] }`. השדות הם שדות האדם והסטיילינג, `heldProp`, `material` ו-`animal`, מ-[`get_picker_catalog`](https://nodaro.ai/docs/mcp/tools/projects-and-workflows#get_picker_catalog). |
| `structured` | object | פרטים בפורמט מובנה שמתווספים לפרומפט: `person` (גיל, מגדר, הבעה, עיניים, שיער, מקצוע), `styling` (אסתטיקה, מראה צבע, תאורה, מצב־רוח), `setting` (אווירה, רקע, תקופה), `camera` (פורמט, מסגור, תנועה), `lens` (צמצם, אורך מוקד) ו-`mood`. |
| `described_references` | array | עד 10 רשומות `{ name, description }` לנושא שאפשר לקרוא לו בשם אבל אין לכם תמונה שלו. כל רשומה הופכת לשורה בפרומפט, כך שהשם בפרומפט שלכם מגיע למודל כנושא מתואר. |
| `connected_references`, `reference_order` | array | מתקדם. ייחוסים מתויגים ומסודרים בפורמט של העורך עצמו, עד 14. |
| `base_image_url`, `mask_url` | string | השלמה: התמונה לעריכה ומסכה, שבה האזור הלבן משתנה והאזור השחור נשאר כמו שהוא. האזור הממוסך נוצר מחדש ומוצב בחזרה על התמונה. |
| `strength` | number | בהשלמה, מ-0 (עדין) עד 1 (צביעה מחדש מלאה), במודלים שתומכים בזה. |
| `guidance_scale` | number | מ-0 עד 20, במודלים שתומכים בזה. |
| `user_request` | string | ההודעה האחרונה שנשלחה לעוזר, מילה במילה, עד 4,000 תווים. ההודעה נשמרת ברכיב שבתהליך של השיחה, ואף פעם לא משנה את מה שנוצר. ראו [איך שיחות MCP הופכות לתהליכים](https://nodaro.ai/docs/mcp/conversation-flows). |
| `flow_id` | string | הערך `"new"` מתחיל תהליך חדש לשלב הזה. מזהה תהליך מתוצאה קודמת מוסיף את השלב לתהליך הזה. עד 36 תווים. ראו את הסעיף [התחלה או בחירה של תהליך בעצמכם](https://nodaro.ai/docs/mcp/conversation-flows#start-or-choose-a-workflow-yourself) בדף שיחות MCP. |

**מה חוזר:** מזהה משימה. בלקוחות עם MCP Apps, הכרטיס מציג את התמונה כשהיא מוכנה.

### כמה תמונות בקריאה אחת
- **`count`** יוצר עד 4 תמונות מאותה בקשה. כל תמונה היא משימה משלה.
- **`models`** מריץ את אותה בקשה על 2–4 מודלים. כשמשתמשים בשניהם, `count` חל על כל מודל בנפרד, ולכן קריאה אחת יוצרת לכל היותר 8 תמונות.
- **התשובה** מפרטת כל מזהה משימה, מקובץ לפי מודל, יחד עם מזהה האצווה. הכרטיס ו-`jobId` שייכים למשימה הראשונה.
- **כל מודל מקבל הגדרות משלו.** פרמטרים כגון יחס גובה־רוחב ורזולוציה מותאמים לכל מודל, כמו בקריאה יחידה.
- **האצווה מחויבת כמכלול.** Nodaro בודק את היתרה שלכם מול האצווה כולה, ויוצר את כל המשימות שלה או אף אחת מהן. תשובת שגיאה פירושה שלא נגבו קרדיטים.
- **דחיות.** הכלי דוחה `count` מחוץ לטווח 1–4, יותר מ-4 מודלים, `model` ו-`models` יחד, או רשימה שכוללת מודל שהוא לא מודל תמונה. השגיאה מציינת מה הבעיה. ב-`models`, מזהי המודלים מזוהים בלי הבדל בין אותיות גדולות לקטנות.

### החלת ערכה
הפרמטר `presetId` מחיל ערכה מובנית או שמורה בדיוק כמו שהעורך מחיל אותה:

- הכלי משתמש בפרומפט של הערכה ובטקסט שלה לפני הפרומפט ואחריו. ה-`prompt` שלכם נעטף בטקסט הזה.
- משתנים שכתובים בצורה `{name || default}` מתמלאים בערכי ברירת המחדל שלהם.
- הסגנון והפרומפט השלילי של הערכה מועברים בצורה שהמודל מקבל אותם.
- כל הגדרה שהערכה לא קובעת מקבלת את ברירת המחדל של העורך. ברירות המחדל לתמונה ששמרתם לא חלות על קריאה עם ערכה.

משתנה בלי ברירת מחדל, כגון `{BRAND}`, צריך ערך ב-`variables`. בלי ערך, הכלי מציין איזה ערך חסר. עם `count`, הכלי יוצר את מספר התמונות הזה מהבקשה של הערכה. עם `models`, הוא מחיל את הערכה פעם אחת לכל מודל. עדיין אי אפשר לשלב את `presetId` עם `palette_id` או עם `moodboard_id`: הקריאה נדחית.

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

## `modify_image`
עורך תמונה קיימת, משנה את הסגנון שלה או ממיר אותה לפי פרומפט: שינוי צבע, החלפת רקע, החלת סגנון, הרחבת התמונה או צביעה מחדש של חלק ממנה. הכלי עובד כמו רכיב [עריכת תמונה](https://nodaro.ai/docs/nodes/image/modify-image).

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

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `prompt` | string | **נדרש.** השינוי שאתם רוצים, עד 8,000 תווים. |
| `image_url` או `image_asset_id` | string | **נדרש אחד מהשניים.** כתובת `https` ציבורית, או המזהה של משימת Nodaro שהתוצאה שלה היא תמונה. |
| `model` | string | ברירת המחדל: `gpt-image-2-5-flare-i2i`. השתמשו ב-`nano-banana-pro` לטקסט בתמונה וכדי לשמור על פנים או על דמות זהות לאורך כמה עריכות, וב-`gpt-image-2-i2i` לעריכות עם הרבה טקסט. מזהה לא מוכר מוחלף בברירת המחדל. |
| `aspect_ratio` | string | צורת הפלט. הערך `auto` שומר בכל מודל על הצורה של התמונה: מודל עם הגדרת `auto` משלו מקבל אותה, וכל מודל אחר משתמש ביחס הנתמך שהכי קרוב לתמונת המקור. ערך אחר שהמודל לא תומך בו מוחלף בערך נתמך. |
| `resolution` | string | הכלי משתמש בערך הנתמך הקרוב ביותר. |
| `quality` | string | `medium`, `high` או `basic`, במודלים שיש להם הגדרה כזו. |
| `negative_prompt` | string | ממה להימנע, עד 2,000 תווים. |
| `structured` | object | אותם פרטים בפורמט מובנה כמו ב-`generate_image`. |
| `user_request` | string | ההודעה האחרונה שנשלחה לעוזר, מילה במילה, עד 4,000 תווים. ההודעה נשמרת ברכיב שבתהליך של השיחה, ואף פעם לא משנה את מה שנוצר. ראו [איך שיחות MCP הופכות לתהליכים](https://nodaro.ai/docs/mcp/conversation-flows). |
| `flow_id` | string | הערך `"new"` מתחיל תהליך חדש לשלב הזה. מזהה תהליך מתוצאה קודמת מוסיף את השלב לתהליך הזה. עד 36 תווים. ראו את הסעיף [התחלה או בחירה של תהליך בעצמכם](https://nodaro.ai/docs/mcp/conversation-flows#start-or-choose-a-workflow-yourself) בדף שיחות MCP. |

**מה חוזר:** מזהה משימה.

## `image_to_image`
ממיר תמונה לפי פרומפט, עם אפשרויות למסכות ולשילוב כמה ייחוסים בתמונה אחת.

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

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `prompt` | string | **נדרש.** ההמרה, עד 2,000 תווים. |
| `image_url` או `image_asset_id` | string | תמונת המקור. |
| `model` | string | ברירת המחדל: `gpt-image-2-5-flare-i2i`. מודלים אחרים הם, בין השאר, `nano-banana`, `nano-banana-2`, `flux-kontext` לעריכות פוטו־ריאליסטיות, `gpt-image-i2i` לצביעה מחדש יצירתית, `flux-i2i` ו-`ideogram-remix`. מזהה לא מוכר מוחלף בברירת המחדל. |
| `reference_image_urls` | array | עד 13 תמונות ייחוס נוספות, ככתובות או כמזהים של Nodaro, במודלים שמקבלים כמה ייחוסים. |
| `mask_url` | string | מסכת השלמה: האזור הלבן משתנה, והאזור השחור נשאר כמו שהוא. |
| `strength` | number | מ-0 (עדין) עד 1 (צביעה מחדש מלאה). |
| `aspect_ratio` | string | צורת הפלט. |
| `resolution` | string | `1K`, `2K` או `4K`. |
| `quality` | string | `medium`, `high` או `basic`. |
| `seed` | integer | זרע קבוע, במודלים שתומכים בזה. |
| `negative_prompt` | string | ממה להימנע, עד 5,000 תווים. |
| `user_request` | string | ההודעה האחרונה שנשלחה לעוזר, מילה במילה, עד 4,000 תווים. ההודעה נשמרת ברכיב שבתהליך של השיחה, ואף פעם לא משנה את מה שנוצר. ראו [איך שיחות MCP הופכות לתהליכים](https://nodaro.ai/docs/mcp/conversation-flows). |
| `flow_id` | string | הערך `"new"` מתחיל תהליך חדש לשלב הזה. מזהה תהליך מתוצאה קודמת מוסיף את השלב לתהליך הזה. עד 36 תווים. ראו את הסעיף [התחלה או בחירה של תהליך בעצמכם](https://nodaro.ai/docs/mcp/conversation-flows#start-or-choose-a-workflow-yourself) בדף שיחות MCP. |

**מה חוזר:** מזהה משימה.

## `edit_image`
מגדיל תמונה, מסיר את הרקע שלה או מבצע בה עריכה ממוקדת. בחרו את הפעולה בפרמטר `model`.

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

| `model` | פעולה | מה נדרש |
| --- | --- | --- |
| `recraft-upscale` (ברירת המחדל) | הגדלה חדה | התמונה |
| `topaz-image-upscale` | הגדלה פי 1, 2 או 4 | התמונה ו-`upscale_factor` |
| `recraft-remove-bg` | מסיר את הרקע ומחזיר PNG עם שקיפות | התמונה |
| `nano-banana-edit` | עריכה לפי פרומפט, בתוך מסכה או מחוץ לגבולות התמונה | התמונה, `prompt` ו-`mask_url` אופציונלי |
| `grok-2-segment` | מפה חינמית של אזורים עם שמות, בתמונה קודמת של Grok Imagine 2 | `task_id` |
| `grok-2-edit` | עריכה לפי פרומפט של תמונה קודמת של Grok Imagine 2, ואפשר גם רק בחלק מהאזורים | `task_id`, `prompt` ו-`mask_indexes` אופציונלי |

| Model | Maker | Modes | Credits | Details |
| --- | --- | --- | --- | --- |
| [Recraft Crisp Upscale](https://nodaro.ai/docs/models/image/recraft-crisp-upscale) | Recraft | Image upscaling | 3 | Light-weight image upscale (Recraft Crisp). |
| [Topaz Image Upscale](https://nodaro.ai/docs/models/image/topaz-image-upscale) | Topaz | Image upscaling | החל מ-28 | High-quality image upscale at 1x (enhance only), 2x or 4x. Best for production-ready output. |
| [Recraft Remove BG](https://nodaro.ai/docs/models/image/recraft-remove-bg) | Recraft | Background removal | 4 | Remove image background. Cheap utility. |
| [Nano Banana Edit](https://nodaro.ai/docs/models/image/nano-banana-edit) | Google | Image editing | 11 | Image-to-image edits via Google's Nano Banana family. Good general-purpose editor. |
| [Grok Imagine 2 Segment Map](https://nodaro.ai/docs/models/image/grok-imagine-2-segment-map) | xAI | Image editing | 0 | FREE semantic segment map of a prior grok-2 generation — named region masks whose indexes feed grok-2-edit's region targeting. |
| [Grok Imagine 2 Edit](https://nodaro.ai/docs/models/image/grok-imagine-2-edit) | xAI | Image editing | 11 | Prompt-edit a prior grok-2 generation by task id. Optional mask indexes (from grok-2-segment) restrict the edit to named regions. |

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `model` | string | הפעולה, מהטבלה שלמעלה. ברירת המחדל: `recraft-upscale`. |
| `image_url` או `image_asset_id` | string | תמונת המקור, בכל פעולה חוץ משתי פעולות Grok. |
| `prompt` | string | נדרש עבור `nano-banana-edit` ועבור `grok-2-edit`. עד 2,000 תווים. |
| `mask_url` | string | עבור `nano-banana-edit`: האזור הלבן משתנה. |
| `upscale_factor` | string | עבור `topaz-image-upscale`: `1`, `2` או `4`. ברירת המחדל: `2`. |
| `target_resolution` | string | דרך ישנה יותר לקבוע את יחס ההגדלה ב-`topaz-image-upscale`: הערך `2K` שווה ל-`2`, והערכים `4K` ו-`8K` שווים שניהם ל-`4`. השתמשו במקום זאת ב-`upscale_factor`. |
| `task_id` | string | בפעולות Grok: המזהה שהספק נתן ליצירה הקודמת ב-Grok Imagine 2. הכלי `get_job` מחזיר אותו בשדה `providerTaskId` בפלט של היצירה. |
| `mask_indexes` | array | עבור `grok-2-edit`: ערכי ה-`index` של האזורים לשינוי, מהרצה של `grok-2-segment`. |
| `negative_prompt`, `seed`, `style` | | אופציונליים, בפעולות שמשתמשות בהם. |

כדי לערוך רק חלק מהאזורים בתמונה של Grok Imagine 2, עבדו בשני שלבים. קודם הריצו את `grok-2-segment` עם ה-`task_id` של התמונה, וקבלו את האזורים עם השמות מהשדה `segments` של המשימה. אחר כך הריצו את `grok-2-edit` עם אותו `task_id`, עם פרומפט ועם ה-`mask_indexes` של האזורים לשינוי. מפת האזורים לא עולה כלום.

המודל `grok-upscale` כבר לא זמין: הוא אף פעם לא הגדיל תמונות. קריאה שעדיין מציינת אותו נדחית, עם הודעה שמציינת את החלופה: המודל `recraft-upscale` או `topaz-image-upscale`.

**מה חוזר:** מזהה משימה.

## `generate_mask`
יוצר מסכה בשחור־לבן של מה שאתם מתארים, למשל "the person" (האדם) או "sky and clouds" (שמיים ועננים). לבן מסמן את האזור שנבחר. השתמשו במסכה עם `image_to_image`, עם `edit_image` או עם שדות ההשלמה של `generate_image`. הכלי עובד כמו רכיב [יצירת מסכה](https://nodaro.ai/docs/nodes/image/generate-mask).

**הרשאה:** `workflows:execute`. **קרדיטים:** 55.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `prompt` | string | **נדרש.** מה לסמן, עד 500 תווים. |
| `image_url` או `image_asset_id` | string | תמונת המקור. |
| `threshold` | number | סף הביטחון של הזיהוי, מ-0 עד 1. ברירת המחדל: `0.3`. |

**מה חוזר:** מזהה משימה. התוצאה היא מסכה בפורמט PNG.

## `image_collage`
מסדר בין 2 ל-30 תמונות בתמונה גדולה אחת. אף תמונה לא נחתכת: הפריסה `smart` מסדרת אותן בשורות, כל אחת בצורה שלה, והפריסה `grid` משתמשת בתאים שווים וממלאת את השטח הריק בצבע הרקע. הכלי עובד כמו רכיב [קולאז׳ תמונות](https://nodaro.ai/docs/nodes/image/image-collage), ומתאים לסטוריבורדים ולגיליונות קונטקט.

**הרשאה:** `workflows:execute`. **קרדיטים:** 22 ב-`2K`, 44 ב-`4K`.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `images` | array | **נדרש.** 2–30 פריטים, כל אחד `{ url }` או `{ asset_id }`. פריט יכול להוסיף `size`, גודל יחסי לפריסה החכמה (`0` אוטומטי, `1` גדול, `2` בינוני, `3` קטן), ו-`label`, כיתוב של עד 80 תווים. |
| `layout` | string | `smart` (ברירת המחדל) או `grid`. |
| `resolution` | string | הצד הארוך: `2K`, או `4K` (ברירת המחדל, 3,840 פיקסלים). |
| `aspect_ratio` | string | כל `W:H`, כגון `16:9` או `9:16`. ברירת המחדל: `4:3`. ב-`grid` היחס מדויק; ב-`smart` הוא רק יעד, והגובה נקבע לפי השורות. |
| `gap` | integer | הרווח בין התמונות ומסביבן, מ-0 עד 200 פיקסלים. ברירת המחדל: `24`. |
| `background_color` | string | צבע בפורמט `#RRGGBB`. ברירת המחדל: `#ffffff`. |
| `numbered` | boolean | מטביע 1, 2, 3 וכן הלאה בפינה של כל תמונה, לפי הסדר ב-`images`. |
| `badge_position` | string | הפינה של המספרים והכיתובים: `top-left` (ברירת המחדל) או `top-right`. |

**מה חוזר:** מזהה משימה.

## `image_overlay`
מציב בין 1 ל-12 שכבות על תמונת בסיס, בדיוק ברמת הפיקסל: לוגואים, גזירות, טקסט, קודי QR וצורות. שום מודל AI לא רץ, ולכן התוצאה זהה בכל פעם. הכלי עובד כמו רכיב [שכבת תמונה](https://nodaro.ai/docs/nodes/image/image-overlay), והדף של הרכיב מתאר כל אפשרות.

**הרשאה:** `workflows:execute`. **קרדיטים:** 11, ועוד קצת על כל גודל פלטפורמה נוסף ב-`variants`, כמו ברכיב [שכבת תמונה](https://nodaro.ai/docs/nodes/image/image-overlay#credits).

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `image_url` או `image_asset_id` | string | תמונת הבסיס. |
| `layers` | array | **נדרש.** 1–12 שכבות. ראו את שדות השכבה שבהמשך. הסדר במערך הוא סדר השכבות, אלא אם שכבה קובעת `z_index`. |
| `canvas` | object | גודל פלט: השדות `width` ו-`height`, מ-16 עד 8,192 פיקסלים, עם `background_color`. הבסיס מוצב בתוכו לפי `base_fit`, עם הערך `contain` או `cover`. השמיטו אותו כדי לשמור על הגודל של תמונת הבסיס. |
| `variants` | array | גדלי פלטפורמה נוספים לרינדור באותה הרצה: `youtube-thumbnail`, `youtube-banner`, `linkedin-company`, `linkedin-personal`, `x-header`, `facebook-cover`, `instagram-post`, `instagram-portrait`, `instagram-story`, `open-graph`, `presentation`, `a4-print`. |
| `qr_text` | string | ממלא כל שכבת QR שבה `qr.fromInput` הוא `true`. |
| `mask_mode` | string | המסכה שהמשימה מחזירה גם בשדה `maskUrl`, שבה הלבן מסמן מה מותר לשנות: `around` (ברירת המחדל, טבעת סביב השכבות לגימור AI), `layers`, `outside` או `none`. |
| `mask_spread` | integer | הרוחב של הטבעת ב-`around`, מ-1 עד 400 פיקסלים. ברירת המחדל: `48`. |
| `output_format` | string | `png` (ברירת המחדל, שומר על שקיפות), `jpg` או `webp`. |

השדות העיקריים של שכבה:

| שדה השכבה | הערות |
| --- | --- |
| `kind` | `image` (ברירת המחדל, דורש `url` או `asset_id`), `text`, `qr` או `shape`. |
| `anchor` | אחת מ-9 נקודות, מ-`top-left` עד `bottom-right`. ברירת המחדל: `center`. |
| `x`, `y` | ההזזה מהעוגן, באחוזים מהרוחב ומהגובה של הבסיס. ערך שלילי בעוגן ימני או תחתון מזיז את השכבה פנימה. |
| `width`, `height` | באחוזים מהרוחב ומהגובה של הבסיס. רוחב ברירת המחדל: 25%. הגובה נקבע לפי הצורה של השכבה, אלא אם קובעים אותו. |
| `opacity`, `rotation`, `blend` | אטימות מ-0 עד 1, סיבוב במעלות, ומיזוג `over`, `multiply` או `screen`. |
| `fit`, `shadow`, `rounded_corners`, `z_index` | איך השכבה ממלאת את התיבה שלה (`contain`, `cover` או `stretch`), צל נופל, פינות מעוגלות וסדר השכבות. |
| `effects` | בשכבות תמונה בלבד: מסכה עגולה, ריכוך קצוות, קו מתאר או זוהר. |
| `text` | לשכבת טקסט: ה-`text`, `fontId` (`inter`, `montserrat`, `space-grotesk`, `playfair-display`, `oswald`, `bebas-neue`, `anton`, `pacifico`, `rubik` או `heebo`; הגופנים `rubik` ו-`heebo` תומכים בעברית), `fontSize` באחוזים מגובה הבסיס, `fontWeight`, `color`, `align`, `letterSpacing`, `lineHeight`, `uppercase`, קו מתאר ותיבת רקע. |
| `qr` | לשכבת QR: ה-`text` לקידוד, או `fromInput: true`, וגם צבעים ושוליים. |
| `shape` | לשכבת צורה: `rect`, `rounded`, `pill`, `circle`, `ribbon`, `triangle`, `diamond`, `hexagon`, `star`, `burst` או `arrow`, עם צבע וקו מתאר. |

סימן מים בפינה הימנית התחתונה הוא `anchor: "bottom-right"`, `x: -4`, `y: -6`, `width: 12`. לוגואים ב-SVG מרונדרים חדים בגודל היעד.

**מה חוזר:** מזהה משימה. התוצאה כוללת את התמונה, את `maskUrl`, את ה-`width` וה-`height` שלה, ואת `variants`, רשימה של `{ id, label, width, height, url }`.

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

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

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `image_url` או `image_asset_id` | string | תמונת הבסיס. |
| `intent` | string | מה יש בשכבה, כגון לוגו, כותרת, תג מחיר או קוד QR. עד 300 תווים. ברירת המחדל: לוגו. |
| `layer_aspect` | number | רוחב השכבה חלקי הגובה שלה, מ-0.05 עד 20. ברירת המחדל: `1`, ריבוע. |
| `safe_area` | object | האזור שתמיד נראה, כשברים מגודל התמונה: `x`, `y`, `w`, `h`. השכבה נשארת בתוכו. |

**מה חוזר:** `anchor`, `x`, `y` ו-`width`, באותן יחידות אחוזים כמו ב-`image_overlay`, ו-`reason` של משפט אחד.

## `image_to_text`
מתאר תמונה, או עונה על שאלה לגביה, בעזרת מודל ראייה. השתמשו בו לכיתובים, לטקסט חלופי, לניתוח סצנה או לשאלה מסוימת, כגון "list all the text in the image" (פרט את כל הטקסט שבתמונה). הכלי עובד כמו רכיב [תיאור תמונה](https://nodaro.ai/docs/nodes/image/describe-image).

**הרשאה:** `workflows:execute`. **קרדיטים:** קריאה אחת ל-LLM, שמחויבת לפי הטוקנים שהיא השתמשה בהם בפועל, בתעריף של המודל שעליו היא רצה. לפני הקריאה משוריינים קרדיטים, וכשהיתרה נמוכה מהשריון, הקריאה נדחית עם `402`. תיאור ארוך יותר עולה יותר. הכפתור **הרצה** בעורך מציג `≈N`, אומדן של קריאה טיפוסית. ראו את הסעיף [איך מחויבות קריאות LLM](https://nodaro.ai/docs/concepts/credits#llm-calls) בדף קרדיטים.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `image_url` או `image_asset_id` | string | התמונה לתיאור. |
| `detail_level` | string | `brief`, `detailed` (ברירת המחדל) או `comprehensive`. |
| `custom_prompt` | string | שאלה מסוימת במקום תיאור כללי, עד 2,000 תווים. |
| `llmModel` | string | מודל הראייה, אחד ממזהי ה-LLM שהכלי מפרט. ברירת המחדל: Claude Sonnet 5.5. |
| `reasoning_effort` | string | מ-`none` עד `max`. ברמה גבוהה יותר המודל כותב בדרך כלל יותר טוקני פלט, ולכן הקריאה עולה יותר. במודל Claude, עם כל רמת מאמץ הקריאה רצה בשירות של היצרן עצמו ומחויבת בתעריף של אותו שירות. |
| `advanced_mode`, `temperature`, `max_tokens` | | מודלי Gemini ו-Claude, כמו ב[כלי הפרומפטים](https://nodaro.ai/docs/mcp/tools/prompts-and-text#enhance_prompt). הקריאה מחויבת לפי טוקן, בתעריף של יצרן המודל עצמו. |

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

## `save_image_defaults`
שומר את הגדרות התמונה שאתם מעדיפים, כך שקריאות מאוחרות יותר ל-`generate_image` משתמשות בהן כשלא מבקשים אחרת. רק השדות שאתם שולחים משתנים. בלקוחות עם MCP Apps, התגית **Save as default** (שמירה כברירת מחדל) בכרטיס תמונה קוראת לכלי הזה.

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

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `model` | string או null | מודל ברירת המחדל שלכם. הערך `null` מוחק אותו וחוזר לברירת המחדל של הקטלוג. |
| `aspect_ratio` | string או null | יחס הגובה־רוחב שלכם כברירת מחדל. |
| `resolution` | string או null | הרזולוציה שלכם כברירת מחדל. |
| `quality` | string או null | האיכות שלכם כברירת מחדל. |

**מה חוזר:** אישור.

## `list_palettes`
מחזיר את פלטות הצבעים שלכם, מהחדש לישן: השם, כל צבע בשם יומיומי ובקוד ההקסדצימלי שלו, ההערה והמזהה. העבירו מזהה ל-`generate_image` בפרמטר `palette_id`.

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

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `cursor` | string | ה-cursor מהעמוד הקודם. |

**מה חוזר:** עמוד של פלטות, אותה רשימה ש-`GET /v1/palettes` מחזיר.

## `save_palette`
יוצר פלטה או משנה פלטה קיימת. כדי ליצור, שלחו `name` ו-`colors`. כדי לשנות פלטה, שלחו את ה-`id` שלה ורק את השדות שמשתנים.

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

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `id` | string | הפלטה לשינוי. השמיטו אותו כדי ליצור פלטה. |
| `name` | string | מ-1 עד 80 תווים. נדרש ליצירה. |
| `colors` | array | מ-2 עד 12 צבעים בפורמט `#RRGGBB`. נדרש ליצירה. הצבעים נשמרים באותיות גדולות. |
| `description` | string | הערה, עד 500 תווים. |

**מה חוזר:** הפלטה עם המזהה שלה. הכלי לא יכול למחוק פלטה. מחקו פלטות באפליקציה, ב-CLI או דרך ה-API.

## `list_moodboards`
מחזיר את המודבורדים שלכם, מהחדש לישן: השם, מספר התמונות, התיאור והמזהה. עם `id`, הכלי מחזיר מודבורד אחד עם הקישור והכיתוב של כל תמונה. העבירו מזהה ל-`generate_image` בפרמטר `moodboard_id`.

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

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `id` | string | קריאה של המודבורד הזה במלואו. |
| `cursor` | string | ה-cursor מהעמוד הקודם. |

**מה חוזר:** עמוד של מודבורדים, או מודבורד אחד, כמו ש-`GET /v1/moodboards` ו-`GET /v1/moodboards/:id` מחזירים אותם.

## `save_moodboard`
יוצר מודבורד או משנה מודבורד קיים. כדי ליצור, שלחו `name` ו-`images`. כדי לשנות מודבורד, שלחו את ה-`id` שלו ורק את השדות שמשתנים.

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

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `id` | string | המודבורד לשינוי. השמיטו אותו כדי ליצור מודבורד. |
| `name` | string | מ-1 עד 80 תווים. נדרש ליצירה. |
| `description` | string | עד 1,000 תווים. הרצה מכניסה את המילים האלה לפרומפט. |
| `images` | array | מ-1 עד 12 רשומות `{ url, caption }`. כל `url` הוא קישור לתמונה או מזהה של אחת מהתמונות שלכם ב-Nodaro. הכיתוב אופציונלי, עד 200 תווים. נדרש ליצירה. בשינוי, `images` מחליף את כל התמונות. |

**מה חוזר:** המודבורד עם המזהה שלו. התמונות נשמרות כקישורים, ואף פעם לא מועתקות. הכלי לא יכול למחוק מודבורד.

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

### באיזה מודל הכלי generate_image משתמש כברירת מחדל?

הכלי generate_image משתמש ב-GPT Image 2. כדי להחליף מודל, שלחו בפרמטר model מזהה אחר מ-list_models, למשל nano-banana-pro לטקסט קריא או gpt-image-2-5-flare לאיטרציות מהירות. מזהה לא מוכר מוחלף בברירת המחדל, בלי שגיאה.

### איך שומרים על אותו אדם בכמה תמונות?

שלחו את התמונות של האדם בפרמטר reference_image_urls, עד 14 כתובות או מזהים של Nodaro, והתשובה תאשר כמה תמונות צורפו. לדמות שמורה, שלחו את הפורטרט המאושר שהכלי get_character מחזיר.

### איך מסירים רקע או מגדילים תמונה דרך MCP?

השתמשו בכלי edit_image. תנו לפרמטר model את הערך recraft-remove-bg כדי לקבל PNG שקוף, או את הערך recraft-upscale או topaz-image-upscale כדי להגדיל את התמונה. אף אחת מהפעולות האלה לא צריכה פרומפט.

### האם עוזר AI יכול להוסיף לוגו או טקסט לתמונה בלי AI?

כן. הכלי image_overlay מציב תמונות, טקסט, קודי QR וצורות על תמונת בסיס, בדיוק ברמת הפיקסל ובלי מודל, תמורת 11 קרדיטים. הכלי suggest_overlay_placement יכול להציע קודם איפה למקם את הלוגו.

### כמה עולה יצירת תמונה דרך MCP?

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