Skip to main content
meshy/remesh 的 API 参考,由 Comfy Router 提供,来源为 Meshy。

快速开始

你的 Comfy 工作区中创建一个密钥,并将其导出为 COMFY_API_KEY。Python 和 TypeScript 代码片段使用 Comfy SDK(pip install comfy-sdknpm install @comfyorg/sdk);cURL 代码片段则是通过原始 HTTP 发出的同一调用。 模型 ID: meshy/remesh 端点: POST https://api.comfy.org/v2/models/meshy/remesh

Schema

输入

boolean
默认值:"false"
如果为 true,则仅更改输入模型文件的格式,忽略拓扑、resize_height 和 target_polycount 等其他输入。
string
您想要重新网格化的、已完成的 Image to 3D 或 Text to 3D 使用例的 ID。如果未提供 model_url,则必填。
string
可公开访问的 3D模型 URL 或数据 URI。支持的格式:glb、gltf、obj、fbx、stl。如果未提供 input_task_id,则必填。
string
原点的位置。可选值:bottomcenter、“
number
默认值:"0"
将模型调整大小到以米为单位的特定高度。0 表示不调整大小。
`glb`, `fbx`, `obj`, `usdz`, `blend`, `stl`[]
默认值:"[\"glb\"]"
重新网格化后模型的目标格式列表。
integer
默认值:"30000"
指定已生成模型的目标多边形数量。有效范围为 100 到 300,000。范围:100300000
string
默认值:"\"triangle\""
指定已生成模型的拓扑结构。可选值:quadtriangle
本文档根据 Router 在 GET /v2/models/meshy/remesh/openapi.json 提供的 schema 生成,该文档与它在请求到达提供商之前用于校验调用的文档相同。

输出

integer
使用例创建时的时间戳,单位为毫秒。格式:int64
integer
使用例已完成时的时间戳,单位为毫秒。如果未完成则为 0。格式:int64
string
必填
使用例的唯一标识符。
object
可下载的重新网格化后 3D模型文件 URL。
string
可下载的 Blender 文件 URL。
string
可下载的 FBX 文件 URL。
string
可下载的 GLB 文件 URL。
string
可下载的 OBJ 文件 URL。
string
可下载的 STL 文件 URL。
string
可下载的 USDZ 文件 URL。
integer
前面排队的使用例数量。仅当状态为 PENDING 时有意义。
integer
使用例的进度。未开始时为 0,成功时为 100。范围:0100
integer
使用例开始时的时间戳,单位为毫秒。如果未开始则为 0。格式:int64
string
必填
可选值:SUCCEEDED
object
错误对象,在使用例失败时包含报错信息。
string
详细的报错信息。
string
Remesh 使用例的类型。可选值:remesh

示例

输入

输出

发布前须知

SDK 会生成 Idempotency-Key 并在自动重试中复用它。手动重试时,请复用原始 key。Router 最长可保持连接 10 分钟。 请求失败时,Router 会发送 X-Comfy-Error-Type 响应头说明原因。422 表示 Router 在调用提供商之前就拒绝了输入。生成的资源请及时下载,因为结果链接会过期

请求头

身份验证、幂等性、请求 ID、错误分类、重试节奏、消费限额。

使用 Router API

模型发现、校验错误、重试与计费。

限制

Router 目前不支持的功能,以及替代方案。