מודלים, קרדיטים וערכות

כלי המודלים, הקרדיטים והערכות מסייעים לעוזר AI לבחור איך ליצור ולשלם על היצירה בצורה מושכלת. הכלי list_models מחזיר כל מודל עם היכולות והמחירים שלו, check_balance ו-credit_transactions מציגים את הקרדיטים שלכם ב-Nodaro Cloud, וכלי הערכות מוצאים, שומרים ומחילים את התצורות המוכנות של רכיב.

list_models

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

הרשאה: אין, הכלי תמיד גלוי. קרדיטים: חינם.

מה חוזר: לכל מודל, השדה maker בצורה { id, name }, כלומר החברה שיצרה אותו, ויחסי הגובה־רוחב, הרזולוציות, רמות האיכות, האורכים והתכונות שלו, ובמהדורות עם קרדיטים, גם המחיר של כל וריאנט. הרשימה recommendations מציינת את המודלים הטובים ביותר לשימושים נפוצים, כגון טקסט בתוך תמונות או התמונה הריאליסטית הזולה ביותר. למודלים שיש להם עצות פרומפט ייעודיות, כגון Seedance 2.0, יש גם promptTips: כללים קצרים שכדאי ליישם לפני יצירת וידאו. הלוגו של היצרן (logoUrl) לא נכלל בתשובה הזו: הוא מיועד לאפליקציות שמציגות תפריט בחירת מודל, ו-GET /v1/models מחזיר אותו.

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

בדיקת מחירים

העבירו את priceIds כדי לקבל מחירים במקום רשימת מודלים. הכלי עונה { "prices": { "<id>": … } }, עם אותם מספרים ש-POST /v1/credits/model-costs מחזיר.

• המחיר של קריאת LLM בכל מודל נבדק לפי מפתח המחיר שלה, <feature>:<model id>, למשל llm-chat:claude-sonnet-5.5 או reduce:pick-best-llm:claude-opus-5.5. הוסיפו :direct כשהקריאה רצה בשירות של יצרן המודל עצמו, כמו במצב מתקדם.
• על מפתח של LLM, הכלי עונה { "credits": N, "estimate": true }. המספר הוא המחיר של קריאה טיפוסית של היכולת הזו במודל הזה. הקריאה מחויבת לפי הטוקנים שהיא השתמשה בהם בפועל, ולכן הציגו את המספר כ-≈N. ראו את הסעיף איך מחויבות קריאות LLM בדף קרדיטים.
• על מודל שעדיין אין לו מחיר, הכלי עונה { "error": "llm_model_unpriced" }, והרצה במודל הזה נדחית.
• על כל מזהה אחר, הכלי עונה במחיר שגובים עליו, { "credits": N }, או ב-{ "error": "not_priced" }.
• במהדורה בלי קרדיטים, הבדיקה נדחית עם no_credit_system.

check_balance

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

הרשאה: credits:read. קרדיטים: חינם. ב-Nodaro Cloud בלבד.

לכלי הזה אין פרמטרים.

מה חוזר: היתרה ופרטי התוכנית.

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

credit_transactions

מחזיר את שני יומני הקרדיטים שלכם: הרכישות שלכם והשימוש שלכם.

הרשאה: credits:read. קרדיטים: חינם. ב-Nodaro Cloud בלבד.

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

• הרשימה data: הרכישות האחרונות שלכם, כגון מנויים, טעינות והחזרים. בכל שורה יש type, amount_usd, credits_granted, tier, created_at ו-receipt_url, הקישור לקבלה כשיש כזו. הדפדוף בין העמודים נעשה עם next_cursor.
• הרשימה usage: ההוצאות האחרונות שלכם, שורה אחת לכל הרצה ששולמה מהקרדיטים שלכם. אלה אותן שורות שה-REST API מחזיר ב-GET /v1/credits/transactions, עם אותם שדות. בעמוד יש 50 שורות לכל היותר, והדפדוף בין העמודים נעשה עם usage.next_cursor, שמעבירים בפרמטר usage_cursor.

בשורת שימוש:

