פקודות

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

כל הדוגמאות מניחות שהתקנתם את ה-CLI והתחברתם.

קבוצות הפקודות

דגלים שכל פקודה מקבלת

• הדגל --profile <name> מריץ את הפקודה עם פרופיל ששמרתם, במקום פרופיל ברירת המחדל.
• הדגל --json מדפיס פלט קריא למכונה, בכל פקודה שקוראת נתונים. ראו את הדף פלט וקודי יציאה.
• הדגל --workspace <id> גלובלי. הוא קובע את סביבת העבודה לפקודה הזו בלבד. ראו את הדף סביבות עבודה וארגונים.
• הדגל -v או --version מדפיס את הגרסה של ה-CLI.

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

פרויקטים

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 בדף תהליכים ופרויקטים.

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 מחזיר את התצוגות המקדימות לפריטים החדשים ביותר.

תהליכים

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]

פורמט החבילה זהה לפורמט שהעורך מייצא. ראו את המדריך ייבוא וייצוא.

שיתוף והעברה של תהליכים

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

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 הופכות לתהליכים.
• הפקודה move מעבירה את התהליך לפרויקט אחר. העברה לסביבת עבודה אחרת מסירה את השותפים של התהליך, והתוצאה מציינת מי איבד את הגישה.

אפליקציות

אפליקציה היא תהליך שעטוף בטופס של קלטים ופלטים שנבחרו בקפידה. ראו את הדף אפליקציות.

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 מנסה שוב הרצה שנכשלה, מהנקודה שבה היא נעצרה. רק השלבים שההרצה לא השלימה רצים, ורק עליהם משלמים. כל שלב שהיא השלימה מעביר הלאה את התוצאה שלו. הניסיון החוזר מריץ את הגרסה שההרצה הריצה, עם הקלטים שההרצה השתמשה בהם, ולא מקבל קלטים משלו. ראו את הסעיף ניסיון חוזר של הרצה שנכשלה בדף הטמעת מיני־אפליקציה.
• הדגל --dry-run מציג את השלבים שהניסיון החוזר היה מריץ וכמה קרדיטים היו נגבים, ולא מתחיל שום דבר.
• הדגל --app-version מציין את גרסת האפליקציה שאתם מצפים שהניסיון החוזר יריץ. ברירת המחדל היא הגרסה האחרונה של האפליקציה. אם האפליקציה השתנתה מאז ההרצה, הניסיון החוזר נדחה עם app_run_version_changed. ה-CLI מדפיס אז את שתי הדרכים להמשיך: להתחיל מחדש עם nodaro apps run או להמשיך על הגרסה של ההרצה עצמה עם --app-version <that version>. הרצה שנעצרה, ולא נכשלה, מתחילה מחדש.
• הדגל --override קובע שדה גולמי של רכיב להרצה הזו בלבד, בכתיב <nodeId>.<field>=<value>. כך אפשר להגיע לשדות שהאפליקציה לא חושפת, כגון promptPrefix. ראו את הדף טקסט לפני ואחרי הפרומפט.

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

רכיבים

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.
• כשבתגובה יש מזהה משימה, הדגל --watch בודק את סטטוס המשימה מדי כמה שניות עד שהיא מסתיימת. הדגל --poll-interval קובע כל כמה אלפיות שנייה לבדוק את הסטטוס. ברירת המחדל היא 2000.

התחביר של --param ושל --params-file מתואר בדף פרמטרים וקובצי קלט.

למשל, רכיב עומק וידאו הופך קליפ לסרטון עומק, שבו מה שקרוב בהיר ומה שרחוק כהה:

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 תמונות. היתרה שלכם נבדקת מול האצווה כולה, והקרדיטים נגבים על כולה או לא נגבים בכלל.

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.

מודלים

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 כשהמופע לא מפרסם לוגו. אפשר לעיין באותו קטלוג בחלק מודלים של התיעוד.

הפקודה models cost מדפיסה כמה קרדיטים נגבים על כל מזהה, לפי POST /v1/credits/model-costs. מזהה הוא מזהה של מודל, מזהה מחיר בקרדיטים או מפתח מחיר של קריאת LLM שמחויבת לפי השימוש, בצורה <feature>:<model>[:direct]. קריאת LLM כזו מחויבת לפי הטוקנים שהיא משתמשת בהם, ולכן המספר שלה הוא אומדן, והוא מודפס כ-≈N. מזהה בלי מחיר מודפס כ--, עם הסיבה. ראו בדף ה-API קריאות LLM.

חיוב

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

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]

הפקודות plans ו-surface לא שולחות פרטי גישה. הן פונות למופע שב---base-url, ואם אין, למופע של הפרופיל, ואם גם הוא חסר, אל https://app.nodaro.ai. במופע באירוח עצמי, שאין בו חיוב, הפקודות plans ו-subscription נכשלות עם 404. את השדות מתאר הסעיף client.billing בדף מודלים וקרדיטים, ואת מה ש-summary ו-history קוראות מתארים הסעיפים סיכום שימוש וכל התנועות ביתרה שלכם בדף ה-API קרדיטים.

בוררים

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

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]

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

ערכות

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

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]

בעורך משנים את הסדר בגרירה. סקריפטים משתמשים ב-presets.reorder() של ה-SDK.

פלטות ומודבורדים

שמרו צבעים וייחוסי סגנון משלכם, ואז השתמשו באחד מהם ב-generate-image. פלטה נכנסת ל-direction.colorLook בצורה palette:<id>, ומודבורד נכנס ל-direction.style בצורה moodboard:<id>. ראו את הסעיף פלטות ומודבורדים בדף בוררים, ערכות ופרומפטים, במדריך ה-SDK.

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 מחליף את כל התמונות.
• מחיקה של מודבורד לא משנה את התמונות שמקושרות אליו.

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

חבילות קטלוג

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

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 מחזירה משימה.

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 מסיר אותו.

גלריה

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 מתאר את האירועים, את גוף הבקשה ואת הבדיקה של החתימה.

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]

שליטה בהרצות של רכיב יצירת וידאו Pro

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

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.

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]

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

שוטים

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

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 בלבד.

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]

--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.

ראו את הדף Recast דרך MCP כדי להבין איך הרצת Recast עובדת, ואת הדף ה-API של Recast לנקודות הקצה שמאחורי הפקודות האלה.

טרנדים

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

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>

• אפשר לחזור על --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 טרנדים.

איכות מלאה ב-Nodaro Motion

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

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

לכל הרצה יש גרסת איכות מלאה אחת. כשהיא כבר קיימת, הפקודה run מדפיסה את המשימה הזו ולא גובה כלום. הקוד full_quality_pending פירושו שהרינדור ב-1080p של ניסיון קודם נמצא בבדיקה או שעדיין לא התחיל. זה לא מצב סופי: הריצו את הפקודה שוב מאוחר יותר. ראו בדף ה-API איכות מלאה.