תיעוד Nodaroהעלאות
העלו ל-Nodaro תמונות, אודיו ווידאו משלכם מכל לקוח MCP: בחלון העלאה בצ׳אט, בקישור העלאה בדפדפן או בכתובת חתומה מראש מ-shell.
כלי ההעלאה מכניסים ל-Nodaro קבצים משלכם, כדי שעוזר AI יוכל להשתמש בתמונה, בהקלטת קול או בקליפ ביצירה הבאה. יש שלוש דרכים להעלות: חלון העלאה בתוך הצ׳אט, קישור שפותחים בדפדפן וכתובת חתומה מראש ללקוחות שיכולים להריץ פקודות shell. כל כלי העלאה צריך את ההרשאה assets:write, והעלאת קבצים לא עולה קרדיטים.
באיזו שיטה להשתמש
| שיטה | כלים | איפה היא עובדת | איך היא עובדת |
|---|---|---|---|
| חלון העלאה בצ׳אט | upload_image_widget, upload_audio_widget, upload_video_widget | לקוחות שמציגים MCP Apps, כמו Claude בדפדפן | חלון בחירת קבצים נפתח בתוך הצ׳אט. הכתובת הציבורית חוזרת לצ׳אט מעצמה. |
| קישור בדפדפן | request_image_upload, request_audio_upload, request_video_upload | כל לקוח | פותחים קישור של Nodaro בדפדפן וגוררים לשם את הקובץ. |
| כתובת חתומה מראש | prepare_image_upload, prepare_audio_upload, prepare_video_upload | לקוחות עם גישה ל-shell, כמו Cursor, Cline, Claude Desktop ו-Claude Code | העוזר שולח את הקובץ בעצמו בפקודת curl אחת. |
כשלקובץ כבר יש כתובת ציבורית, למשל תוצאה של משימה קודמת, העבירו את הכתובת הזו ישירות ודלגו על ההעלאה.
upload_image_widget
פותח בתוך הצ׳אט חלון לבחירת תמונות. בטלפון, החלון פותח את המצלמה או את ספריית התמונות. החלון מעלה את הקבצים ומדווח לצ׳אט על הכתובות הציבוריות שלהם, כך שצריך ללחוץ עליו פעם אחת בלבד. הכלים upload_audio_widget ו-upload_video_widget עובדים באותו אופן לאודיו ולווידאו.
הרשאה: assets:write. קרדיטים: חינם.
| פרמטר | סוג | הערות |
|---|---|---|
max_files | integer | כמה קבצים החלון מקבל, מ-1 עד 10. ברירת המחדל: 1. השתמשו בערך גבוה יותר כשצריך כמה קבצים, למשל כמה תמונות ייחוס של אותו אדם. |
purpose | string | תווית קצרה שמוצגת בכרטיס ההעלאה, עד 120 תווים, למשל product image for the catalog app (תמונת מוצר לאפליקציית הקטלוג). התווית גם מזכירה לעוזר למה הקובץ נועד. |
מה חוזר: uploads, רשימה של זוגות { upload_url, public_url }, ובנוסף upload_url ו-public_url של הקובץ הראשון. לקוח שלא מציג את החלון עדיין יכול להציג את הכתובות האלה כקישורים רגילים.
request_image_upload
מחזיר קישור קצר של Nodaro לדף שפותחים בכל דפדפן וגוררים אליו תמונה. הכלי עובד בכל לקוח ובכל גודל קובץ, כי הקובץ עובר דרך הדפדפן שלכם. הכלים request_audio_upload ו-request_video_upload עושים את אותו הדבר לאודיו ולווידאו.
הרשאה: assets:write. קרדיטים: חינם.
לכלי הזה אין פרמטרים.
מה חוזר: upload_page_url, הדף שצריך לפתוח, ו-public_url, הכתובת שתהיה לקובץ. הכתובת הציבורית ידועה מראש, ולכן העוזר יכול להשתמש בה בקריאה הבאה ברגע שתאשרו שההעלאה הסתיימה.
prepare_image_upload
מחזיר כתובת העלאה חתומה מראש, שהעוזר שולח אליה את הקובץ עם curl. הקובץ אף פעם לא עובר דרך השיחה, ולכן הגודל שלו לא משנה. הכלים prepare_audio_upload ו-prepare_video_upload עושים את אותו הדבר לאודיו ולווידאו.
הרשאה: assets:write. קרדיטים: חינם.
| פרמטר | סוג | הערות |
|---|---|---|
mime_type | string | נדרש. הסוג של הקובץ שתשלחו. |
| כלי | ערכי mime_type שמתקבלים |
|---|---|
prepare_image_upload | image/png, image/jpeg, image/webp, image/avif, image/heic, image/heif |
prepare_audio_upload | audio/mpeg, audio/mp4, audio/wav, audio/x-wav, audio/webm, audio/ogg, audio/flac, audio/x-flac, audio/aac, audio/x-m4a |
prepare_video_upload | video/mp4, video/webm, video/quicktime, video/x-matroska |
מה חוזר: upload_url, כתובת שתקפה לשעה אחת, ו-public_url. העוזר מעלה את הקובץ כך:
curl -X PUT --data-binary @path/to/file -H 'Content-Type: image/png' '<upload_url>'אחר כך הוא מעביר את public_url לכלי הבא, למשל כ-image_url.
לא ל-Claude בדפדפן
ההעלאה בכתובת חתומה מראש נכשלת ב-Claude בדפדפן ובאפליקציית Claude לאנדרואיד, כי הם לא יכולים להגיע לשרת האחסון. שם, השתמשו בחלון ההעלאה בצ׳אט או בקישור בדפדפן.
אחרי ההעלאה
- העבירו את הכתובת הציבורית לכל כלי שמקבל מדיה, כמו
modify_image,animate_image,lip_syncאוadd_captions. - מצאו קבצים שהעליתם קודם עם
browse_uploads, שמציג את הקבצים שהעליתם, בנפרד מהתוצאות ש-Nodaro יצר. - הציגו לוגו בסרטון עם קריינות. הלוגו של המותג שבמאי הווידאו משתמש בו חייב להיות תמונה שהועלתה ל-Nodaro, ולכן העלו אותו קודם עם אחד מהכלים האלה.
שאלות נפוצות
איזה כלי העלאה עובד בכל לקוח MCP?
כלי ההעלאה request_image_upload, request_audio_upload ו-request_video_upload עובדים בכל לקוח MCP. הם מחזירים קישור לדף שפותחים בדפדפן שלכם וגוררים אליו את הקובץ, ולכן הם עובדים בכל לקוח ובכל גודל קובץ.
למה הכלי prepare_image_upload נכשל ב-Claude בדפדפן?
ההעלאה בכתובת חתומה מראש דורשת לקוח שיכול לשלוח את הקובץ בעצמו בפקודת shell. Claude בדפדפן ואפליקציית Claude לאנדרואיד לא יכולים להגיע לשרת האחסון, ולכן שם השתמשו בחלון ההעלאה בצ׳אט או בקישור ההעלאה בדפדפן.
האם אפשר להעלות כמה תמונות ייחוס בבת אחת?
כן. העבירו לכלי upload_image_widget את הפרמטר max_files, עם ערך מ-1 עד 10. חלון ההעלאה מקבל אז מספר קבצים כזה ומחזיר כתובת ציבורית אחת לכל קובץ.
איך משתמשים שוב בקובץ שהעליתי קודם?
בקשו מהעוזר לקרוא לכלי browse_uploads. הכלי מציג את הקבצים שהעליתם עם הכתובות שלהם, ואת הכתובות האלה אפשר להעביר לכל כלי יצירה.
דפים קשורים
מדריך כלי ה-MCP
גלריה ונכסים
חיבור Claude
העלאת תמונה
עודכן לאחרונה