# עומק וידאו

> הפכו כל סרטון לסרטון עומק, שבו הקרוב בהיר והרחוק כהה, עם Video Depth Anything או Depth Anything לכל פריים, בגווני אפור או במפת צבעים.

Source: https://nodaro.ai/he/docs/nodes/video/video-depth

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

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

## התחלה מהירה
### הוספת הרכיב
הקישו Tab על הקנבס ובחרו **וידאו › המשך ועיצוב מחדש › עומק וידאו**.

### חיבור סרטון
גררו מהפלט של רכיב וידאו, כגון [העלאת וידאו](https://nodaro.ai/docs/nodes/video/upload-video) או [יצירת וידאו](https://nodaro.ai/docs/nodes/video/generate-video), אל הקלט **וידאו**.

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

### הרצה
לחצו על **הרצה** ברכיב. כרטיס הרכיב מציג את סרטון העומק, עם כיתוב שמציין את המודל, למשל ״מפת עומק · Video Depth Anything״.

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

- העלאת וידאו → עומק וידאו (וידאו)
- עומק וידאו → שמירה לאחסון

## קלטים
| קלט | מקבל | מה הוא עושה |
| --- | --- | --- |
| **וידאו** | רכיבי וידאו | הקליפ שהופכים לסרטון עומק. נדרש. האורך שלו קובע את המחיר, והוא חייב להיות בתוך המגבלה של המודל שנבחר. |

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

## הגדרות
| הגדרה | ברירת מחדל | מה היא עושה |
| --- | --- | --- |
| **ספק** | **Video Depth Anything** | המודל. **Video Depth Anything** עקבי מפריים לפריים. **Depth Anything (per frame)** רץ על כל פריים בנפרד ועלול להבהב. |
| **גודל מודל** | **גדול (האיכותי ביותר)** | **קטן (המהיר ביותר)**, **בסיסי** או **גדול (האיכותי ביותר)**. מודל גדול יותר נותן יותר פרטים ורץ לאט יותר. |
| **מפת צבעים** | **גווני אפור** | איך העומק נצבע. Video Depth Anything מציע **גווני אפור**, **טורבו**, **אינפרנו**, **מאגמה** ו**וירידיס**. Depth Anything (per frame) מציע **גווני אפור** ו**אינפרנו**. |
| **רזולוציה** | **אוטומטי** | ב-Video Depth Anything בלבד. **אוטומטי**, 360p, 480p, 720p או 1080p. |
| **זה לצד זה** | כבוי | ב-Video Depth Anything בלבד. מציב את המקור ואת העומק אחד ליד השני בסרטון אחד. |

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

## מודלים
| Model | Maker | Modes | Credits | Details |
| --- | --- | --- | --- | --- |
| [Video Depth Anything](https://nodaro.ai/docs/models/video/video-depth-anything) | Depth Anything | Video depth | החל מ-330 | Temporally consistent depth video from any clip. Grayscale or colormapped, up to 2,400 frames or 300 seconds. |
| [Depth Anything (per frame)](https://nodaro.ai/docs/models/video/depth-anything-per-frame) | Depth Anything | Video depth | החל מ-33 | Depth Anything v1 run on each frame. Grayscale or inferno colormap; may flicker between frames. Up to 80 s. |

| מודל | מפריים לפריים | הגדרות | אורך מרבי |
| --- | --- | --- | --- |
| [Video Depth Anything](https://nodaro.ai/docs/models/video/video-depth-anything) | עקבי | כל חמש ההגדרות | 2,400 פריימים ולכל היותר 300 שנ׳ |
| [Depth Anything (per frame)](https://nodaro.ai/docs/models/video/depth-anything-per-frame) | כל פריים בנפרד, עלול להבהב | **גודל מודל**, וגם **מפת צבעים** עם **גווני אפור** או **אינפרנו** | 80 שנ׳ |

## קרדיטים
המחיר נקבע לפי המודל והאורך של קליפ הקלט. הקליפ נמדד לפני ההרצה.

החיוב על **Video Depth Anything** הוא לפי שנייה של הקליפ. האורך מעוגל כלפי מעלה לשניות שלמות, ולכן קליפ של פחות משנייה אחת עולה כמו שנייה אחת, וקליפ של 9.2 שניות עולה כמו 10 שניות. עוד לפני העיגול, חריגה של עד 0.05 שנייה מעבר לשנייה שלמה לא נספרת: קטע של 12 שניות מקליפ ב-29.97 פריימים לשנייה יוצא באורך 12.012 שניות, ועולה כמו 12 שניות.

| קליפ | החיוב לפי | קרדיטים |
| --- | --- | --- |
| 15 שנ׳ | 15 שנ׳ | 330 |
| 30 שנ׳ | 30 שנ׳ | 660 |
| דקה אחת | 60 שנ׳ | 1,320 |
| 2 דק׳ | 120 שנ׳ | 2,640 |
| 5 דק׳ (המקסימום) | 300 שנ׳ | 6,600 |

הרכיב מציג את המחיר המדויק של הקליפ המחובר לפני שהוא רץ. אותו קליפ מתומחר באותו מחיר בכל מקום: בעורך, בהרצה של הרכיב לבד, בהרצה בתוך תהליך, וב-API, ב-MCP וב-SDK. הסכום שמשוריין כשההרצה מתחילה הוא הסכום שנגבה.

גם החיוב על **Depth Anything (per frame)** הוא לפי שנייה של הקליפ, בתעריף נמוך יותר. אחרי שמתעלמים מאותה חריגה של 0.05 שנייה, האורך מעוגל כלפי מעלה לשניות שלמות, וכל סכום מעוגל כלפי מעלה לקרדיט שלם. קליפ של פחות משנייה אחת עולה כמו שנייה אחת, קליפ של 4.1 שניות עולה כמו 5 שניות, וקטע של 15 שניות מקליפ ב-29.97 פריימים לשנייה (15.015 שניות) עולה כמו 15 שניות.

| קליפ | החיוב לפי | קרדיטים |
| --- | --- | --- |
| 15 שנ׳ | 15 שנ׳ | 33 |
| 30 שנ׳ | 30 שנ׳ | 66 |
| דקה אחת | 60 שנ׳ | 132 |

Depth Anything (per frame) מקבל קליפים של עד 80 שניות, ולכן הרצה עולה לכל היותר כמו קליפ של 80 שניות.

- **הקליפ נמדד לפני ההרצה.** קליפ שאי אפשר לקרוא נדחה עוד לפני שמשוריינים קרדיטים. הרצה אף פעם לא מתומחרת לפי אורך משוער.
- **המחיר ברכיב.** העורך קורא את האורך מהקליפ המחובר עצמו, ולכן הרכיב ואומדן ההרצה מציגים את המחיר של הקליפ הזה. עד שהאורך ידוע, הרכיב והאומדנים מציגים את המחיר הגבוה ביותר של המודל, כלומר הסכום המרבי שהרצה יכולה לעלות: המחיר של 5 דקות ב-Video Depth Anything ושל 80 שניות ב-Depth Anything (per frame). המחיר הגבוה ביותר מוצג כששום דבר לא מחובר, כשהקליפ עוד לא נקרא, או כשאי אפשר לקרוא אותו. ההרצה עצמה תמיד מחויבת לפי המחיר של הקליפ שנמדד.
- **המחיר של אפליקציה שפורסמה.** גם האומדן של תהליך והמחיר שמוצג לאפליקציה שפורסמה קוראים מתוך הקובץ את האורך של קליפ שהועלה. כשמי שמשתמש באפליקציה מחליף את הקובץ שהועלה, האומדן מציג את המחיר הגבוה ביותר, עד שההרצה מודדת את הקליפ החדש.

## טיפים
- **השאירו גווני אפור כשהתוצאה מזינה רכיבים אחרים.** כקלט לרכיב אחר, גווני אפור עדיפים. מפות צבעים נועדו לצפייה.
- **בדקו עם מודל קטן, וסיימו עם מודל גדול.** בחרו **קטן (המהיר ביותר)** כדי לבדוק קליפ במהירות, ו**גדול (האיכותי ביותר)** למעבר הסופי.
- **קצצו קודם.** המחיר נקבע לפי האורך של קליפ הקלט. לפני רכיב עומק וידאו, קצצו את הקליפ לחלק שאתם צריכים בעזרת רכיב [קיצוץ וידאו](https://nodaro.ai/docs/nodes/video/trim-video).
- **בשוטים עם תנועה, בחרו Video Depth Anything.** Depth Anything (per frame) עובד על כל פריים בנפרד, ולכן העומק עלול להבהב בין פריימים.

## פתרון בעיות
| הודעה או בעיה | סיבה ופתרון |
| --- | --- |
| הקליפ נדחה כארוך מדי (`video_too_long`). | הקליפ ארוך יותר ממה שהמודל שנבחר מקבל. Video Depth Anything מקבל עד 2,400 פריימים ולכל היותר 300 שניות, בכל קצב פריימים. קליפ שלא מדווח על קצב פריימים נספר כ-30 פריימים לשנייה. Depth Anything (per frame) מקבל עד 80 שניות. קצצו את הקליפ והריצו שוב. לא משוריינים קרדיטים. |
| הקליפ נדחה כי אי אפשר לקרוא אותו (`video_unreadable`). | Nodaro לא הצליח לקרוא את הקליפ כדי למדוד את האורך שלו. בדקו שהקישור הוא קישור ישיר לקובץ וידאו, או העלו את הקובץ שוב. לא משוריינים קרדיטים. |
| העומק מהבהב בין פריימים. | Depth Anything (per frame) עובד על כל פריים בנפרד. בחרו **Video Depth Anything**, שהוא עקבי מפריים לפריים. |
| מפת צבעים שבחרתם לא מופיעה בתוצאה. | המודל לא יכול לרנדר את מפת הצבעים הזו, ולכן ההרצה השתמשה ב**גווני אפור**. Depth Anything (per frame) מציע רק **גווני אפור** ו**אינפרנו**. |

## דרך ה-API
הנתיב `POST /v1/video-depth` מקבל את `videoUrl`, ואת השדות האופציונליים `provider`, `modelSize`, `colormap`, `resolution` ו-`sideBySide`. הערך של `provider` הוא `video-depth-anything` (ברירת המחדל) או `depth-anything-frames`, והערך של `modelSize` הוא `small`, `base` או `large` (ברירת המחדל). הערך של `colormap` הוא `grayscale`, `turbo`, `inferno`, `magma` או `viridis`, והערך של `resolution` הוא `auto`, `360p`, `480p`, `720p` או `1080p`.

```http
POST /v1/video-depth
Content-Type: application/json

{
"videoUrl": "https://example.com/clip.mp4",
"provider": "video-depth-anything",
"modelSize": "large",
"colormap": "grayscale"
}
```

התגובה היא `{ jobId }`, והפלט של המשימה שהסתיימה הוא `{ videoUrl, thumbnailUrl }`. הגדרה שהמודל לא מקבל לא נלקחת בחשבון, ומפת צבעים שהוא לא יכול לרנדר הופכת ל-`grayscale`. ערך שלא מופיע ברשימות שלמעלה נדחה עם `400 validation_error`. הקליפ נמדד לפני שנוצר משהו: כשההרצה נדחית עם `400 video_too_long` או עם `400 video_unreadable`, לא משוריין כלום.

ב-SDK, הריצו את הרכיב לפי הסוג שלו:

```ts
const result = await client.nodes.run("video-depth", {
videoUrl: "https://example.com/clip.mp4",
colormap: "grayscale",
})
```

ב-CLI:

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

מתוך עוזר AI, כלי ה-MCP הוא `video_depth`, עם `video_url` או `video_asset_id`, ועם השדות האופציונליים `provider`, `model_size`, `colormap`, `resolution` ו-`side_by_side`. ראו את דף ה-API [הרצת רכיב יחיד](https://nodaro.ai/docs/developers/api/nodes), את הדפים [הרצת רכיבים ב-SDK](https://nodaro.ai/docs/developers/sdk/nodes) ו[פקודות ה-CLI](https://nodaro.ai/docs/developers/cli/commands), ואת [מדריך כלי ה-MCP](https://nodaro.ai/docs/mcp/tools).

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

### מה מפיק רכיב עומק וידאו?

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

### באיזה מודל לבחור ברכיב עומק וידאו?

ברכיב עומק וידאו, ברוב המקרים בחרו ב-Video Depth Anything. המודל הזה עקבי מפריים לפריים ומציע את כל ההגדרות. Depth Anything (per frame) זול יותר, אבל הוא עובד על כל פריים בנפרד, ולכן העומק עלול להבהב, והוא מקבל קליפים של עד 80 שניות.

### מה האורך המרבי של הסרטון ברכיב עומק וידאו?

ברכיב עומק וידאו, Video Depth Anything מקבל עד 2,400 פריימים ולכל היותר 300 שניות, כלומר בערך 80 שניות ב-30 פריימים לשנייה. Depth Anything (per frame) מקבל עד 80 שניות. קליפ ארוך יותר נדחה עוד לפני שמשוריינים קרדיטים.

### איך מתומחרת הרצה של רכיב עומק וידאו?

המחיר של רכיב עומק וידאו נקבע לפי המודל והאורך של קליפ הקלט, שנמדד לפני ההרצה. החיוב על Video Depth Anything הוא לפי שנייה, והאורך מעוגל כלפי מעלה לשניות שלמות. גם החיוב על Depth Anything (per frame) הוא לפי שנייה, בתעריף נמוך יותר. עוד לפני העיגול, חריגה של עד 0.05 שנייה מעבר לשנייה שלמה לא נספרת.

### במה עדיף להשתמש, בגווני אפור או במפת צבעים?

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