חיבור ל-Nodaro Cloud

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

מה החיבור מוסיף

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

אתם בוחרים כמה מהיצירה שלכם עוברת דרך החיבור: ראו את הסעיף בחירת אופן השימוש בחיבור.

חיבור ההתקנה שלכם

מעורבים שני חשבונות, ורק שניים: החשבון שלכם בשרת, ששמור במסד הנתונים של ההתקנה עצמה, וחשבון Nodaro Cloud שלכם.

• חיבור אחד לכל התקנה. החיבור שייך להתקנה, לא למשתמש. מי שלוחץ על חיבור מקשר את כל ההתקנה לחשבון Nodaro Cloud שלו.
• אסימון ל-90 ימים. האסימון שההתקנה מקבלת תקף 90 ימים ולא מתחדש אוטומטית. אחרי זה הכרטיס עדיין מציג ״מחובר״, אבל קריאות לענן נכשלות עם Token expired (האסימון פג). לחצו על ניתוק, ואז שוב על חיבור. ההתקנה משתמשת שוב ברישום שלה, ולכן החיבור מחדש לא נספר במגבלה על ניסיונות חיבור.
• עובד מיד. קונטיינר האפליקציה טוען את החיבור במלואו בהפעלה הבאה שלו. עד אז, המשימה הראשונה שלא מוצאת ספק בודקת את החיבור שוב בעצמה, ולכן גם לחיצה על הרצה מיד אחרי החיבור עובדת.
• נשמר בשרת. פרטי הגישה של ההתקנה אף פעם לא מגיעים לדפדפן שלכם. הם מוצפנים עם NODARO_ENCRYPTION_KEY, אותו מפתח שמגן על מפתחות ספק שהודבקו. בלי המפתח הזה, פרטי הגישה נשמרים בלי הצפנה, והאפליקציה רושמת אזהרה ביומן כשמחברים את ההתקנה.

בחירת אופן השימוש בחיבור

מיד אחרי החיבור, תיבת דו־שיח שואלת כיצד להשתמש ב-nodaro.ai? היא נפתחת אחרי לחיצה על הכפתור חיבור ואחרי הדבקה של מפתח API. אם סוגרים אותה בלי לבחור, חלות האפשרויות שנבחרו מראש.

• nodaro להכול (נבחרה מראש): כל יכולת שהחיבור מכסה רצה דרך Nodaro Cloud, והחיוב עובר לחשבון המחובר. בתוך האפשרות הזו, בוחרים מי גובר כשיש לכם גם מפתחות משלכם:
  • nodaro קודם (נבחרה מראש): ההתקנה מתעלמת משאר מפתחות הספק שלכם בכל מה ש-Nodaro Cloud מספק, והחיוב על הכול עובר לחשבון Nodaro Cloud שלכם.
  • המפתחות שלי קודם: הספקים שלכם מריצים מה שהם יכולים, ו-Nodaro Cloud משלים את החסר.
• רק הרכיבים הבלעדיים ל-Nodaro: רק הרכיבים הבלעדיים ל-Nodaro משתמשים בחיבור. כל השאר מתנהג כאילו החיבור לא קיים, עם שני חריגים שמתוארים בהמשך.

כדי לשנות את הבחירה, צרו חיבור חדש: לחצו על שינוי מפתח באריח nodaro.ai, או על ניתוק ואז על חיבור בכרטיס החיבור. תיבת הדו־שיח נפתחת שוב. אין לבחירה הזו הגדרה נפרדת. סקריפטים יכולים לקרוא ל-PUT /v1/nodaro-connect/prefs עם { "scope": "all" | "exclusives", "precedence": "nodaro" | "local" } מסשן מחובר של העורך; במהדורת Business, הסשן צריך להיות של מנהל.

שני כללים שומרים על ניתוב צפוי:

• חיבורים קודמים שומרים על הניתוב שלהם. התקנות שחוברו לפני שתיבת הדו־שיח הזו נוספה ממשיכות להריץ הכול עם האפשרות המפתחות שלי קודם, עד שמישהו פותח את תיבת הדו־שיח. הניתוב אף פעם לא משתנה בשקט.
• האפשרות nodaro קודם חלה גם על הרכיבים של ספקים ספציפיים. באפשרות nodaro קודם, רכיבי האווטאר, התאורה מחדש, גריפת האתרים והתמלול רצים דרך Nodaro Cloud גם כשיש לכם מפתח של אותו ספק. באפשרות המפתחות שלי קודם, המפתח שלכם לספק גובר.

