Nodaro עם Make

Make יכול להתחיל כל תהליך Nodaro מתוך תרחיש ולקבל את התמונה, הסרטון או האודיו המוכנים ב-Webhook מותאם אישית. Nodaro מבצע את היצירה. Make מחליט מתי התהליך רץ ולאן התוצאה ממשיכה. אף אחד משני הכיוונים לא צריך מפתח API של Nodaro, כי כתובת ה-Webhook של התהליך עצמו מתחילה את ההרצה.

איך השניים מתחברים

1. המודול Make a request (שליחת בקשה) של אפליקציית HTTP שולח גוף JSON, למשל פרומפט, לכתובת ה-Webhook של תהליך Nodaro.
2. תהליך Nodaro מתחיל ברכיב טריגר Webhook, מריץ את הרכיבים שלו ומסתיים ברכיב פלט Webhook.
3. רכיב פלט Webhook שולח את התוצאה ל-Custom webhook (Webhook מותאם אישית) של Make, שמתחיל תרחיש שני עם התוצאה.

שלב 1: קבלת התוצאה ב-Make

צרו קודם את הצד המקבל, כי תהליך Nodaro צריך את הכתובת שלו.

1. צרו תרחיש והוסיפו את המודול Webhooks › Custom webhook בתור הטריגר שלו.
2. לחצו על Add (הוספה) לצד Webhook, תנו לו שם, למשל "Nodaro result" (תוצאת Nodaro), ולחצו על Save (שמירה).
3. העתיקו את כתובת ה-URL ש-Make יוצר. Make מאזין עכשיו ומחכה לבקשה הראשונה.

כל Webhook של Make שייך לתרחיש אחד. הפעילו את התרחיש כשהוא מוכן, כדי שיעבד כל תוצאה ברגע שהיא מגיעה.

שלב 2: בניית תהליך Nodaro

1. הוסיפו רכיב טריגר Webhook. תחת פרמטרי פלט, הוסיפו פרמטר בשם prompt מסוג טקסט.
2. חברו את הפלט prompt לקלט הפרומפט של רכיב יצירת תמונה, או של כל רכיב אחר שמייצר תוצאה.
3. הוסיפו רכיב פלט Webhook. הדביקו את כתובת ה-Webhook של Make בשדה כתובת Webhook. תחת פרמטרים של קלט, הוסיפו פרמטר image_url מסוג כתובת תמונה, וחברו אליו את התמונה.
4. שמרו את התהליך. סמנו את רכיב טריגר Webhook והעתיקו את הכתובת שלו תחת כתובת Webhook.

הכתובת היא בצורה https://app.nodaro.ai/v1/webhooks/<token>. האסימון עובד כמו סיסמה: כל מי שיש לו את הכתובת יכול להתחיל את התהליך.

שלב 3: התחלת ההרצה מ-Make

1. בתרחיש שאמור להתחיל את ההרצה, הוסיפו את המודול Make a request של אפליקציית HTTP.
2. הדביקו את הכתובת של Nodaro בשדה URL וקבעו את Method (שיטה) ל-POST.
3. קבעו את Body content type (סוג תוכן הגוף) ל-application/JSON ואת Body input method (שיטת הזנת הגוף) ל-Data structure (מבנה נתונים). הוסיפו שדה בשם prompt, ומפו את הערך ממודול מוקדם יותר.
4. קבעו את Parse response (פענוח התגובה) ל-Yes, כדי שהמודולים הבאים יוכלו למפות את executionId.

השיטה Data structure עושה escape לערכים שלכם. מחרוזת JSON גולמית עם ערכים ממופים יכולה להישבר כשערך מכיל מירכאות.

מה חוזר

Nodaro עונה לבקשה מיד, לפני שמשהו נוצר. התגובה היא 202 עם המזהה של ההרצה:

{ "executionId": "3f9e2b1a-7c6d-4e5f-8a9b-0c1d2e3f4a5b", "status": "pending" }

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

{ "image_url": "https://cdn.nodaro.ai/images/2538b658-d2e1-42ee-890a-72ce06089feb.png" }

כשמריצים את תהליך Nodaro פעם אחת בזמן שה-Webhook המותאם אישית מאזין, Make לומד את המבנה, כך ש-image_url הופך לשדה שאפשר למפות. אפשר גם להגדיר את המבנה ידנית בהגדרות המתקדמות של ה-Webhook.

תשאול במקום Webhook

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

1. אחרי מודול הבקשה, הוסיפו את המודול Tools › Sleep (המתנה), למשל ל-30 שניות.
2. הוסיפו מודול Make a request נוסף עם Method GET והכתובת https://app.nodaro.ai/v1/api/status/<executionId>, כש-executionId ממופה מהבקשה הראשונה.
3. לאסימון, בחרו את סוג האימות API key: שימו Bearer <your API token> בשדה Key, מקמו אותו בכותרת, ותנו לפרמטר את השם Authorization.
4. כשהסטטוס הוא completed, קראו ל-https://app.nodaro.ai/v1/api/result/<executionId> באותה דרך. התגובה מפרטת את הפלטים של ההרצה עם הכתובות שלהם.

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

מגבלות שכדאי להביא בחשבון

כמה זה עולה

רכיב טריגר Webhook ורכיב פלט Webhook לא עולים כלום. משלמים את הקרדיטים של הרכיבים שביניהם, באותם מחירים כמו בעורך. בדוגמה שלמעלה, כל הרצה עולה כמו תמונה אחת של Nano Banana 2, 22 קרדיטים. קרדיטים שמשוריינים לרכיב שנכשל חוזרים אוטומטית.

אותו דפוס עובד ב-n8n וב-Zapier. המדריך אוטומציות מכסה תזמונים ואת שאר הדרכים להתחיל תהליך.