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

> הציגו את מודלי Nodaro עם היכולות והמחירים שלהם בקרדיטים, קראו את היתרה וההוצאות שלכם, ומצאו, שמרו והחילו ערכות לרכיבים דרך עוזר AI.

Source: https://nodaro.ai/he/docs/mcp/tools/models-and-credits

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

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

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

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `kind` | string | `image`, `video` או `audio`. |
| `mode` | string | פעולה אחת, כגון `t2i` (טקסט לתמונה), `i2i`, `edit`, `upscale`, `remove-bg`, `i2v` (תמונה לווידאו), `t2v`, `v2v`, `extend`, `motion-transfer`, `lip-sync`, `video-upscale`, `tts`, `music`, `sfx`, `stt`, `voice-design`, `voice-changer`, `voice-changer-pro`, `isolation`, `dubbing`, `forced-alignment`, `video-analysis` או `video-audit`. |
| `family` | string | יצרן אחד, כגון `Google`, `OpenAI` או `Bytedance`. |
| `featuredOnly` | boolean | רק המודל הטוב ביותר בכל רמה, לפי הבחירה של צוות Nodaro. |
| `priceIds` | string[] | מחזיר מחירים במקום רשימת מודלים. בין 1 ל-50 מזהי מחיר. **ב-Nodaro Cloud בלבד.** ראו את הסעיף [בדיקת מחירים](#price-lookup). |

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

לכל מודל יש גם דף ב[קטלוג המודלים](https://nodaro.ai/docs/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](https://nodaro.ai/docs/concepts/credits#llm-calls) בדף קרדיטים.
- על מודל שעדיין אין לו מחיר, הכלי עונה `{ "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 בלבד.**

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `limit` | integer | מ-1 עד 100. |
| `cursor` | string | ה-cursor מהעמוד הקודם של הרכישות. |
| `usage_cursor` | string | ה-cursor מהעמוד הקודם של השימוש. |

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

- הרשימה `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 [היסטוריית התנועות](https://nodaro.ai/docs/developers/api/credits#transaction-history).

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

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

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `nodeType` | string | סוג הרכיב, למשל `generate-image`. נדרש כדי לכלול את הערכות המובנות. |
| `source` | string | `all` (ברירת המחדל) לערכות מובנות ולערכות שמורות, `factory` לערכות מובנות בלבד, `custom` לערכות שלכם בלבד. בלי `nodeType`, הכלי מחזיר את הערכות שלכם ורמז. |

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

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

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

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

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `nodeType` | string | **נדרש.** סוג הרכיב, למשל `generate-image`. |
| `presetId` | string | **נדרש.** מזהה של ערכה מובנית, כגון `generate-image/location-board`, או המזהה של ערכה שלכם. |

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

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

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

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `presetId` | string | אחת מהערכות שלכם, כדי לעדכן אותה. השמיטו אותו כדי ליצור ערכה. |
| `nodeType` | string | נדרש ליצירה, למשל `generate-image`. |
| `name` | string | נדרש ליצירה, עד 120 תווים. השם חייב להיות ייחודי בין הערכות של סוג הרכיב, אחרת הקריאה עונה `name_taken`. |
| `description` | string | אופציונלי, עד 500 תווים. |
| `data` | object | התצורה של הרכיב, 64 KB לכל היותר. נדרש ליצירה. |
| `previewUrl` | string או null | תמונת דוגמה: תמונה שכבר שמורה ב-Nodaro, כגון העלאה או תוצאה מוגמרת. הערך `null` מסיר אותה. |
| `expectedUpdatedAt` | string | ה-`updatedAt` של הערכה, כפי שקראתם אותו. העדכון נדחה עם `conflict` אם הערכה השתנתה מאז. |

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

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

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

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `presetId` | string | **נדרש.** אחת מהערכות שלכם. |
| `expectedUpdatedAt` | string | ה-`updatedAt` של הערכה, כפי שקראתם אותו. המחיקה נדחית אם הערכה השתנתה מאז. |

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

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

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `nodeType` | string | **נדרש.** סוג הרכיב, למשל `generate-image`. |
| `presetId` | string | **נדרש.** מזהה ערכה מ-`list_node_presets`. |
| `favorite` | boolean | ברירת המחדל: `true`. הערך `false` מסיר את הערכה מהמועדפים שלכם. |

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

## החלת ערכה על יצירה
הכלים `generate_image`, `generate_video`, `generate_music`, `generate_speech` ו-`text_to_audio` מקבלים `presetId`. Nodaro מחיל את התצורה של הערכה בשרת, וכל שדה שאתם שולחים בעצמכם גובר עליה. כשיש בערכה פרומפט, אפשר להשמיט את `prompt`. הטקסט שהערכה מוסיפה לפני הפרומפט ואחריו עוטף את הפרומפט שלכם. ב-`generate_image`, ערכה מוחלת בדיוק כמו שהעורך מחיל אותה, ומשתנה של הערכה שאין לו ברירת מחדל צריך ערך ב-`variables`. ראו את הסעיף [החלת ערכה](https://nodaro.ai/docs/mcp/tools/image#apply-a-preset) בדף תמונה.

ב-`generate_speech`, ערכה מכווננת את ההגשה, כגון המהירות, היציבות והסגנון, ועדיין צריך להעביר את `text`. מידע נוסף על ערכות בדף [ערכות](https://nodaro.ai/docs/concepts/presets).

## שאלות נפוצות

### איך עוזר AI בוחר את המודל המתאים?

העוזר קורא לכלי list_models עם סינון לפי הפרמטרים kind ו-mode, למשל image ו-t2i. התשובה מפרטת לכל מודל את יחסי הגובה־רוחב, הרזולוציות, האורכים, התכונות והמחירים שלו, וגם המלצות, כגון המודל הטוב ביותר לטקסט בתוך תמונות.

### האם עוזר AI יכול לראות כמה קרדיטים יש לי?

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

### האם הכלי credit_transactions מציג כמה עלתה כל יצירה?

כן. מלבד הרכישות שלכם, הכלי credit_transactions מחזיר גם את השימוש: שורה אחת לכל הרצה ששולמה מהקרדיטים שלכם. כדי לדעת כמה הוצאתם, סכמו את השדה credits_charged בשורות האלה, כי השדה credits_reserved הוא השריון, שיכול להיות גבוה יותר.

### איך משתמשים בערכה של רכיב דרך MCP?

מצאו את המזהה של הערכה עם הכלי list_node_presets, ואז העבירו אותו בפרמטר presetId לאחד מהכלים generate_image, generate_video, generate_music, generate_speech או text_to_audio. שדות שאתם שולחים בעצמכם גוברים על הערכה.

### האם עוזר AI יכול לשמור בשבילי ערכה של רכיב?

כן. הכלי save_node_preset יוצר או מעדכן ערכה שלכם מתצורה של רכיב, הכלי delete_node_preset מוחק ערכה, והכלי favorite_node_preset מוסיף ערכה למועדפים שלכם. שלושת הכלים צריכים את ההרשאה assets:write.