תיעוד Nodaroתמונה
כלי התמונה של Nodaro ב-MCP: יצירה, המרה, עריכה, מסכות, שילוב שכבות ותיאור של תמונות דרך עוזר AI, עם הפרמטרים, ברירות המחדל והקרדיטים.
כלי התמונה מאפשרים לעוזר AI ליצור ולשנות תמונות ב-Nodaro: ליצור תמונה מפרומפט, להמיר או לערוך תמונה קיימת, ליצור מסכה, לשלב כמה תמונות או שכבות, ולתאר מה רואים בתמונה. כל כלי חוץ מ-suggest_overlay_placement, מ-save_image_defaults ומכלי הפלטות והמודבורדים מתחיל משימה ומחזיר את המזהה שלה, והתוצאה נשמרת בספרייה שלכם. כל כלי תמונה, חוץ מכלי הפלטות והמודבורדים, צריך את ההרשאה workflows:execute.
| כלי | מה הוא עושה | קרדיטים |
|---|---|---|
generate_image | טקסט לתמונה, עם ייחוסים והשלמה אופציונלית | המחיר של המודל |
modify_image | עורך תמונה קיימת, משנה את הסגנון שלה או ממיר אותה | המחיר של המודל |
image_to_image | תמונה לתמונה לפי פרומפט, עם מסכות וכמה ייחוסים | המחיר של המודל |
edit_image | הגדלה, הסרת רקע ועריכות ממוקדות | המחיר של הפעולה |
generate_mask | מסכה בשחור־לבן של מה שאתם מתארים | 55 |
image_collage | 2–30 תמונות בתמונה גדולה אחת | 22 ב-2K, 44 ב-4K |
image_overlay | לוגואים, טקסט, קודי QR וצורות על תמונה, בלי AI | 11, ויותר עם גדלים נוספים |
suggest_overlay_placement | איפה למקם לוגו או טקסט על תמונה | תיאור תמונה אחד |
image_to_text | תיאור של תמונה, או תשובה לשאלה עליה | לפי הטוקנים שנעשה בהם שימוש, בתעריף של המודל |
save_image_defaults | מודל התמונה וההגדרות שלכם כברירת מחדל | חינם |
list_palettes, save_palette | פלטות הצבעים שלכם, כדי לכוון את generate_image | חינם |
list_moodboards, save_moodboard | המודבורדים שלכם, כדי לכוון את generate_image | חינם |
generate_image
יוצר תמונה מפרומפט טקסט עם אחד ממודלי התמונה של Nodaro. זה הכלי שמאחורי בקשות כגון ״צור תמונה של…״, והוא עובד כמו רכיב יצירת תמונה.
הרשאה: workflows:execute. קרדיטים: המחיר של המודל ברזולוציה או באיכות שנבחרו.
| פרמטר | סוג | הערות |
|---|---|---|
prompt | string | תיאור התמונה, עד 4,000 תווים. נדרש, אלא אם ערכה מספקת אותו. |
model | string | מזהה המודל. ברירת המחדל: gpt-image-2. מזהה לא מוכר מוחלף בברירת המחדל. ראו את הכלי 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, שמוחלת כמו שהעורך מחיל אותה. שדות שאתם שולחים גוברים עליה. ראו את הסעיף החלת ערכה. |
variables | object | ערכים למשתנים של ערכה שאין להם ברירת מחדל, למשל { "BRAND": "Acme" }. |
palette_id | string | פלטה מ-list_palettes. הצבעים שלה מצוינים בשמם בפרומפט. |
moodboard_id | string | מודבורד מ-list_moodboards. התיאור שלו מתווסף לפרומפט, והתמונות שלו נשלחות למודל כייחוסי סגנון. |
subject | object | מי מופיע בתמונה, כמזהים מהקטלוג, בצורה { field: id } או { field: [ids] }. השדות הם שדות האדם והסטיילינג, heldProp, material ו-animal, מ-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 הופכות לתהליכים. |
flow_id | string | הערך "new" מתחיל תהליך חדש לשלב הזה. מזהה תהליך מתוצאה קודמת מוסיף את השלב לתהליך הזה. עד 36 תווים. ראו את הסעיף התחלה או בחירה של תהליך בעצמכם בדף שיחות 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
עורך תמונה קיימת, משנה את הסגנון שלה או ממיר אותה לפי פרומפט: שינוי צבע, החלפת רקע, החלת סגנון, הרחבת התמונה או צביעה מחדש של חלק ממנה. הכלי עובד כמו רכיב עריכת תמונה.
הרשאה: 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 הופכות לתהליכים. |
flow_id | string | הערך "new" מתחיל תהליך חדש לשלב הזה. מזהה תהליך מתוצאה קודמת מוסיף את השלב לתהליך הזה. עד 36 תווים. ראו את הסעיף התחלה או בחירה של תהליך בעצמכם בדף שיחות 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 הופכות לתהליכים. |
flow_id | string | הערך "new" מתחיל תהליך חדש לשלב הזה. מזהה תהליך מתוצאה קודמת מוסיף את השלב לתהליך הזה. עד 36 תווים. ראו את הסעיף התחלה או בחירה של תהליך בעצמכם בדף שיחות 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 אופציונלי |
| מודל | יצרן | מצבים | קרדיטים | פרטים |
|---|---|---|---|---|
| Recraft Crisp Upscale | Recraft | הגדלת תמונה | 3 | הגדלת תמונה קלת משקל (Recraft Crisp). |
| Topaz Image Upscale | Topaz | הגדלת תמונה | החל מ-28 | הגדלת תמונה באיכות גבוהה ב-1× (שיפור בלבד), ב-2× או ב-4×. הטוב ביותר לפלט מוכן להפקה. |
| Recraft Remove BG | Recraft | הסרת רקע | 4 | הסרת הרקע מתמונה. כלי עזר זול. |
| Nano Banana Edit | עריכת תמונה | 11 | עריכות תמונה לתמונה עם משפחת Nano Banana של Google. עורך טוב לכל מטרה. | |
| Grok Imagine 2 Segment Map | xAI | עריכת תמונה | 0 | מפת סגמנטציה סמנטית, בחינם, של יצירה קודמת של grok-2 — מסכות אזורים בעלי שם, שהאינדקסים שלהן מזינים את מיקוד האזורים של grok-2-edit. |
| Grok Imagine 2 Edit | xAI | עריכת תמונה | 11 | עריכה בפרומפט של יצירה קודמת של grok-2, לפי מזהה המשימה. אינדקסים אופציונליים של מסכות (מ-grok-2-segment) מגבילים את העריכה לאזורים בעלי שם. |
| פרמטר | סוג | הערות |
|---|---|---|
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. הכלי עובד כמו רכיב יצירת מסכה.
הרשאה: 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 משתמשת בתאים שווים וממלאת את השטח הריק בצבע הרקע. הכלי עובד כמו רכיב קולאז׳ תמונות, ומתאים לסטוריבורדים ולגיליונות קונטקט.
הרשאה: 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 לא רץ, ולכן התוצאה זהה בכל פעם. הכלי עובד כמו רכיב שכבת תמונה, והדף של הרכיב מתאר כל אפשרות.
הרשאה: workflows:execute. קרדיטים: 11, ועוד קצת על כל גודל פלטפורמה נוסף ב-variants, כמו ברכיב שכבת תמונה.
| פרמטר | סוג | הערות |
|---|---|---|
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" (פרט את כל הטקסט שבתמונה). הכלי עובד כמו רכיב תיאור תמונה.
הרשאה: workflows:execute. קרדיטים: קריאה אחת ל-LLM, שמחויבת לפי הטוקנים שהיא השתמשה בהם בפועל, בתעריף של המודל שעליו היא רצה. לפני הקריאה משוריינים קרדיטים, וכשהיתרה נמוכה מהשריון, הקריאה נדחית עם 402. תיאור ארוך יותר עולה יותר. הכפתור הרצה בעורך מציג ≈N, אומדן של קריאה טיפוסית. ראו את הסעיף איך מחויבות קריאות LLM בדף קרדיטים.
| פרמטר | סוג | הערות |
|---|---|---|
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, כמו בכלי הפרומפטים. הקריאה מחויבת לפי טוקן, בתעריף של יצרן המודל עצמו. |
מה חוזר: מזהה משימה. הטקסט נמצא בפלט של המשימה, והכרטיס מציג אותו עם הכפתור 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 וכל דף מודל מציגים את מספר הקרדיטים המדויק.
דפים קשורים
יצירת תמונה
עריכת תמונה
שכבת תמונה
וידאו
בחירת מודל
עודכן לאחרונה