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

# MoGeInference - ComfyUI Built-in Node Documentation

> 이미지에서 MoGe를 실행하여 깊이와 기하 구조를 추정합니다. 이 노드는 입력 이미지를 MoGe 모델을 통해 처리하여 3D 포인트 클라우드, 깊이 맵, 카메라 내부 파라미터, 마스크 및 표면 법선을 생성합니다.

이미지에서 MoGe를 실행하여 깊이와 기하 구조를 추정합니다. 이 노드는 입력 이미지를 MoGe 모델을 통해 처리하여 3D 포인트 클라우드, 깊이 맵, 카메라 내부 파라미터, 마스크 및 표면 법선을 생성합니다.

## 입력

| 매개변수               | 설명                                                                                                                                                                 | 데이터 타입      | 필수 | 범위                    |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------- | -- | --------------------- |
| `moge_model`       | 추론에 사용할 MoGe 모델입니다.                                                                                                                                                | MOGE\_MODEL | 예  | N/A                   |
| `image`            | 깊이 및 기하 구조 추정을 위한 입력 이미지입니다. 처음 세 개의 색상 채널(RGB)만 사용됩니다.                                                                                                            | IMAGE       | 예  | N/A                   |
| `resolution_level` | 처리 해상도를 제어합니다. 0 = 가장 빠름, 9 = 가장 세밀함. (기본값: 9)                                                                                                                     | INT         | 예  | 0 \~ 9                |
| `fov_x_degrees`    | (고급) 소스 카메라의 수평 화각입니다. 깊이 맵을 3D로 역투영하는 데 사용되는 초점 거리를 설정합니다. 0 = 예측된 포인트에서 자동 복구합니다. (기본값: 0.0)                                                                     | FLOAT       | 예  | 0.0 \~ 170.0 (단계 0.1) |
| `batch_size`       | 추론 호출당 이미지 수입니다. 긴 비디오/이미지 세트에서 OOM이 발생하면 낮추십시오. (기본값: 4)                                                                                                          | INT         | 예  | 1 \~ 64               |
| `force_projection` | (고급) 예측된 포인트의 투영을 강제합니다. (기본값: True)                                                                                                                               | BOOLEAN     | 예  | True/False            |
| `apply_mask`       | (고급) 마스크 처리된(하늘/유효하지 않은) 픽셀을 포인트와 깊이에서 inf로 설정하여 메싱(meshing) 시 해당 픽셀을 제거하도록 합니다. 비활성화하면 원시 예측 기하 구조를 모든 위치에 유지합니다. 마스크는 여전히 별도로 반환됩니다. (기본값: True)                 | BOOLEAN     | 예  | True/False            |
| `refine_steps`     | (고급) MoGe-3 전용: 예측된 깊이에 대한 희소 볼류메트릭(sparse volumetric) 정제 패스를 수행합니다. 패스가 많을수록 대략 선형 비용으로 미세한 디테일과 경계를 선명하게 합니다. 0은 정제를 비활성화합니다. MoGe-1 / MoGe-2에서는 무시됩니다. (기본값: 3) | INT         | 예  | 0 \~ 8                |

참고: 입력 `image`에 `batch_size`보다 많은 프레임이 포함된 경우, 노드는 여러 추론 호출로 이를 처리하고 결과를 단일 출력 기하 구조로 결합합니다.

## 출력

| 출력 이름           | 설명                                                                                                                                                                         | 데이터 타입         |
| --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- |
| `moge_geometry` | 추정된 기하 구조를 포함하는 딕셔너리입니다. 원본 `image`를 포함하며, `points` (3D 포인트 클라우드), `depth` (깊이 맵), `intrinsics` (카메라 내부 파라미터 행렬), `mask` (유효한 픽셀을 식별하는 마스크), `normal` (표면 법선)을 포함할 수 있습니다. | MOGE\_GEOMETRY |

> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MoGeInference/ko.md)

***

**Source fingerprint (SHA-256):** `10f3399d9b6bc4ff8a940c940f538a8ec8f38a15e7d65f162499c5ab264fad65`