后处理

重构网格

POST/v1/assets/{id}/remesh

将已通过 AI 生成的资产重拓扑为一个全新资产：保留外形轮廓，降低面数。

异步返回一个 id：轮询或使用 Webhook典型约 30–90 秒费用 10 积分起

路径中的 {id} 是源资产：可以是通过文本 → 3D、图像 → 3D 或更早的后处理步骤生成的任意模型。重构网格会将结果写入一个新资产，并保持原始资产不变。

参数

参数	说明
engine可选 string	使用哪个重拓扑引擎，例如 `pb-remesh`、`tripo-remesh`、`tripo-remesh-quad`（四边形输出）、`meshy-remesh`、`hunyuan-remesh`。省略则使用默认引擎。权威列表：`GET /v1/models?category=remesh`。
polycount可选 integer	目标面数，`100`–`2,000,000`。自托管的 `pb-remesh` 引擎支持 `500`–`500,000`。省略则由引擎自动选择。
license可选 string	结果的使用权限。默认为私有（保留所有权利）。
callbackUrl可选 string	把完成的资产推送到服务器，而不必轮询，参见 Webhooks。

源资产必须由 AI 生成 重构网格仅接受 PicoBerry 生成的模型。上传的网格无法重构网格，会返回 400 并带有 error.code 13005。

请求

curl -X POST https://api.picoberry.ai/v1/assets/019…/remesh \
  -H "Authorization: Bearer pb_live_xxx" -H "Content-Type: application/json" \
  -d '{"engine":"tripo-remesh-quad","polycount":8000}'

requests.post(f"{BASE}/v1/assets/{id}/remesh", headers=headers,
    json={"engine": "tripo-remesh-quad", "polycount": 8000})

await fetch(`${BASE}/v1/assets/${id}/remesh`, { method: "POST",
  headers: { ...headers, "Content-Type": "application/json" },
  body: JSON.stringify({ engine: "tripo-remesh-quad", polycount: 8000 }) });

响应

响应 · 200

{ "success": true, "data": { "id": "019…", "taskStatus": 0 } }

这是创建响应：一个新资产正在处理中。轮询 GET /v1/assets/{id} 直到 taskStatus 为 2，此时 files.model 中即为重拓扑后的网格。循环逻辑参见异步与轮询。

费用因引擎而异 PB Remesh 从 10 积分起；Tripo、Meshy 和 Hunyuan 引擎价格更高。每个引擎的准确费用见 GET /v1/models。