meshy/remesh 的 API 参考,由 Comfy Router 提供,来源为 Meshy。
快速开始
在你的 Comfy 工作区中创建一个密钥,并将其导出为COMFY_API_KEY。Python 和 TypeScript 代码片段使用 Comfy SDK(pip install comfy-sdk、npm install @comfyorg/sdk);cURL 代码片段则是通过原始 HTTP 发出的同一调用。
模型 ID: meshy/remesh
端点: POST https://api.comfy.org/v2/models/meshy/remesh
- Wait for the result
- Queue and collect later
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
原点的位置。可选值:
bottom、center、“number
默认值:"0"
将模型调整大小到以米为单位的特定高度。0 表示不调整大小。
`glb`, `fbx`, `obj`, `usdz`, `blend`, `stl`[]
默认值:"[\"glb\"]"
重新网格化后模型的目标格式列表。
integer
默认值:"30000"
指定已生成模型的目标多边形数量。有效范围为 100 到 300,000。范围:
100 到 300000string
默认值:"\"triangle\""
指定已生成模型的拓扑结构。可选值:
quad、triangleGET /v2/models/meshy/remesh/openapi.json 提供的 schema 生成,该文档与它在请求到达提供商之前用于校验调用的文档相同。
输出
integer
使用例创建时的时间戳,单位为毫秒。格式:
int64integer
使用例已完成时的时间戳,单位为毫秒。如果未完成则为 0。格式:
int64string
必填
使用例的唯一标识符。
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。范围:
0 到 100integer
使用例开始时的时间戳,单位为毫秒。如果未开始则为 0。格式:
int64string
必填
可选值:
SUCCEEDEDobject
错误对象,在使用例失败时包含报错信息。
string
详细的报错信息。
string
Remesh 使用例的类型。可选值:
remesh示例
输入
输出
发布前须知
SDK 会生成Idempotency-Key 并在自动重试中复用它。手动重试时,请复用原始 key。Router 最长可保持连接 10 分钟。
请求失败时,Router 会发送 X-Comfy-Error-Type 响应头说明原因。422 表示 Router 在调用提供商之前就拒绝了输入。生成的资源请及时下载,因为结果链接会过期。
请求头
身份验证、幂等性、请求 ID、错误分类、重试节奏、消费限额。
使用 Router API
模型发现、校验错误、重试与计费。
限制
Router 目前不支持的功能,以及替代方案。