> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-feat-openapi-i18n.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# ComfyUI Depth Anything 3 공식 예제

> ComfyUI에서 Depth Anything 3를 사용하여 이미지 및 비디오의 단일/다중 뷰 깊이 추정 방법을 알아보세요.

# ComfyUI Depth Anything 3 소개

[Depth Anything 3 (DA3)](https://github.com/ByteDance-Seed/Depth-Anything-3)은 ByteDance Seed의 비전 트랜스포머로, 카메라 포즈 유무와 관계없이 임의의 시각적 입력으로부터 공간적으로 일관된 기하학 정보를 복원합니다. 단일 DINO 인코더와 통합된 깊이-레이 표현을 통해 동일한 모델 패밀리로 단일 뷰 깊이, 다중 뷰 깊이, 카메라 포즈 추정 및 3D 재구성을 모두 처리합니다.

주요 기능:

* **통합 단일/다중 뷰 깊이**: 단일 또는 여러 이미지에서 깊이 추정
* **카메라 포즈 추정**: 순서 없는 이미지 세트에서 카메라 위치 복원
* **3D 재구성**: 다중 뷰 입력 지원
* **비디오 깊이 추정**: 비디오 입력에 대한 프레임별 깊이 시퀀스 생성
* **여러 모델 변형**: Small, Base, Mono/Metric Large

<Tip>
  <Tabs>
    <Tab title="휴대용 또는 자체 배포 사용자">
      ComfyUI가 최신 버전으로 업데이트되었는지 확인하세요.

      * [ComfyUI 다운로드](https://www.comfy.org/download)
      * [업데이트 가이드](/ko/installation/update_comfyui)

      이 가이드의 워크플로우는 [워크플로우 템플릿](/ko/interface/features/template)에서 확인할 수 있습니다.
      템플릿에서 찾을 수 없다면, 귀하의 ComfyUI가 오래된 버전일 수 있습니다. (데스크톱 버전의 업데이트는 다소 지연될 수 있습니다)

      워크플로우를 로드할 때 노드가 누락되는 경우, 가능한 원인:

      1. 최신 ComfyUI 버전(야간 빌드)을 사용하고 있지 않음
      2. 일부 노드가 시작 시 가져오기에 실패함
    </Tab>

    <Tab title="데스크톱 또는 클라우드 사용자">
      * 데스크톱 버전은 ComfyUI 안정판 기반으로, 새로운 데스크톱 안정판이 출시되면 자동으로 업데이트됩니다.
      * [클라우드](https://cloud.comfy.org)는 ComfyUI 안정판 출시 후 업데이트됩니다.

      따라서 이 문서에서 핵심 노드가 누락된 것을 발견했다면, 그 이유는 새로운 핵심 노드가 아직 최신 안정판에 공개되지 않았기 때문일 수 있습니다. 다음 안정판 출시를 기다려 주세요.
    </Tab>
  </Tabs>
</Tip>

<Tip>
  ComfyUI는 이제 Depth Anything 3 노드를 기본 지원합니다. 시작하기 전에 [ComfyUI](https://github.com/Comfy-Org/ComfyUI)를 최신 버전으로 업데이트하세요.
</Tip>

## 모델 설치

Depth Anything 3 체크포인트를 다운로드하여 해당 ComfyUI 폴더에 저장합니다:

* **Small** ([depth\_anything\_3\_small.safetensors](https://huggingface.co/Comfy-Org/Depth-Anything-3/resolve/main/geometry_estimation/depth_anything_3_small.safetensors)) — 가볍고 빠른 추론
* **Base** ([depth\_anything\_3\_base.safetensors](https://huggingface.co/Comfy-Org/Depth-Anything-3/resolve/main/geometry_estimation/depth_anything_3_base.safetensors)) — 균형 잡힌 성능
* **Mono-Large** ([depth\_anything\_3\_mono\_large.safetensors](https://huggingface.co/Comfy-Org/Depth-Anything-3/resolve/main/geometry_estimation/depth_anything_3_mono_large.safetensors)) — 단일 뷰 깊이에 최적 (하늘 감지 포함)
* **Metric-Large** ([depth\_anything\_3\_metric\_large.safetensors](https://huggingface.co/Comfy-Org/Depth-Anything-3/resolve/main/geometry_estimation/depth_anything_3_metric_large.safetensors)) — 미터 단위의 물리적 깊이 (하늘 감지 포함)

```
ComfyUI/
├── models/
│   ├── geometry_estimation/
│   │   ├── depth_anything_3_small.safetensors
│   │   ├── depth_anything_3_base.safetensors
│   │   ├── depth_anything_3_mono_large.safetensors
│   │   └── depth_anything_3_metric_large.safetensors
```

## 예제 워크플로우

***

## 1. 이미지 깊이 추정

**기능 설명:** 이미지 1장을 업로드하고 \*\*Image Depth Estimation (Depth Anything 3)\*\*을 실행하여 깊이 맵을 생성합니다. **Depth Preview**에 원본 이미지와 깊이 출력의 나란히 비교 결과가 표시됩니다.

<CardGroup cols={2}>
  <Card title="워크플로우 다운로드" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/utility_depth_anything3_image_depth_estimation.json">
    JSON 다운로드 또는 템플릿 라이브러리에서 "Depth Anything 3" 검색
  </Card>

  <Card title="샘플 이미지 다운로드" icon="image" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/retro_futuristic_home.png">
    이 워크플로우의 예제 입력 이미지 가져오기
  </Card>
</CardGroup>

<div style={{display: 'flex', gap: '1rem', flexWrap: 'wrap'}}>
  <img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/utility_depth_anything3_image_depth_estimation-1.webp" alt="이미지 깊이 추정 출력" style={{maxWidth: '48%', height: 'auto'}} />

  <img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/utility_depth_anything3_image_depth_estimation-2.webp" alt="이미지 깊이 추정 비교" style={{maxWidth: '48%', height: 'auto'}} />
</div>

### 실행 단계

1. **LoadImage** — 입력 이미지 로드
2. **LoadDA3Model** — Depth Anything 3 변형 선택
3. **실행** — Queue 클릭 또는 `Cmd+Enter`
4. 워크플로우가 깊이 맵과 나란히 비교 결과 출력

<Card title="서브그래프 알아보기" icon="book-open" href="/ko/interface/features/subgraph">
  이 워크플로우는 모듈식 처리를 위해 서브그래프 노드를 사용합니다. 서브그래프 사용자 지정 및 확장에 대한 자세한 내용은 서브그래프 문서를 확인하세요.
</Card>

***

## 2. 비디오 깊이 추정

**기능 설명:** 비디오를 업로드하고 \*\*Video Depth Estimation (Depth Anything 3)\*\*을 실행하여 프레임별 깊이 시퀀스를 생성합니다. 서브그래프 내에서 **GetVideoComponents**가 입력 비디오를 프레임으로 분할하고, **LoadDA3Model**이 모델을 로드하며, **SetVideoComponents**가 깊이 프레임을 비디오로 재구성합니다.

<CardGroup cols={2}>
  <Card title="워크플로우 다운로드" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/utility_depth_anything3_video_depth_estimation.json">
    JSON 다운로드 또는 템플릿 라이브러리에서 "Depth Anything 3" 검색
  </Card>

  <Card title="Comfy Cloud에서 실행" icon="cloud" href="https://cloud.comfy.org/?template=utility_depth_anything3_video_depth_estimation&utm_source=docs&utm_medium=referral&utm_campaign=depth-anything-3">
    Comfy Cloud에서 열기
  </Card>
</CardGroup>

![비디오 깊이 추정 미리보기](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/utility_depth_anything3_video_depth_estimation-1.webp)

### 실행 단계

1. **LoadVideo** — 입력 비디오 로드
2. **모델 선택** — **Small**, **Base**, **Mono-Large** 또는 **Metric-Large** 중 선택
3. **실행** — Queue 클릭 또는 `Cmd+Enter`
4. 워크플로우가 프레임별 깊이 맵 비디오 출력

<Card title="서브그래프 알아보기" icon="book-open" href="/ko/interface/features/subgraph">
  이 워크플로우는 모듈식 처리를 위해 서브그래프 노드를 사용합니다. 서브그래프 사용자 지정 및 확장에 대한 자세한 내용은 서브그래프 문서를 확인하세요.
</Card>

## 모델 변형

| 변형               | head\_type | 하늘 감지 | 신뢰도 | 카메라 디코더 | 최적 용도            |
| ---------------- | ---------- | :---: | :-: | :-----: | ---------------- |
| **Small**        | dualdpt    |   ❌   |  ✅  |    ✅    | 빠른 추론, 모바일/엣지    |
| **Base**         | dualdpt    |   ❌   |  ✅  |    ✅    | 균형 잡힌 성능         |
| **Mono-Large**   | dpt        |   ✅   |  ❌  |    ❌    | 하늘 감지 지원 단일 뷰 깊이 |
| **Metric-Large** | dpt        |   ✅   |  ❌  |    ❌    | 미터 단위 물리적 깊이     |

* **Small**과 **Base**는 `dualdpt` 헤드 유형을 사용하며, 신뢰도 추정 및 카메라 디코더를 지원합니다(다중 뷰 애플리케이션용).
* **Mono-Large**와 **Metric-Large**는 `dpt` 헤드 유형을 사용하며, 하늘 감지를 지원합니다. Metric-Large는 미터 단위의 원시 깊이를 출력합니다。

## 커뮤니티 리소스

* [Depth Anything 3 GitHub (ByteDance-Seed)](https://github.com/ByteDance-Seed/Depth-Anything-3) — 연구 논문 및 코드
* [Comfy-Org/Depth-Anything-3](https://huggingface.co/Comfy-Org/Depth-Anything-3) — 공식 ComfyUI 모델 가중치