# העלאות

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

Source: https://nodaro.ai/he/docs/mcp/tools/uploads

**כלי ההעלאה** מכניסים ל-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`. העוזר מעלה את הקובץ כך:

```bash
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`](https://nodaro.ai/docs/mcp/tools/gallery-and-assets#browse_uploads), שמציג את הקבצים שהעליתם, בנפרד מהתוצאות ש-Nodaro יצר.
- **הציגו לוגו בסרטון עם קריינות.** הלוגו של המותג ש[במאי הווידאו](https://nodaro.ai/docs/mcp/video-director) משתמש בו חייב להיות תמונה שהועלתה ל-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. הכלי מציג את הקבצים שהעליתם עם הכתובות שלהם, ואת הכתובות האלה אפשר להעביר לכל כלי יצירה.