אילו רכיבים משתמשים בחיבור

רכיבים שקוראים לספק ישירות

חלק מהרכיבים לא עוברים דרך נתב המודלים: ה-handlers שלהם קוראים ישירות לספק. אלה הרכיבים:

• אווטאר AI ואווטאר קולנועי
• תאורה מחדש והחלפה
• גריפת אתר
• רכיבי המוזיקה של Suno, כמו יצירת מוזיקה ב-Suno
• תמלול, ושלב התמלול של רכיבי הכתוביות
• יצירת תסריט

בהתקנה מחוברת שאין בה מפתח לספק הזה, ה-worker מריץ את המשימה באותו נתיב בחשבון Nodaro Cloud שלכם. אחר כך הוא מעתיק את התוצאה המוכנה לאחסון שלכם ורושם אותה כמשימה מקומית. חלונות בחירת האווטאר והקול של HeyGen מציגים באותו אופן את הקטלוג של Nodaro Cloud.

רכיבי Suno ורכיב יצירת תסריט מתעלמים מבחירת הניתוב. כשיש לכם מפתח משלכם, הם תמיד רצים מקומית: רכיבי Suno עם המפתח KIE_API_KEY, ורכיב יצירת תסריט עם KIE_API_KEY, ANTHROPIC_API_KEY או GEMINI_API_KEY. בלי מפתח כזה, הם תמיד רצים דרך החיבור. אלה שני החריגים באפשרות רק הרכיבים הבלעדיים ל-Nodaro.

רכיבי טקסט

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

• בלי מפתח למודל טקסט, כלומר בלי KIE_API_KEY, ANTHROPIC_API_KEY או GEMINI_API_KEY, הבקשה עוברת לאותו נתיב בחשבון Nodaro Cloud שלכם. התשובה נרשמת כמשימה במסד הנתונים שלכם, ולכן היא מופיעה בהיסטוריית ההרצות שלכם, ומזהה המשימה שלה עובד בהתקנה שלכם. מזהים שיש להם משמעות רק בהתקנה שלכם, כמו מזהי תהליכים ורכיבים, אף פעם לא יוצאים ממנה.
• עם מפתח למודל טקסט, הרכיב פועל לפי בחירת הניתוב שלכם: באפשרות nodaro קודם עונה Nodaro Cloud, ובאפשרות המפתחות שלי קודם עונה המפתח שלכם.

עיבוד מקומי

רכיבי עריכת וידאו ואודיו שמבוססים על ffmpeg תמיד רצים בשרת שלכם. רק שלב התמלול של רכיבי הכתוביות פועל לפי אותו כלל כמו רכיב תמלול.

הרכיבים הבלעדיים ל-Nodaro

חלק מהרכיבים ממומשים רק ב-Nodaro Cloud, כמו יצירת וידאו Pro, עריכת וידאו Pro, משנה קול Pro, ניתוח וידאו וביקורת AI. בהתקנה באירוח עצמי הם מופיעים בעורך עם הסימון NODARO ורצים דרך החיבור שלכם, עם אותן יכולות כמו ב-Nodaro Cloud. גם הפעולות עצירה ושמירת החלק שכבר נוצר והמשך ברכיב יצירת וידאו Pro זמינות.

• אין חיבור? הרכיבים עדיין מופיעים, והרכיב מציג את הכפתור חיבור ל-NODARO. הרצה נכשלת עם 503 nodaro_connection_required ועם אותה הוראה. תהליך שכולל את הרכיבים האלה תמיד נשמר: הבדיקה מתבצעת רק בזמן ההרצה.
• חיוב. ההרצות מחויבות לחשבון Nodaro Cloud המחובר. כשמחברים את ההתקנה עם הכפתור חיבור, חלה התקרה החודשית של ההתקנה. עם מפתח API אישי, ההתקנה משתמשת בחשבון כמו שהוא. חשבון חינמי שומר על המגבלות הרגילות שלו ועל סימן המים עד הרכישה הראשונה שלו, ואין תקרה לכל התקנה.

הפייפליין סיפור ← וידאו זמין רק ב-Nodaro Cloud. הוא מנוע אינטראקטיבי, לא רכיב שאפשר להריץ דרך החיבור.

או שימוש במפתח API, כמו בכל ספק אחר

