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

# MoGeInference - ComfyUI Built-in Node Documentation

> 在单张图像上运行 MoGe，以估算深度和几何结构。

在单张图像上运行 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.0）           | FLOAT       | 是  | 0.0 到 170.0 |
| `batch_size`       | 每次推理调用处理的图像数量。在长视频或大量图像上遇到内存不足时，请降低此值。（默认值：4）                                            | INT         | 是  | 1 到 64      |
| `force_projection` | （高级）强制对预测点进行投影。（默认值：True）                                                                | BOOLEAN     | 是  | True/False  |
| `apply_mask`       | （高级）将掩码覆盖（天空或无效）像素在点云和深度输出中设置为无穷大，以便网格化工具可以忽略这些像素。禁用以在所有位置保留原始预测几何结构；掩码仍会单独返回。（默认值：True） | BOOLEAN     | 是  | True/False  |

注意：当输入 `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/zh.md)

***

**Source fingerprint (SHA-256):** `59f6b8b1ab65147a47f5dc7ebee7b965a5ab37c6a0843a2c80d50c767ad98db4`