# פקודות

> פקודות הליבה ב-CLI של Nodaro והדגלים שלהן: פרויקטים, תהליכים, אפליקציות, רכיבים, מודלים, ערכות, פלטות, משימות, גלריה, Webhooks, חיוב ו-Recast.

Source: https://nodaro.ai/he/docs/developers/cli/commands

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

כל הדוגמאות מניחות ש[התקנתם את ה-CLI והתחברתם](https://nodaro.ai/docs/developers/cli).

## קבוצות הפקודות
| קבוצה | מה היא עושה | איפה היא מתועדת |
| --- | --- | --- |
| `auth` | התחברות, הצגה והסרה של פרופילים | [CLI](https://nodaro.ai/docs/developers/cli#sign-in) |
| `projects` | יצירה, קריאה, עדכון ומחיקה של פרויקטים | הדף הזה |
| `sessions` | סשנים של יצירה בתוך פרויקטים | הדף הזה |
| `workflows` | ניהול, ייצוא, ייבוא, הרצה ושיתוף של תהליכים | הדף הזה |
| `apps` | עיון באפליקציות שפורסמו והרצה שלהן | הדף הזה |
| `nodes` | רשימת סוגי הרכיבים והרצה של רכיב יחיד | הדף הזה |
| `models` | עיון בקטלוג המודלים ובמזהי המחירים | הדף הזה |
| `billing` | תוכניות ומחירים, המנוי שלכם ונתוני השימוש וההיסטוריה של הקרדיטים שלכם | הדף הזה |
| `pickers` | קריאת קטלוגי הבוררים ומילוי בוררים מתוך תיאור | הדף הזה |
| `presets` | הערכות השמורות, המועדפים והתיקיות שלכם, וגם קטלוג הערכות המובנות | הדף הזה |
| `palettes`, `moodboards` | הפלטות והמודבורדים שלכם לרכיב יצירת תמונה | הדף הזה |
| `catalog` | תחזוקה של חבילות הקטלוג של פריסה, בלי חיבור לרשת | הדף הזה |
| `executions`, `jobs` | בדיקה, סינון, דירוג וביטול של הרצות | הדף הזה |
| `gallery` | הגלריה הציבורית והמועדפים שלכם | הדף הזה |
| `webhooks` | נקודות קצה ש-Nodaro קורא להן כשמשימה מסתיימת | הדף הזה |
| `video-pro` | עצירה והמשך של הרצות של רכיב יצירת וידאו Pro | הדף הזה |
| `prompt` | הפיכת רעיון גולמי לפרומפט משופר | הדף הזה |
| `shots` | יצירה וקריאה של רשומות שוטים לשיתוף | הדף הזה |
| `recast` | תכנון ורינדור של הרצת Recast, או ייבוא של תסריט | הדף הזה |
| `trends` | הרצת מתכון מוכן של Nodaro Motion עם התמונות שלכם | הדף הזה |
| `cast-swap` | השלמה באיכות מלאה של הרצת Nodaro Motion או של הרצת טרנד | הדף הזה |
| `characters`, `locations`, `objects` | ניהול נכסים ויצירת התמונות והתנועה שלהם | [פקודות נכסים](https://nodaro.ai/docs/developers/cli/asset-commands) |
| `voice`, `media`, `audio`, `edit` | החלפת קול, הוספת כתוביות, הרכבה ועריכה של מדיה | [פקודות מדיה וקול](https://nodaro.ai/docs/developers/cli/media-commands) |
| `org`, `workspace` | ארגונים, הזמנות, סביבות עבודה ודוחות שימוש | [סביבות עבודה וארגונים](https://nodaro.ai/docs/developers/cli/workspaces) |

## דגלים שכל פקודה מקבלת
- הדגל `--profile <name>` מריץ את הפקודה עם פרופיל ששמרתם, במקום פרופיל ברירת המחדל.
- הדגל `--json` מדפיס פלט קריא למכונה, בכל פקודה שקוראת נתונים. ראו את הדף [פלט וקודי יציאה](https://nodaro.ai/docs/developers/cli/output).
- הדגל `--workspace <id>` גלובלי. הוא קובע את סביבת העבודה לפקודה הזו בלבד. ראו את הדף [סביבות עבודה וארגונים](https://nodaro.ai/docs/developers/cli/workspaces).
- הדגל `-v` או `--version` מדפיס את הגרסה של ה-CLI.

בתחביר הפקודות שלמטה, הסימון `<value>` הוא ערך שאתם מספקים, הסימון `[...]` הוא חלק אופציונלי והסימון `a|b` פירושו אחד מהערכים שברשימה.

## פרויקטים
```bash
nodaro projects list [--json]
nodaro projects get <id> [--json]
nodaro projects create --name <name> [--description <desc>] [--json]
nodaro projects update <id> [--name <name>] [--description <desc>] [--json]
nodaro projects delete <id> [--json]
```

## סשנים
סשן של יצירה מקבץ יצירות בודדות בתוך פרויקט. הפריטים שלו הם קישורים למשימות שלכם, לא עותקים שלהן. ראו את הסעיף [`client.sessions`](https://nodaro.ai/docs/developers/sdk/workflows#clientsessions) בדף תהליכים ופרויקטים.

```bash
nodaro sessions list [--project <id>] [--tool <tool>] [--archived] [--limit <n>] [--cursor <c>] [--json]
nodaro sessions get <id> [--json]
nodaro sessions items <id> [--limit <n>] [--cursor <c>] [--json]
nodaro sessions create --tool <tool> [--project <id>] [--title <title>] [--json]
nodaro sessions update <id> [--title <title> | --untitled] [--archive | --unarchive] [--cover <jobId> | --auto-cover] [--json]
nodaro sessions import <id> --jobs <id,id,...> [--json]
nodaro sessions remove <id> <jobId> [--json]
nodaro sessions delete <id> [--json]
```

- הפקודה `import` מקשרת משימות לסשן. הפעולה היא הכול או כלום: משימה אחת שלא שייכת לכם מכשילה את כל הקריאה.
- הפקודה `remove` מסירה רק את הקישור. המשימה נשארת, וגם סשנים אחרים שהיא נמצאת בהם לא משתנים.
- הפקודה `delete` מוחקת את הסשן. המשימות שלו נשמרות.
- הפקודה `update --cover` בוחרת את אחד הפריטים של הסשן שיופיע ראשון בתצוגות המקדימות שלו. הדגל `--auto-cover` מחזיר את התצוגות המקדימות לפריטים החדשים ביותר.

## תהליכים
```bash
nodaro workflows list --project <projectId> [--json]
nodaro workflows get <id> [--json]
nodaro workflows create --project <projectId> --name <name> [--file bundle.json] [--json]
nodaro workflows update <id> [--name <name>] [--file nodes-edges.json] [--json]
nodaro workflows delete <id> [--json]
nodaro workflows export <id> [--with-assets] [--output bundle.json]
nodaro workflows import <file> --project <projectId> [--json]
nodaro workflows run <id> [--watch] [--node n1 n2 ...] [--json]
nodaro workflows run <id> --continue-from <executionId> --from-failed [--node n1 n2 ...] [--idempotency-key <key>] [--watch]
nodaro workflows run <id> --continue-from <executionId> --node n1 n2 ... [--override n1.quality=final ...] [--watch]
nodaro workflows run <id> --next <json|file|-> [--idempotency-key <key>] [--watch]
nodaro workflows render-final <id> --from <executionId> [--render <nodeId>] [--estimate] [--watch] [--json]
```

| דגל | מה הוא עושה |
| --- | --- |
| `create --file` | יוצר את התהליך מחבילת תהליך שיוצאה. |
| `update --file` | כותב לתהליך את הרכיבים, החיבורים וההגדרות שבקובץ JSON. |
| `export --with-assets` | מוסיף לחבילה את הנתונים של הדמויות, האובייקטים והמיקומים שהתהליך משתמש בהם. |
| `export --output` | כותב את החבילה לקובץ במקום להדפיס אותה. |
| `run --node` | מריץ רק את הרכיבים שציינתם, לפי המזהים שלהם, מופרדים ברווחים. |
| `run --watch` | בודק את מצב ההרצה עד שהיא מסתיימת. |
| `run --continue-from --from-failed` | ממשיך הרצה שנכשלה מהנקודה שבה היא נעצרה. בלי `--node`, הרצת ההמשך לוקחת בחשבון את הרכיבים שעליהם ההרצה הראשונה התחילה, ועוד כל רכיב שעדיין במצב נכשל. עם `--node`, כל רכיב שציינתם נחשב: אם אף הרצה בשרשרת לא הריצה אותו מעולם, הוא רץ ומשלמים עליו. רכיב מקור, טריגר או רכיב שהוגדר לדילוג אף פעם לא רץ. ראו בדף ה-API [המשך הרצה שנכשלה](https://nodaro.ai/docs/developers/api/workflows#continue-a-failed-run). |
| `run --continue-from --node` | מריץ רק את הרכיבים שציינתם, כהמשך של הרצה שהושלמה. כל רכיב אחר מעביר הלאה את התוצאות של אותה הרצה. |
| `run --override` | הגדרה של רכיב להרצה הזו בלבד, בכתיב `nodeId.field=value`. חזרו על הדגל לכל הגדרה נוספת. |
| `run --idempotency-key` | נשלח ככותרת `Idempotency-Key` (8 תווים לפחות). שתי בקשות עם אותו מפתח מתחילות הרצה אחת. |
| `run --next` | שולח את השדה `next` מתגובה עם `continuation_preview_pending`, בדיוק כפי שהוא. כשהרצה עם `--from-failed` נדחית, ה-CLI מדפיס את הפקודה שמשלימה את ההרצה שנעצרה. |
| `render-final` | רינדור במצב סופי של הרצה שנעצרה בתצוגה מקדימה, ואחריו הרצה של כל הרכיבים שאחרי הרינדור, כהמשך של אותה הרצה. ברירת המחדל של `--render` היא הרינדור היחיד שבתהליך. הדגל `--estimate` מחזיר אומדן של הרכיבים ושל הקרדיטים, ולא מריץ כלום. |

פורמט החבילה זהה לפורמט שהעורך מייצא. ראו את המדריך [ייבוא וייצוא](https://nodaro.ai/docs/guides/import-export).

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

```bash
nodaro workflows share <id> [--visibility workspace|private] [--json]
nodaro workflows move <id> --project <projectId> [--json]
nodaro workflows shared-with-me [--json]
nodaro workflows mcp-conversations [--month YYYY-MM] [--source claude,claude-code,chatgpt] [--json]
nodaro workflows collaborators list <id> [--json]
nodaro workflows collaborators add <id> (--user <userId> | --email <email>) --role viewer|editor [--json]
nodaro workflows collaborators update <id> <userId> --role viewer|editor [--json]
nodaro workflows collaborators remove <id> <userId> [--json]
```

- הפקודה `share` קובעת מי בסביבת העבודה יכול לראות את התהליך. ברירת המחדל של הנראות היא `workspace`.
- הפקודה `collaborators add --email` מוצאת כל חשבון Nodaro לפי כתובת האימייל שלו, בלי קשר לארגון של החשבון. על כתובת שאין לה חשבון מקבלים `404`.
- הפקודה `mcp-conversations` מציגה את שיחות ה-MCP שלכם מחודש אחד, וכל שיחה היא תהליך שעוזר AI בנה. ברירת המחדל היא החודש האחרון שיש בו שיחות. הדגל `--source` משאיר רק את השיחות של עוזרים מסוימים. ראו את הדף [איך שיחות MCP הופכות לתהליכים](https://nodaro.ai/docs/mcp/conversation-flows).
- הפקודה `move` מעבירה את התהליך לפרויקט אחר. העברה לסביבת עבודה אחרת מסירה את השותפים של התהליך, והתוצאה מציינת מי איבד את הגישה.

## אפליקציות
אפליקציה היא תהליך שעטוף בטופס של קלטים ופלטים שנבחרו בקפידה. ראו את הדף [אפליקציות](https://nodaro.ai/docs/concepts/apps).

```bash
nodaro apps list [--search <query>] [--limit <n>] [--cursor <token>] [--category <slug>]
nodaro apps get <slug>                                   # input schema and outputs
nodaro apps run <slug> --input prompt="..." [--watch]
nodaro apps run <slug> --params-file inputs.json [--watch]
nodaro apps run <slug> --input prompt="..." --override <nodeId>.<field>=<value>
nodaro apps runs <slug> [--limit <n>] [--cursor <token>] [--json]   # your past runs
nodaro apps run-get <slug> <runId>
nodaro apps run-retry <slug> <runId> [--dry-run] [--app-version <n>] [--watch] [--json]
```

- הפקודה `apps list` מחזירה עד 50 אפליקציות בכל עמוד. כדי לקבל את העמוד הבא, העבירו ב-`--cursor` את הערך שקיבלתם עם העמוד הקודם.
- הפקודה `apps get` מציגה את שמות הקלטים של האפליקציה. השתמשו בהם כמפתחות של `--input`.
- הדגל `--input` קובע קלט אחד של האפליקציה. חזרו על הדגל לכל קלט, או שימו את כל הקלטים בקובץ JSON עם `--params-file`.
- הפקודה `apps run-retry` מנסה שוב הרצה שנכשלה, מהנקודה שבה היא נעצרה. רק השלבים שההרצה לא השלימה רצים, ורק עליהם משלמים. כל שלב שהיא השלימה מעביר הלאה את התוצאה שלו. הניסיון החוזר מריץ את הגרסה שההרצה הריצה, עם הקלטים שההרצה השתמשה בהם, ולא מקבל קלטים משלו. ראו את הסעיף [ניסיון חוזר של הרצה שנכשלה](https://nodaro.ai/docs/developers/embed/miniapps#retry-a-failed-run) בדף הטמעת מיני־אפליקציה.
- הדגל `--dry-run` מציג את השלבים שהניסיון החוזר היה מריץ וכמה קרדיטים היו נגבים, ולא מתחיל שום דבר.
- הדגל `--app-version` מציין את גרסת האפליקציה שאתם מצפים שהניסיון החוזר יריץ. ברירת המחדל היא הגרסה האחרונה של האפליקציה. אם האפליקציה השתנתה מאז ההרצה, הניסיון החוזר נדחה עם `app_run_version_changed`. ה-CLI מדפיס אז את שתי הדרכים להמשיך: להתחיל מחדש עם `nodaro apps run` או להמשיך על הגרסה של ההרצה עצמה עם `--app-version <that version>`. הרצה שנעצרה, ולא נכשלה, מתחילה מחדש.
- הדגל `--override` קובע שדה גולמי של רכיב להרצה הזו בלבד, בכתיב `<nodeId>.<field>=<value>`. כך אפשר להגיע לשדות שהאפליקציה לא חושפת, כגון `promptPrefix`. ראו את הדף [טקסט לפני ואחרי הפרומפט](https://nodaro.ai/docs/concepts/prompt-pre-post-text).

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

## רכיבים
```bash
nodaro nodes list [--category <category>] [--json]
nodaro nodes get <type>                                  # full input schema
nodaro nodes run <type> --param prompt="..." --param provider=flux [--watch]
nodaro nodes run <type> --params-file body.json [--watch] [--poll-interval 1000]
nodaro nodes run generate-image --param prompt="..." [--count 1-4] [--models <id,id,...>] [--watch]
```

- הדגל `--category` מקבל אחד מהערכים `input`, `parameter`, `ai-image`, `ai-video`, `ai-audio`, `ai-text`, `processing`, `composition`, `output`, `control`, `entity`, `trigger` או `utility`.
- הפקודה `nodes get` מדפיסה את סכמת הקלט של סוג רכיב אחד: השדות ש-`--param` מקבל.
- הפקודה `nodes run` שולחת בקשה לנתיב של הרכיב עצמו, שברוב סוגי הרכיבים הוא `POST /v1/<type>`. לחלק מסוגי הרכיבים, כגון `llm-chat` ורכיבי Suno, יש נתיב משלהם, וה-CLI משתמש בו בשבילכם. סוג רכיב שלא יכול לרוץ לבד, כגון `modify-image` או `paint-mask`, נכשל לפני הקריאה ל-API, וההודעה מציינת מה להריץ במקומו. ראו את הדף [הרצת רכיבים ב-SDK](https://nodaro.ai/docs/developers/sdk/nodes#runtype-params-options).
- כשבתגובה יש מזהה משימה, הדגל `--watch` בודק את סטטוס המשימה מדי כמה שניות עד שהיא מסתיימת. הדגל `--poll-interval` קובע כל כמה אלפיות שנייה לבדוק את הסטטוס. ברירת המחדל היא 2000.

התחביר של `--param` ושל `--params-file` מתואר בדף [פרמטרים וקובצי קלט](https://nodaro.ai/docs/developers/cli/params).

למשל, רכיב [עומק וידאו](https://nodaro.ai/docs/nodes/video/video-depth) הופך קליפ לסרטון עומק, שבו מה שקרוב בהיר ומה שרחוק כהה:

```bash
nodaro nodes run video-depth --param videoUrl=https://cdn.example.com/clip.mp4 --param colormap=turbo --watch
```

### כמה תמונות בקריאה אחת
רק ב-`generate-image`, הדגל `--count <n>` יוצר בין 1 ל-4 תמונות, כל אחת כמשימה נפרדת. הדגל `--models a,b` מריץ את אותה בקשה על כמה מודלי תמונה, בין 2 ל-4, במקום `provider`. כששני הדגלים מופיעים, הדגל `--count` חל על כל מודל, עד 8 תמונות. היתרה שלכם נבדקת מול האצווה כולה, והקרדיטים נגבים על כולה או לא נגבים בכלל.

```bash
nodaro nodes run generate-image --param prompt="a lighthouse at dusk" --count 4 --watch
nodaro nodes run generate-image --param prompt="a lighthouse at dusk" --models gpt-image-2,flux-2-max --count 2 --watch
```

ה-CLI מדפיס את כל מזהי המשימות, מקובצים לפי מודל, ואת מזהה האצווה. הדגל `--watch` בודק את המצב של כל משימה עד שכולן מגיעות לסטטוס סופי. הפקודה יוצאת עם `0` כשכל המשימות הושלמו, עם `2` כשאחת מהן נכשלה או בוטלה ועם `3` כשחלק מהמשימות ממתינות לבדיקה וכל השאר הושלמו. עם `--json --watch`, ה-CLI מדפיס את הסטטוס הסופי של כל משימה. הדגלים גוברים על `count` ועל `models` שב-`--param` או ב-`--params-file`.

## מודלים
```bash
nodaro models list [--kind image|video|audio] [--mode <mode>] [--family <vendor>] [--featured] [--json]
nodaro models cost <id…> [--json]
```

- הדגל `--mode` מסנן לפי סוג הפעולה, כגון `t2i`, `i2v`, `t2v` או `tts`.
- הדגל `--family` מסנן לפי יצרן המודל, כגון `Google` או `Bytedance`.
- הדגל `--featured` מציג רק מודלים מומלצים.

בטבלה מופיעים לכל מודל המזהה, הסוג, המשפחה, היצרן, המצבים ומדרגות הקרדיטים. היצרן הוא החברה שיצרה את המודל. הטבלה מסמנת גם את המודלים המומלצים ואת משפחות המודלים ש-Nodaro אסף עבורן המלצות לכתיבת פרומפטים. עם `--json`, הפקודה מחזירה את פירוט היכולות המלא, את התמחור בקרדיטים ואת הטיפים לפרומפטים. היא מחזירה גם את `maker` של כל מודל, בצורה `{ id, name }`, ואת `logoUrl` של היצרן, שהוא `null` כשהמופע לא מפרסם לוגו. אפשר לעיין באותו קטלוג בחלק [מודלים](https://nodaro.ai/docs/models) של התיעוד.

הפקודה `models cost` מדפיסה כמה קרדיטים נגבים על כל מזהה, לפי `POST /v1/credits/model-costs`. מזהה הוא מזהה של מודל, מזהה מחיר בקרדיטים או מפתח מחיר של קריאת LLM שמחויבת לפי השימוש, בצורה `<feature>:<model>[:direct]`. קריאת LLM כזו מחויבת לפי הטוקנים שהיא משתמשת בהם, ולכן המספר שלה הוא אומדן, והוא מודפס כ-`≈N`. מזהה בלי מחיר מודפס כ-`-`, עם הסיבה. ראו בדף ה-API [קריאות LLM](https://nodaro.ai/docs/developers/api/credits#llm-calls).

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

```bash
nodaro billing plans [--base-url <url>] [--json]
nodaro billing subscription [--json]
nodaro billing account [--json]
nodaro billing surface [--base-url <url>] [--json]
nodaro billing summary [--since <when>] [--until <when>] [--bucket day|week|month] [--json]
nodaro billing history [--kind <k>] [--model <id>] [--since <iso>] [--until <iso>] [--search <words>] [--limit <n>] [--cursor <c>] [--csv] [--json]
```

| פקודה | מה היא מציגה |
| --- | --- |
| `billing plans` | התוכניות וחבילות הקרדיטים שנמכרות, עם המחירים שלהן. ב-Nodaro Cloud בלבד. לא צריך להתחבר. |
| `billing subscription` | המנוי שלכם והרמה שקובעת למה החשבון שלכם זכאי. ב-Nodaro Cloud בלבד. |
| `billing account` | התוכנית והיתרה שלכם, כפי שספק החיוב של הפריסה מדווח עליהן, ביחידה שלו. |
| `billing surface` | איך הפריסה מחייבת: אם היא מודדת שימוש ובאיזו יחידה העלויות מוצגות. לא צריך להתחבר. |
| `billing summary` | השימוש שלכם בקרדיטים לאורך תקופה, כברירת מחדל 30 הימים האחרונים: סכומים כוללים ופילוח לפי מודל, לפי קטגוריה, לאורך זמן, לפי סשן ולפי תהליך. ב-Nodaro Cloud בלבד. |
| `billing history` | כל תנועה ביתרה שלכם, מהחדש לישן, עם היתרה אחרי כל תנועה. הדגל `--csv` מדפיס את כל ההיסטוריה המסוננת כ-CSV. ב-Nodaro Cloud בלבד. |

הפקודות `plans` ו-`surface` לא שולחות פרטי גישה. הן פונות למופע שב-`--base-url`, ואם אין, למופע של הפרופיל, ואם גם הוא חסר, אל `https://app.nodaro.ai`. במופע באירוח עצמי, שאין בו חיוב, הפקודות `plans` ו-`subscription` נכשלות עם 404. את השדות מתאר הסעיף [`client.billing`](https://nodaro.ai/docs/developers/sdk/models-and-credits#clientbilling) בדף מודלים וקרדיטים, ואת מה ש-`summary` ו-`history` קוראות מתארים הסעיפים [סיכום שימוש](https://nodaro.ai/docs/developers/api/credits#usage-summary) ו[כל התנועות ביתרה שלכם](https://nodaro.ai/docs/developers/api/credits#history) בדף ה-API קרדיטים.

## בוררים
בוררים הם הרכיבים של בקרות יצירתיות, כגון הבוררים מצב־רוח ומסגור. הפקודות האלה קוראות את הקטלוגים של הערכים התקפים שלהם. ראו את הדף [קטלוגי הבוררים](https://nodaro.ai/docs/developers/picker-catalogs).

```bash
nodaro pickers list [--json]
nodaro pickers get <nodeType> [--full] [--category <c>] [--field <f>] [--json]
nodaro pickers analyze "<text>" [--target <types>] [--instructions <text>] [--model <id>] [--effort <level>] [--json]
```

| פקודה או דגל | תיאור |
| --- | --- |
| `pickers list` | מציגה את כל סוגי הבוררים, את מספר האפשרויות בכל בורר ואת מספר האפשרויות שיש להן תמונה. |
| `pickers get` | מחזירה קטלוג אחד. כל אפשרות כוללת `id`, `label`, `category`, `term` ו-`icon`. אפשרות שיש לה תמונה כוללת גם `imageUrl`. |
| `--full` | מוסיף את התיאור של כל אפשרות ואת הביטוי שהיא מוסיפה לפרומפט. |
| `--category` | מסנן בורר חד־ממדי לקטגוריה אחת. |
| `--field` | מחזיר ממד אחד של בורר רב־ממדי, כגון `shotSize` של הבורר מסגור. |
| `pickers analyze` | מילוי בעזרת AI: בוחרת ערכים לבוררים מתוך תיאור חופשי. זו קריאת LLM, שמחויבת בקרדיטים. |
| `--target` | רשימה מופרדת בפסיקים של סוגי הבוררים למילוי. ברירת המחדל היא כל בורר שאפשר לנתח. |

השדה `term` הוא הביטוי המקצועי הקצר שמתווסף לפרומפט במצב מקוצר של רמז לפרומפט. באפשרות שלא מוסיפה כלום, כגון `auto` או `none`, הוא ריק. הבוררים אדם וסטיילינג מחזירים גם `sections`: התחומים שלהם, כל אחד עם תמונה עגולה.

## ערכות
ערכה היא הגדרות שמורות של רכיב. הפקודות האלה מנהלות את הערכות, את המועדפים ואת התיקיות שלכם, וקוראות את קטלוג הערכות המובנות. ראו את הדף [ערכות](https://nodaro.ai/docs/concepts/presets).

```bash
nodaro presets list [--node-type <type>] [--factory [--base-url <url>]] [--json]
nodaro presets create --node-type <type> --name <name> (--data <json> | --data-file <path|->) [--description <text>] [--group <id>] [--tag <t>]... [--preview-url <url>] [--json]
nodaro presets update <id> [--name <name>] [--description <text>] [--data <json> | --data-file <path|->] [--group <id> | --no-group] [--tag <t>]... [--preview-url <url> | --no-preview-url] [--expected-updated-at <iso>] [--json]
nodaro presets delete <id> [--expected-updated-at <iso>] [--json]
nodaro presets export [--node-type <type>] [--output <file>]
nodaro presets import <file|-> [--json]
nodaro presets favorites --node-type <type> [--json]
nodaro presets favorite <presetId> --node-type <type> [--json]
nodaro presets unfavorite <presetId> --node-type <type> [--json]
nodaro presets groups list [--node-type <type>] [--json]
nodaro presets groups create --node-type <type> --name <name> [--kind folder|section] [--sort-order <n>] [--json]
nodaro presets groups update <id> [--name <name>] [--sort-order <n>] [--json]
nodaro presets groups delete <id> [--json]
```

| פקודה או דגל | תיאור |
| --- | --- |
| `list --factory` | מציג את קטלוג הערכות המובנות לסוג הרכיב שב-`--node-type`. **לא צריך להתחבר.** הדגל `--base-url` פונה למופע אחר. העמודה `photos` מציינת על כמה תמונות ייחוס הערכה מתבססת, והעמודה `preview` מציינת אם יש לה תמונת דוגמה. |
| `list` | בלי `--factory`, מציגה את הערכות שלכם. הפקודה דורשת פרופיל. |
| `create --preview-url` | תמונה שכבר שמורה בפלטפורמה הזו: העלאה או תוצאה מוכנה. |
| `update --expected-updated-at`, `delete --expected-updated-at` | דוחים את השינוי אם הערכה השתנתה מאז המועד הזה. |
| `export` | כותבת את הערכות שלכם לקובץ JSON ש-`import` מקבלת. |
| `import` | קוראת את הקובץ הזה, או רשימת ערכות ב-JSON, מנתיב או מהקלט הסטנדרטי. |
| `favorite`, `unfavorite` | מוסיפות או מסירות מועדף: מזהה של ערכה מובנית או מזהה של אחת מהערכות שלכם. |
| `groups` | מציגה, יוצרת ומוחקת את התיקיות והמקטעים שלכם, ומשנה את השמות שלהם. גם הפקודה `groups` לבדה מציגה אותם. מחיקה של תיקייה מוציאה ממנה את הערכות שלה. |

בעורך משנים את הסדר בגרירה. סקריפטים משתמשים ב-[`presets.reorder()`](https://nodaro.ai/docs/developers/sdk/pickers-and-prompts#presetsimportpresets-and-reorderinput) של ה-SDK.

## פלטות ומודבורדים
שמרו צבעים וייחוסי סגנון משלכם, ואז השתמשו באחד מהם ב-`generate-image`. פלטה נכנסת ל-`direction.colorLook` בצורה `palette:<id>`, ומודבורד נכנס ל-`direction.style` בצורה `moodboard:<id>`. ראו את הסעיף [פלטות ומודבורדים](https://nodaro.ai/docs/developers/sdk/pickers-and-prompts#clientpalettes) בדף בוררים, ערכות ופרומפטים, במדריך ה-SDK.

```bash
nodaro palettes list [--limit <n>] [--cursor <c>] [--json]
nodaro palettes get <id> [--json]
nodaro palettes create --name <name> --colors <#hex,#hex,...> [--description <text>] [--json]
nodaro palettes update <id> [--name <name>] [--colors <#hex,...>] [--description <text> | --clear-description] [--json]
nodaro palettes delete <id> [--json]
nodaro moodboards list [--limit <n>] [--cursor <c>] [--json]
nodaro moodboards get <id> [--json]
nodaro moodboards create --name <name> --image <url[|caption]>... [--description <text>] [--json]
nodaro moodboards update <id> [--name <name>] [--description <text> | --clear-description] [--image <url[|caption]>...] [--json]
nodaro moodboards delete <id> [--json]
```

- בפלטה יש בין 2 ל-12 צבעים.
- במודבורד יש בין 1 ל-12 תמונות. חזרו על `--image` לכל תמונה, ואפשר להוסיף כיתוב אחרי `|`. ב-`update`, הדגל `--image` מחליף את כל התמונות.
- מחיקה של מודבורד לא משנה את התמונות שמקושרות אליו.

```bash
nodaro palettes create --name Harbour --colors "#0F4C5C,#E3B23C,#F28C7A"
nodaro nodes run generate-image --param prompt="a lighthouse at dusk" --param 'direction={"colorLook":"palette:<paletteId>"}' --watch
```

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

```bash
nodaro catalog snapshot --in <file>
nodaro catalog diff-upstream --baseline <f> --upstream <f> --pack <f> [--write <f>]
nodaro catalog validate --pack <file> [--exempt es,fr,...]
```

- הפקודה `snapshot` מדפיסה כ-JSON את מה ש-`/v1/catalogs` היה מחזיר לקובץ, ברמת הפירוט המלאה, יחד עם קובצי התרגום שלו.
- הפקודה `diff-upstream` מבצעת מיזוג תלת־כיווני. היא מעבירה עריכות מה-upstream לרשומות שלא שיניתם, יחד עם המחרוזות שלהן ב-11 השפות המתורגמות. היא מדווחת על התנגשויות, כלומר רשומות ששיניתם ושגם ב-upstream שונו, ומשאירה את הגרסה שלכם. היא מפרטת רשומות חדשות ב-upstream ורשומות שהוסרו ממנו, ואף פעם לא מוסיפה שום דבר בעצמה. כשיש התנגשויות, היא יוצאת עם קוד 2.
- הפקודה `validate` בודקת שבתמונת המצב של חבילה יש תרגומים בכל 11 השפות המתורגמות או מצהירה על פטורים עם `--exempt`. היא יוצאת עם קוד 1 כשחסר תרגום בשפה שלא קיבלה פטור.

## הרצות ומשימות
**רשומת הרצה** מייצגת הרצה אחת של תהליך או של אפליקציה. **משימה** היא העבודה של רכיב אחד, כגון יצירה של תמונה אחת. הפקודה `nodaro nodes run` מחזירה משימה.

```bash
nodaro executions get <id> [--watch] [--json]
nodaro executions cancel <id> [--mode cancelled|stopping]
nodaro jobs list [--status <s,s>] [--type <t,t>] [--origin <app>] [--source <s,s>] [--favorited | --no-favorited] [--rating good|bad|rated|unrated] [--limit <n>] [--cursor <c>] [--json]
nodaro jobs get <id> [--json]
nodaro jobs rate <id> good|bad|clear [--json]
nodaro jobs cancel <id> [--json]
```

- הפקודה `executions get --watch` בודקת את הסטטוס מדי כמה שניות עד שההרצה מסתיימת, נכשלת או מבוטלת.
- הפקודה `executions cancel --mode cancelled`, ברירת המחדל, עוצרת את ההרצה מיד. עם `--mode stopping`, הרכיבים שבשלב הנוכחי של ההרצה מסתיימים קודם.
- הפקודה `jobs list` מציגה את המשימות שלכם, מהחדש לישן. הדגלים `--status`, `--type` ו-`--source` מקבלים רשימה מופרדת בפסיקים. עם `--source mcp`, הפקודה מציגה את מה שלקוחות ה-MCP שלכם, כגון Claude או ChatGPT, יצרו. הדגל `--no-favorited` משאיר רק את המשימות שלא סימנתם כמועדפות. אפשר לשלב כל מסנן עם האחרים.
- הפקודה `jobs rate` קובעת את הדירוג שלכם לאחת מהמשימות שלכם. הערך `clear` מסיר אותו.

## גלריה
```bash
nodaro gallery browse [--type image|video|audio] [--user <id> | --favorites] [--limit <n>] [--cursor <c>] [--json]
nodaro gallery favorite <jobId> [--json]
nodaro gallery favorites [--json]
```

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

## Webhooks
נקודת קצה של Webhook היא כתובת HTTPS ש-Nodaro קורא לה, בבקשת POST חתומה, בכל פעם שאחת מהמשימות שלכם מסתיימת ב-`job.completed` או ב-`job.failed`. דף ה-API [Webhooks](https://nodaro.ai/docs/developers/api/webhooks) מתאר את האירועים, את גוף הבקשה ואת הבדיקה של החתימה.

```bash
nodaro webhooks list [--json]
nodaro webhooks get <id> [--json]
nodaro webhooks create --url <https-url> [--events job.completed,job.failed] [--description <text>] [--json]
nodaro webhooks update <id> [--url <https-url>] [--events <list>] [--description <text> | --clear-description] [--enable | --disable] [--json]
nodaro webhooks delete <id> [--json]
nodaro webhooks rotate-secret <id> [--grace <seconds>] [--json]
nodaro webhooks deliveries <id> [--status pending|delivered|failed] [--limit <n>] [--cursor <c>] [--json]
nodaro webhooks test <id> [--wait] [--poll-interval <ms>] [--json]
```

| פקודה | מה היא עושה |
| --- | --- |
| `create` | רושמת נקודת קצה ומדפיסה את סוד החתימה שלה (`whsec_…`) **פעם אחת**. שמרו אותו. עם `--json`, הפלט הוא `{ data, secret }`. |
| `update --enable` | מפעילה את נקודת הקצה. היא גם מבטלת השבתה אוטומטית, שקורית אחרי 50 מסירות ברצף שנכשלו סופית. |
| `delete` | מוחקת את נקודת הקצה ואת יומן המסירות שלה. |
| `rotate-secret` | מדפיסה סוד חדש פעם אחת. הסוד הישן ממשיך לחתום במשך מספר השניות שב-`--grace`. ברירת המחדל היא יום אחד, והערך `0` מפסיק את הסוד הישן מיד. |
| `deliveries` | מציגה את יומן המסירות, מהחדש לישן. |
| `test` | שולחת `ping`, בניסיון אחד, גם כשנקודת הקצה מושבתת. הדגל `--wait` בודק את מצב המסירה הזו ומציג איך השרת שלכם ענה. |

## שליטה בהרצות של רכיב יצירת וידאו Pro
רכיב [יצירת וידאו Pro](https://nodaro.ai/docs/nodes/video/generate-video-pro) יוצר סרטון ארוך מקטע אחרי מקטע, ולכן אפשר לעצור הרצה ולהמשיך אותה אחר כך. הרכיב רץ ב-Nodaro Cloud; התקנה באירוח עצמי מריצה אותו דרך החיבור שלה ל-Nodaro Cloud.

```bash
nodaro video-pro stop <jobId> [--json]
nodaro video-pro continue <jobId> [--from-segment N] [--watch] [--poll-interval <ms>] [--json]
```

- הפקודה `stop` מסיימת את ההרצה בצורה מסודרת. המקטעים שהושלמו נשמרים ונמסרים, והקרדיטים המשוריינים שלא נדרשו מוחזרים. על המקטע שבעיצומו עדיין משלמים.
- הפקודה `continue` מתחילה משימה חדשה שיוצרת מחדש את הסרטון ממקטע `N` והלאה. ברירת המחדל היא המקטע הראשון שלא נמסר. משלמים רק על המקטעים שנוצרים מחדש, ועוד התשלום הקבוע של Pro.

## אשף הפרומפטים
אשף הפרומפטים הופך רעיון גולמי לפרומפט משופר לסוג רכיב מסוים, כגון `generate-image`.

```bash
nodaro prompt wizard [--node-type <type>] [--prompt "..."] [--provider <name>] [--style <name>] [--aspect-ratio <ratio>] [--duration <seconds>] [--llm-model <id>] [--reasoning-effort <level>] [--advanced] [--temperature <n>] [--max-tokens <n>]
nodaro prompt analyze --node-type <type> [--prompt "..."] [--provider <name>] [--style <name>] [--aspect-ratio <ratio>] [--duration <seconds>] [--llm-model <id>] [--reasoning-effort <level>] [--advanced] [--temperature <n>] [--max-tokens <n>] [--json]
nodaro prompt generate --node-type <type> --selection category=value [--selection ...] [--original-prompt "..."] [--provider <name>] [--style <name>] [--aspect-ratio <ratio>] [--duration <seconds>] [--llm-model <id>] [--reasoning-effort <level>] [--advanced] [--temperature <n>] [--max-tokens <n>] [--json]
nodaro prompt enhance --node-type <type> [--prompt "..."] [--provider <name>] [--style <name>] [--aspect-ratio <ratio>] [--duration <seconds>] [--llm-model <id>] [--reasoning-effort <level>] [--advanced] [--temperature <n>] [--max-tokens <n>] [--json]
```

| פקודה | מה היא עושה |
| --- | --- |
| `prompt wizard` | שואלת שאלות מנחות בטרמינל. בלי `--node-type`, היא שואלת קודם לאיזה רכיב הפרומפט מיועד. הפקודה דורשת טרמינל אינטראקטיבי. |
| `prompt analyze` | מחזירה את השאלות המנחות של האשף, לשימוש בסקריפט. |
| `prompt generate` | בונה את הפרומפט הסופי מהתשובות שלכם. חזרו על `--selection category=value` פעם אחת לכל תשובה. |
| `prompt enhance` | כותבת פרומפט מחדש בשלב אחד, בלי שאלות. |

- הערך של `--reasoning-effort` הוא `none`, `low`, `medium`, `high`, `xhigh` או `max`. התמיכה נקבעת לפי המודל; ערך שהמודל לא תומך בו, או ערך שהושמט, משאיר את ברירת המחדל של המודל. הקריאה מחויבת לפי הטוקנים שהיא משתמשת בהם, בתעריף של המודל, ולכן רמת מאמץ גבוהה יותר עולה יותר רק בגלל הטוקנים שהמודל כותב. במודל Claude, עם כל רמת מאמץ, הקריאה רצה ב-API של Anthropic עצמה, בתעריף של אותו שירות.
- הדגל `--advanced` עובד עם מודלי Gemini ו-Claude. הוא מריץ את הבקשה ב-API של יצרן המודל עצמו. הוא מאפשר להשתמש ב-`--temperature` וב-`--max-tokens` ופותח את כל רמות החשיבה, והקריאה מחויבת בתעריף של אותו שירות.

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

```bash
nodaro shots get <id> [--json]
nodaro shots create [--file shot.json] [--visibility private|public] [--json]
nodaro shots update <id> [--file fields.json] [--visibility private|public] [--json]
nodaro shots delete <id>
```

שוט חדש הוא פרטי, אלא אם מגדירים `--visibility public`. כל מי שהמזהה של שוט ציבורי בידיו יכול לקרוא אותו.

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

```bash
nodaro recast skill
nodaro recast validate --file script.json [--json]
nodaro recast import --file script.json --rights-attested [--json]
nodaro recast estimate --analysis-job <id> [--fidelity faithful] [--resolution <r>] [--segment-sec <n>] [--json]
nodaro recast create --workflow <id> --analysis-job <id> [--rights-attested] [--fidelity faithful] [--resolution <r>] [--segment-sec <n>] [--json]
nodaro recast start <recastId> [--segment-sec <n>] [--json]
nodaro recast status <recastId> [--json]
```

| פקודה | מה היא עושה | עלות |
| --- | --- | --- |
| `recast skill` | מדפיסה כ-Markdown את המדריך לכתיבת תסריט. | חינם |
| `recast validate` | בודקת תסריט. כל עוד התסריט לא תקין, היא יוצאת עם קוד 1. | חינם |
| `recast import` | מייבאת תסריט שעבר בדיקה, כניתוח שהושלם. הדגל `--rights-attested` מצהיר שהתסריט הוא יצירה שלכם. סרט Recast מתסריט כתוב מרונדר ברמת הנאמנות `faithful`, בדיוק כפי שנכתב. | חינם |
| `recast estimate` | נותנת אומדן מחיר בקרדיטים להרצה. | חינם |
| `recast create` | קונה את התוכנית ומחזירה את מזהה ההרצה. הריצו קודם את `estimate`. | קרדיטים |
| `recast start` | מרנדרת הרצה מתוכננת. אין בעיה להריץ אותה פעמיים. | כלול בתוכנית |
| `recast status` | מציגה את הסטטוס ואת השלב האינטראקטיבי שממתין לכם, אם יש כזה. | חינם |

**`--segment-sec` ב-CLI 1.24.0.** נתיבי Recast מקבלים בהגדרת החלקים שם של שיטת קיבוץ: `scenes-max` (הכי מעט נקודות חיבור), `scenes` (חלקים קצרים יותר) או `max` (החלקים הארוכים ביותר שהמודל מאפשר). ב-CLI 1.24.0, הדגל `--segment-sec` נשלח כמספר, ולכן אי אפשר לשלוח בו שם של שיטה, ומספר כמו `10` נדחה עם `400 validation_error`. כשמשמיטים את הדגל, השרת משתמש בברירת המחדל שלו, `scenes-max`. כדי לבחור שיטה אחרת, השתמשו בנקודות הקצה שבדף [ה-API של Recast](https://nodaro.ai/docs/developers/api/recast).

ראו את הדף [Recast דרך MCP](https://nodaro.ai/docs/mcp/recast) כדי להבין איך הרצת Recast עובדת, ואת הדף [ה-API של Recast](https://nodaro.ai/docs/developers/api/recast) לנקודות הקצה שמאחורי הפקודות האלה.

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

```bash
nodaro trends list [--search <text>] [--tag <tag>] [--favorites] [--locale <l>] [--limit <n>] [--cursor <c>] [--json]
nodaro trends get <slug> [--locale <l>] [--json]
nodaro trends estimate <slug> --slot <key>=<url>[,<url>] [--slot ...] [--choice <key>.<chip>=new|original] [--example <n>] [--details "…"] [--preview] [--resolution 480p|720p|1080p] [--no-draft] [--json]
nodaro trends run <slug> [the estimate options] [--session <id>] [--idempotency-key <key>] [--json]
nodaro trends runs [--trend <slug>] [--limit <n>] [--cursor <c>] [--json]
nodaro trends favorite <slug>
nodaro trends unfavorite <slug>
```

| פקודה | מה היא עושה | עלות |
| --- | --- | --- |
| `trends list` | מציגה את הטרנדים שפורסמו. הערך של `--limit` הוא מ-1 עד 60. | חינם |
| `trends get` | מציגה את המשבצות של טרנד (המפתח, הסוג ואם המשבצת נדרשת), את הדוגמאות, את התצוגה המקדימה, את המנוע ואת הרזולוציות שלו. | חינם |
| `trends estimate` | נותנת אומדן מחיר להרצה: בערך כמה קרדיטים היא עולה וכמה קרדיטים משוריינים בזמן שהיא רצה. | חינם |
| `trends run` | מתחילה הרצה ומדפיסה את מזהה המשימה. בדקו את מצב המשימה עם `nodaro jobs get <id>`. הריצו קודם את `estimate`. | קרדיטים |
| `trends runs` | מציגה את הרצות הטרנדים שלכם, מהחדש לישן. בעמודת הקרדיטים מופיע כמה נגבה על כל הרצה בחיוב הסופי, כולל כל שלב שההרצה הריצה: הכנת הייחוסים, המסכה והסרטון. העמודה ריקה עד החיוב הסופי של השריון של ההרצה עצמה. | חינם |
| `trends favorite`, `trends unfavorite` | מוסיפות טרנד למועדפים שלכם או מסירות אותו מהם. | חינם |

- אפשר לחזור על `--slot` כמה פעמים, פעם אחת לכל משבצת, עם 1–3 תמונות לכל משבצת. התמונות מופרדות בכל מקום שבו מתחילה כתובת http או https חדשה, ולכן כתובת שיש בה פסיקים נשארת שלמה. מפתח של משבצת הוא באורך של בין 1 ל-32 תווים, מתוך `a`–`z`, `0`–`9` ו-`_`.
- הדגל `--choice` שומר תכונה כמו בקליפ (`original`) או יוצר אותה מחדש מהתמונות שלכם (`new`): `body`, `outfit` או `hair` של אדם, `body` או `coat` של חיית מחמד, `shape` או `finish` של מוצר.
- הדגל `--resolution` מקבל אחת מהרזולוציות שהטרנד מציע, כפי ש-`trends get` מציגה אותן. ברירת המחדל היא הרזולוציה הראשונה של הטרנד: טיוטה ב-480p או 720p בטרנד של Nodaro Motion Pulse, שאין בו טיוטה. הדגל `--no-draft` מכבה את הטיוטה.
- הדגל `--session` מתקבל, אבל עדיין לא משפיע: הרצות של טרנדים עדיין לא נשמרות בסשנים.

נקודות הקצה שמאחורי הפקודות האלה מתוארות בדף ה-API [טרנדים](https://nodaro.ai/docs/developers/api/trends).

## איכות מלאה ב-Nodaro Motion
אפשר להשלים ב-1080p שני סוגים של הרצות, בתוך 7 ימים מסיום ההרצה. הרצת טיוטה, כלומר הרצת Nodaro Motion שנוצרה כטיוטה או הרצת טרנד, מושלמת כאותו טייק. הרצת Nodaro Motion Pulse ב-720p מושלמת כטייק חדש מאותם קלטים. הפקודות שומרות על השם `cast-swap`, והן עובדות ב-Nodaro Cloud בלבד.

```bash
nodaro cast-swap full-quality estimate <jobId> [--json]
nodaro cast-swap full-quality run <jobId> [--session <id>] [--json]
```

| פקודה | מה היא עושה | עלות |
| --- | --- | --- |
| `cast-swap full-quality estimate` | נותנת אומדן מחיר לגרסת האיכות המלאה: בערך כמה קרדיטים היא עולה, אם זה אותו טייק או טייק חדש, כל חלק של האומדן לפי התווית שלו ועד מתי אפשר להשלים את ההרצה. המחיר של הרינדור ב-1080p הוא 0 כשמשתמשים שוב ברינדור של ניסיון קודם. | חינם |
| `cast-swap full-quality run` | מתחילה את גרסת האיכות המלאה ומדפיסה את מזהה המשימה החדשה. בדקו את מצב המשימה עם `nodaro jobs get <id>`. הריצו קודם את `estimate`. | קרדיטים |

לכל הרצה יש גרסת איכות מלאה אחת. כשהיא כבר קיימת, הפקודה `run` מדפיסה את המשימה הזו ולא גובה כלום. הקוד `full_quality_pending` פירושו שהרינדור ב-1080p של ניסיון קודם נמצא בבדיקה או שעדיין לא התחיל. זה לא מצב סופי: הריצו את הפקודה שוב מאוחר יותר. ראו בדף ה-API [איכות מלאה](https://nodaro.ai/docs/developers/api/cast-swap#full-quality).

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

### איך מציגים את כל סוגי הרכיבים שה-CLI של Nodaro יכול להריץ?

הריצו את הפקודה nodaro nodes list. כדי לסנן את הרשימה, הוסיפו ‎--category ai-image או קטגוריה אחרת. כדי לראות את סכמת הקלט המלאה של סוג רכיב אחד, הריצו nodaro nodes get generate-image.

### איך מריצים מה-CLI רק חלק מהרכיבים של תהליך?

הוסיפו לפקודה nodaro workflows run את הדגל ‎--node, ואחריו את מזהי הרכיבים, מופרדים ברווחים. רק הרכיבים האלה רצים.

### איך עוצרים מהטרמינל תהליך שרץ?

הריצו את הפקודה nodaro executions cancel עם מזהה ההרצה. מצב ברירת המחדל, cancelled, עוצר את ההרצה מיד. עם ‎--mode stopping, הרכיבים שבשלב הנוכחי של ההרצה מסתיימים קודם.

### איך יוצרים כמה תמונות בפקודת CLI אחת?

הריצו את הפקודה nodaro nodes run generate-image עם ‎--count (בין 1 ל-4 תמונות) או עם ‎--models ובין 2 ל-4 מזהים של מודלי תמונה. הוסיפו ‎--watch כדי לבדוק את המצב של כל משימה עד שכולן מגיעות לסטטוס סופי.

### אילו פקודות של ה-CLI של Nodaro דורשות Nodaro Cloud?

הפקודות של recast, של trends ושל cast-swap רצות ב-Nodaro Cloud בלבד. כך גם הפקודות characters train, training ו-delete-lora, והפקודות billing plans, subscription, summary ו-history. השליטה בהרצות של רכיב יצירת וידאו Pro עובדת גם בהתקנה באירוח עצמי, דרך החיבור של ההתקנה ל-Nodaro Cloud.

### איך השרת שלי יקבל קריאה כשמשימה מסתיימת?

הריצו את הפקודה nodaro webhooks create --url עם כתובת ה-HTTPS שלכם. ה-CLI מדפיס את סוד החתימה של נקודת הקצה רק פעם אחת. כדי לראות איך השרת שלכם ענה, הריצו את הפקודה nodaro webhooks test עם מזהה נקודת הקצה ועם ‎--wait.