Nodaro Cloud הוא גם ספק במובן הרגיל, עם אריח בדף /setup כמו כל ספק אחר. כדי לוותר על זרימת ה-OAuth:

1. ב-app.nodaro.ai, פתחו את הגדרות › מפתחות API וצרו אסימון API אישי.
2. בהתקנה שלכם, הדביקו אותו באריח nodaro.ai. האסימון נכנס לתוקף מיד, האריח מציג key set (app) (מפתח הוגדר באפליקציה), ואפשר לשנות או להסיר אותו כמו כל מפתח שהודבק. תיבת הדו־שיח של הניתוב נפתחת אחרי ההדבקה.

בהתקנה ללא ממשק או בתשתית כקוד (IaC), הגדירו אותו במקום זאת ב-.env והפעילו מחדש את קונטיינר האפליקציה:

NODARO_API_KEY=ndr_...

בשתי הדרכים, היצירה רצה דרך חשבון Nodaro Cloud שהאסימון שייך לו, לפי בחירת הניתוב שלכם.

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

ניהול התקנות מחוברות ב-Nodaro Cloud

ב-app.nodaro.ai, פתחו את חיוב › מופעים מחוברים. בעל החשבון רואה כל התקנה מחוברת עם ההוצאה שלה החודש, ויכול:

• להגדיר תקרת הוצאה חודשית לכל התקנה, בין 100 ל-1,000,000 קרדיטים, או להשאיר את השדה ריק כדי שלא תהיה תקרה. התקרה נשמרת אוטומטית. כשההוצאה עוברת את התקרה, ההרצות של ההתקנה נכשלות עם 402 instance_cap_reached.
• לנתק התקנה בלחיצה על ניתוק. האסימונים שלה מפסיקים לעבוד מיד.

לחיצה על ניתוק בהתקנה שלכם רק מוחקת את האסימון המקומי. ההתקנה שומרת את הרישום שלה, ולכן הלחיצה הבאה על חיבור משתמשת בו שוב. כדי לנתק את הגישה לגמרי, נתקו את ההתקנה ב-Nodaro Cloud.

גם בדף הגדרות › אפליקציות מחוברות ב-app.nodaro.ai מופיעה כל התקנה מחוברת, בשם התקנה בשרת עצמאי, לצד שאר האפליקציות שיש להן גישה לחשבון. גם לחיצה על ביטול גישה שם מסיימת מיד את הגישה של ההתקנה.

כשהחיבור נכשל

• Nodaro Cloud לא מקבל חיבורים, או שאי אפשר להגיע אליו. הכפתור מציין זאת במקום, עם cloud_connect_unavailable כשהחיבורים סגורים. הבעיה נובעת מ-Nodaro Cloud או מהרשת שלכם. מפתחות הספק שלכם, כולל NODARO_API_KEY, ממשיכים לעבוד.
• יותר מדי ניסיונות חיבור שלא הושלמו מהכתובת הזו ב-24 השעות האחרונות. כל לחיצה על חיבור רושמת את ההתקנה ב-Nodaro Cloud, ורישומים שאף אחד לא אישר פגים אחרי יום. אחרי 10 רישומים כאלה מכתובת אחת ביום, Nodaro Cloud משהה את הכתובת הזו. השלימו את חלון ההסכמה שכבר פתחתם, או חכו. בינתיים, הדבקה של מפתח ספק משלכם עובדת. חיבור מחדש אחרי ניתוק לא נספר.
• קריאות לענן נכשלות עם Token expired (האסימון פג). תוקף האסימון ל-90 ימים פג. לחצו על ניתוק, ואז על חיבור.
• מסך ההסכמה לא חוזר להתקנה שלכם. הגדירו ב-PUBLIC_URL את הכתובת האמיתית של ההתקנה. כתובת ההפניה של OAuth רשומה בתור <PUBLIC_URL>/v1/nodaro-connect/callback.

מדריך התצורה

המשתנה R2_SHARED_WITH_RELAY_TARGET משנה גם את רכיב שמירה לאחסון: כשהקלט שלו כבר אובייקט ב-bucket, הרכיב שומר מצביע לאובייקט במקום עותק. מחיקה של פריט הספרייה של אותו קלט מוחקת אז גם את האובייקט שהפריט השמור מצביע עליו. קובץ ה-Compose לא מעביר את המשתנה הזה מ-.env: הוסיפו אותו תחת environment: של השירות nodaro.