Nodaro עם n8n

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

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

1. רכיב HTTP Request (בקשת HTTP) של n8n שולח גוף JSON, למשל פרומפט, לכתובת ה-Webhook של תהליך Nodaro.
2. תהליך Nodaro מתחיל ברכיב טריגר Webhook, מריץ את הרכיבים שלו ומסתיים ברכיב פלט Webhook.
3. רכיב פלט Webhook שולח את התוצאה לרכיב Webhook של n8n, ושאר תהליך ה-n8n שלכם ממשיך משם.

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

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

1. ב-n8n, הוסיפו רכיב Webhook.
2. קבעו את HTTP Method (שיטת HTTP) ל-POST, והגדירו לרכיב Path (נתיב), למשל nodaro-result.
3. השאירו את Respond (תגובה) על Immediately (מיד), כדי ש-n8n יענה ל-Nodaro מיד.
4. העתיקו את Production URL (כתובת הפרודקשן).

n8n רושם את ה-Production URL כשמפרסמים את תהליך ה-n8n. ה-Test URL (כתובת הבדיקה) מאזין רק 120 שניות אחרי שבוחרים Listen for test event (האזנה לאירוע בדיקה), ולכן השתמשו בו רק בזמן הבנייה.

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

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

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

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

1. ב-n8n, הוסיפו רכיב HTTP Request במקום שבו ההרצה אמורה להתחיל.
2. קבעו את Method (שיטה) ל-POST והדביקו את הכתובת של Nodaro בשדה URL.
3. הפעילו את Send Body (שליחת גוף), קבעו את Body Content Type (סוג תוכן הגוף) ל-JSON, ובחרו Using JSON (באמצעות JSON) תחת Specify Body (הגדרת הגוף).
4. הקלידו את הגוף. המפתחות הם השמות של פרמטרי הפלט שלכם:

{ "prompt": "{{ $json.prompt }}" }

דרך מהירה יותר: בחרו Import cURL (ייבוא cURL) ברכיב HTTP Request והדביקו את הפקודה הזאת עם האסימון שלכם:

curl -X POST "https://app.nodaro.ai/v1/webhooks/<token>" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "A red kite over a green hill, morning light"}'

מה חוזר

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

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

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

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

ב-n8n, הגוף שמתקבל נמצא תחת body, ולכן הרכיב הבא קורא את הכתובת בתור {{ $json.body.image_url }}.

תשאול במקום Webhook

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

1. השאירו את רכיב HTTP Request משלב 3. הוא מחזיר את executionId.
2. הוסיפו רכיב Wait (המתנה) עם Resume (המשך) שמוגדר ל-After Time Interval (אחרי פרק זמן), למשל 10 שניות.
3. הוסיפו רכיב HTTP Request עם Method GET והכתובת https://app.nodaro.ai/v1/api/status/{{ $json.executionId }}. שלחו את הכותרת Authorization עם הערך Bearer <your API token>, ושמרו את הערך כפרטי גישה ב-n8n.
4. הוסיפו רכיב If (תנאי). את הענף שבו status הוא pending או running חברו בחזרה לרכיב Wait.
5. כשהסטטוס הוא completed, קראו ל-https://app.nodaro.ai/v1/api/result/<executionId> באותה דרך. התגובה מפרטת את הפלטים של ההרצה עם הכתובות שלהם.

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

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

כמה זה עולה

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

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