> ## 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 以估计深度和几何。此节点通过 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，以便网格化时将其剔除。禁用以在所有位置保留原始预测几何；掩码仍会单独返回。（默认：True）         | BOOLEAN     | 是  | True/False           |
| `refine_steps`     | （高级）仅 MoGe-3：对预测深度执行稀疏体积精修多遍处理。更多遍处理能以大致线性的成本锐化细节和边缘。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/zh.md)

***

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