# 동영상 깊이

> 어떤 동영상이든 가까운 곳은 밝게, 먼 곳은 어둡게 표시되는 깊이 동영상으로 바꿉니다. Video Depth Anything 또는 프레임별 Depth Anything으로, 그레이스케일이나 컬러맵으로 만듭니다.

Source: https://nodaro.ai/ko/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(프레임별)** 은 각 프레임을 따로 처리하므로 깜박일 수 있습니다. |
| **모델 크기** | **크게(최고 품질)** | **작게(가장 빠름)**, **기본** 또는 **크게(최고 품질)**. 크기가 클수록 더 자세하고 더 느리게 실행됩니다. |
| **컬러맵** | **그레이스케일** | 깊이에 색을 입히는 방식입니다. Video Depth Anything은 **그레이스케일**, **터보**, **인페르노**, **마그마**, **비리디스**를 제공합니다. Depth Anything(프레임별)은 **그레이스케일**과 **인페르노**를 제공합니다. |
| **해상도** | **자동** | 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(프레임별)](https://nodaro.ai/docs/models/video/depth-anything-per-frame) | 각 프레임을 따로 처리하며 깜박일 수 있음 | **모델 크기**, 그리고 **그레이스케일** 또는 **인페르노**의 **컬러맵** | 80초 |

## 크레딧
가격은 모델과 입력 클립의 길이에 따라 정해집니다. 길이는 15초, 30초, 1분, 2분, 5분 중 다음 단계로 올림됩니다.

| 모델 | 15초 | 30초 | 1분 | 2분 | 5분 |
| --- | --- | --- | --- | --- | --- |
| [Video Depth Anything](https://nodaro.ai/docs/models/video/video-depth-anything) | 330 | 660 | 1,320 | 2,640 | 6,600 |
| [Depth Anything(프레임별)](https://nodaro.ai/docs/models/video/depth-anything-per-frame) | 33 | 66 | 132 | 264 | — |

- **단계를 정하는 방법.** 5초 클립과 15초 클립은 모두 15초 단계입니다. 15.01초 클립은 30초 단계이고, 61초 클립은 2분 단계입니다.
- **클립은 실행 전에 측정됩니다.** 읽을 수 없는 클립은 크레딧을 예약하기 전에 거부됩니다. 추측한 길이로 가격이 정해지는 일은 없습니다.
- **노드에 표시되는 가격.** 연결한 동영상의 길이를 알기 전까지 노드에는 15초 단계가 표시됩니다. 길이를 아는 동영상을 연결하면 가격이 업데이트됩니다.
- **Depth Anything(프레임별).** 이 모델은 최대 80초 클립까지 받으므로, 한 번 실행의 가격은 최대 2분 단계입니다.

## 팁
- **다른 노드에는 그레이스케일을 쓰세요.** 그레이스케일은 다른 노드의 입력으로 가장 좋습니다. 컬러맵은 보기 위한 것입니다.
- **작게로 확인하고 크게로 마무리하세요.** 클립을 빠르게 확인하려면 **작게(가장 빠름)** 를, 최종본에는 **크게(최고 품질)** 를 쓰세요.
- **먼저 자르세요.** 가격은 입력 클립의 길이를 따릅니다. 동영상 깊이 앞에서 [동영상 자르기](https://nodaro.ai/docs/nodes/video/trim-video)로 필요한 부분만 남기세요.
- **움직이는 샷에는 Video Depth Anything을 선택하세요.** Depth Anything(프레임별)은 각 프레임을 따로 처리하므로 프레임 사이에 깊이가 깜박일 수 있습니다.

## 문제 해결
| 메시지 또는 문제 | 원인과 해결 방법 |
| --- | --- |
| 클립이 너무 길다며 거부됩니다(`video_too_long`). | 클립이 선택한 모델이 받는 길이보다 깁니다. Video Depth Anything은 프레임 레이트와 관계없이 최대 2,400프레임, 그리고 최대 300초까지 받습니다. 프레임 레이트가 없는 클립은 30fps로 계산합니다. Depth Anything(프레임별)은 최대 80초까지 받습니다. 클립을 잘라서 다시 실행하세요. 크레딧은 예약되지 않습니다. |
| 클립을 읽을 수 없다며 거부됩니다(`video_unreadable`). | Nodaro가 클립을 읽지 못해 길이를 측정할 수 없었습니다. 링크가 동영상 파일로 바로 연결되는지 확인하거나, 파일을 다시 업로드하세요. 크레딧은 예약되지 않습니다. |
| 프레임 사이에 깊이가 깜박입니다. | Depth Anything(프레임별)은 각 프레임을 따로 처리합니다. 프레임 사이에 일관된 **Video Depth Anything**을 선택하세요. |
| 선택한 컬러맵이 결과에 없습니다. | 모델이 그 컬러맵을 렌더링할 수 없어서 **그레이스케일**로 실행되었습니다. Depth Anything(프레임별)은 **그레이스케일**과 **인페르노**만 제공합니다. |

## 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`는 선택 사항입니다. 자세한 내용은 [단일 노드 실행](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(프레임별)은 더 저렴하지만 각 프레임을 따로 처리하므로 깊이가 깜박일 수 있고, 최대 80초 클립까지 받습니다.

### 동영상 길이에 제한이 있나요?

Video Depth Anything은 최대 2,400프레임, 그리고 최대 300초까지 받습니다. 30fps에서는 약 80초입니다. Depth Anything(프레임별)은 최대 80초까지 받습니다. 더 긴 클립은 크레딧을 예약하기 전에 거부됩니다.

### 동영상 깊이 실행의 가격은 어떻게 정해지나요?

가격은 모델과 입력 클립의 길이에 따라 정해집니다. 길이는 15초, 30초, 1분, 2분, 5분 중 다음 단계로 올림됩니다. 클립 길이는 실행 전에 측정됩니다.

### 그레이스케일과 컬러맵 중 무엇을 써야 하나요?

깊이 동영상을 다른 노드에 전달할 때는 기본값인 그레이스케일을 그대로 두세요. 터보나 인페르노 같은 컬러맵은 깊이를 보기 위한 것입니다.