• השדה credits_charged הוא כמה ההרצה עלתה. הערך הוא null כל עוד הקרדיטים שלה עדיין משוריינים, ו-0 אחרי שהם הוחזרו. כדי לחשב את ההוצאות שלכם, סכמו את השדה הזה.
• השדה credits_reserved, שנקרא גם credits_used, הוא השריון שנלקח כשההרצה התחילה. בהרצה שהחיוב הסופי שלה נמוך מהשריון, למשל בגלל אורך שנמדד או תקרה לרינדורים חוזרים, השדה הזה עדיין מציג את כל השריון.
• השדות action, provider, status (reserved, committed או refunded), metadata, payer ו-workspaceId זהים לשדות ב-REST API. ראו בדף ה-API היסטוריית התנועות.

list_node_presets

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

הרשאה: presets:read. קרדיטים: חינם.

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

• השדות needsImage: true ו-minReferences: ערכה כגון גיליון ייחוס, שינויי פורטרט או תבנית פרומפט שמשתמשת ב-{image:N} עובדת על מספר כזה של תמונות מחוברות. הריצו אותה עם מספר כזה של תמונות ייחוס.
• הערך favorite: true: הערכה היא אחת מהמועדפות שלכם.
• השדה previewUrl: תמונת דוגמה. העוזר שבתוך האפליקציה לא מקבל אותה.

get_node_preset

מחזיר את התצורה המלאה של ערכה אחת: המודל, הפרומפט, יחס הגובה־רוחב, הרזולוציה, האיכות, הפרומפט השלילי והטקסט שהיא מוסיפה לפני הפרומפט ואחריו. השתמשו בו כדי להחיל ערכה במדויק, בהעתקת השדות לכלי יצירה או בהעברת המזהה שלה כ-presetId.

הרשאה: presets:read. קרדיטים: חינם.

מה חוזר: התצורה של הערכה, עם minReferences, needsImage, favorite ו-previewUrl (null כשאין לערכה תמונה). כשהמזהה לא מתאים לאף ערכה, חוזרת שגיאה.

save_node_preset

שומר אחת מהערכות שלכם. כדי ליצור ערכה, העבירו את nodeType, את name ואת data, תצורה של רכיב כמו זו ש-get_node_preset מחזיר. כדי לעדכן ערכה, העבירו את presetId ורק את מה שמשתנה.

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

מה חוזר: המזהה, השם, needsImage, minReferences, previewUrl ו-updatedAt של הערכה השמורה. אותה פעולה זמינה גם ב-POST /v1/node-presets וב-PATCH /v1/node-presets/:id.

delete_node_preset

מוחק אחת מהערכות שלכם. אי אפשר למחוק ערכות מובנות. על ערכה שלא שייכת לכם, הכלי עונה not_found.

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

favorite_node_preset

מוסיף ערכה למועדפים שלכם, או מסיר אותה עם favorite: false. הערכה יכולה להיות מובנית, כגון generate-image/character-board, או אחת משלכם. המועדפות מופיעות ראשונות ברשימת הערכות בעורך. שתי קריאות לכלי משפיעות בדיוק כמו קריאה אחת.

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

אין כלי שמנהל תיקיות של ערכות, את סדר הערכות או ייבוא מרוכז. הפעולות האלה מארגנות את הרשימות בעורך, וה-REST API, ה-SDK וה-CLI מציעים אותן.

החלת ערכה על יצירה

הכלים generate_image, generate_video, generate_music, generate_speech ו-text_to_audio מקבלים presetId. Nodaro מחיל את התצורה של הערכה בשרת, וכל שדה שאתם שולחים בעצמכם גובר עליה. כשיש בערכה פרומפט, אפשר להשמיט את prompt. הטקסט שהערכה מוסיפה לפני הפרומפט ואחריו עוטף את הפרומפט שלכם. ב-generate_image, ערכה מוחלת בדיוק כמו שהעורך מחיל אותה, ומשתנה של הערכה שאין לו ברירת מחדל צריך ערך ב-variables. ראו את הסעיף החלת ערכה בדף תמונה.

ב-generate_speech, ערכה מכווננת את ההגשה, כגון המהירות, היציבות והסגנון, ועדיין צריך להעביר את text. מידע נוסף על ערכות בדף ערכות.