> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-matt-router-pricing-pika-and-guard.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`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.