פרמטרים וקובצי קלט

פרמטרים הם הערכים שמעבירים להרצה בשורת הפקודה. הפקודה nodaro nodes run מקבלת אותם בצורה --param key=value, והפקודה nodaro apps run בצורה --input key=value. אפשר לחזור על כל אחד משני הדגלים, שניהם פועלים לפי אותם כללים, וקובץ JSON עם --params-file מכסה כל מה שלא נכנס בדגל.

כתיבת זוגות key=value

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

nodaro nodes run generate-video \
  --param prompt="a paper boat drifting down a rainy street" \
  --param provider=seedance-2-fast \
  --param duration=8

ה-CLI קובע לכל ערך סוג לפני שהוא שולח את הבקשה:

רק ה-= הראשון מפריד בין המפתח לערך. שאר הטקסט נשמר, ולכן עם --param query=a=b=c נשלחת המחרוזת a=b=c.

כך נראה מערך JSON שכתוב בתוך הפקודה. הקיפו את הזוג במירכאות בודדות, כדי שה-shell ישאיר את המירכאות הכפולות:

nodaro nodes run generate-image --param prompt="the same mug on a marble counter" --param 'referenceImageUrls=["https://example.com/mug-front.png","https://example.com/mug-side.png"]'

ב-generate-image וב-text-to-video, השדה subject מציין מי נמצא בשוט, לפי מזהים מהקטלוג. ערך שמתחיל ב-{ מפוענח כ-JSON, ולכן המפה כולה נכנסת ב---param אחד. שמות השדות והמזהים מגיעים מ-nodaro pickers get person, וגם מ-styling, מ-held-prop, מ-material ומ-animal. את הניסוח כותב Nodaro. ראו את דף ה-API רכיבים.

nodaro nodes run generate-image --param prompt="on the seawall at dusk" \
  --param subject='{"type":"woman","age":"age-30s","heldProp":"smartphone"}' --watch

כדי לגלות אילו מפתחות רכיב מקבל, הריצו nodaro nodes get <type>. לאפליקציה, הריצו nodaro apps get <slug>.

שליחת קובץ JSON

לאובייקטים מקוננים, למערכים ארוכים או לכל ערך שלא מתאים לצורה של דגל, כתבו את כל גוף הבקשה לקובץ JSON והעבירו אותו עם --params-file. הקובץ חייב להכיל אובייקט JSON אחד.

cat > body.json <<'EOF'
{
  "prompt": "a lighthouse on a cliff at dawn, cinematic",
  "provider": "flux",
  "aspectRatio": "16:9"
}
EOF

nodaro nodes run generate-image --params-file body.json --param aspectRatio=9:16

הדגלים גוברים על הקובץ. בדוגמה הזו, ההרצה משתמשת ביחס הגובה־רוחב 9:16 מהדגל, ובשאר גוף הבקשה מהקובץ.

קביעת קלטים של אפליקציה ושדות גולמיים של רכיבים

הפקודה nodaro apps run מקבלת את שמות הקלטים של האפליקציה כמפתחות:

nodaro apps run hair-styler-dd3erw --input prompt="curly red hair" --watch

הדגל --override מגיע לשדות של רכיבים שהאפליקציה לא חושפת, להרצה הזו בלבד. כתבו אותו בצורה <nodeId>.<field>=<value>:

nodaro apps run hair-styler-dd3erw --input prompt="curly red hair" \
  --override n1.promptPrefix="Studio portrait of" --override n1.promptSuffix=", 85mm, soft light"

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

הרצה של רכיבי קלט ורכיבי מקור

רכיבי קלט ורכיבי מקור רצים באותה דרך. רכיב גריפת אתר, web-scrape, מקבל את המקור שלו בשדה actor: google-search, content-crawler, rss או tiktok.

# Google Search results
nodaro nodes run web-scrape --param actor=google-search --param query="running shoes" --param maxResults=5

# The text of one web page, as Markdown
nodaro nodes run web-scrape --param actor=content-crawler --param url=https://example.com --param mode=page

בהתקנה באירוח עצמי, רכיב גריפת אתר צריך את APIFY_API_TOKEN בשרת, או חיבור ל-Nodaro Cloud שדרכו הגריפה רצה ומחויבת.