后处理

自动绑定与动画

POST/v1/assets/{id}/animate

为人形或动物自动绑定骨骼，并可按需将预设片段重定向到模型上。无需手动绘制权重。

异步 返回一个 id，可通过轮询或 Webhook 获取通常 ~2–4 min费用 因引擎而异

路径中的 {id} 是源模型。结果（经过绑定的网格，若使用 -rig-animate 则还带有动画）会写入一个新资产。

参数

参数说明
engine可选
string		使用哪个绑定引擎，例如 tripo-rig-animate、tripo-rig、meshy-rig-animate、meshy-rig。-rig-animate 引擎在绑定的同时应用预设片段；-rig 引擎仅进行绑定。省略则使用默认值。列表：GET /v1/models?category=animate。
preset可选
string		-rig-animate 引擎使用的动画预设 id（例如 walk），最多 64 个字符。可通过 GET /v1/animations 浏览目录。省略则仅进行绑定。
license可选
string		结果的使用权限。默认为私有（保留所有权利）。
callbackUrl可选
string		将完成的资产推送到您的服务器，而非轮询获取。参见 Webhook。
源模型必须可绑定 自动绑定需要清晰的人形或动物形态。道具、场景和抽象形状会返回 400 及 error.code 13008 而失败。

请求

请求
curl -X POST https://api.picoberry.ai/v1/assets/019…/animate \
  -H "Authorization: Bearer pb_live_xxx" -H "Content-Type: application/json" \
  -d '{"engine":"tripo-rig-animate","preset":"walk"}'
requests.post(f"{BASE}/v1/assets/{id}/animate", headers=headers,
    json={"engine": "tripo-rig-animate", "preset": "walk"})
await fetch(`${BASE}/v1/assets/${id}/animate`, { method: "POST",
  headers: { ...headers, "Content-Type": "application/json" },
  body: JSON.stringify({ engine: "tripo-rig-animate", preset: "walk" }) });

动画预设

GET/v1/animations?engine=tripo|meshy

列出某个引擎可用的预设片段。预设是引擎专属的：Tripo 的预设无法在 Meshy 引擎上运行，因此请始终从用于生成动画的同一引擎中选择。

请求
curl "https://api.picoberry.ai/v1/animations?engine=tripo" \
  -H "Authorization: Bearer pb_live_xxx"
requests.get("https://api.picoberry.ai/v1/animations", headers=headers,
    params={"engine": "tripo"})
await fetch(`${BASE}/v1/animations?engine=tripo`, { headers });
响应 · 200
{ "success": true, "data": [
  { "id": "walk", "name": "Walk", "category": "Movement" },
  { "id": "run", "name": "Run", "category": "Movement" },
  { "id": "slash", "name": "Slash", "category": "Combat" }
] }

每个预设都带有 id（在 /animate 中作为 preset 传入）、用于显示的 name 以及 category。类别为 Movement、Combat、Emotion、Dance、Sports、Daily 或 Gesture 之一。

响应

响应 · 200
{ "success": true, "data": { "id": "019…", "taskStatus": 0 } }

轮询 GET /v1/assets/{id}，直到 taskStatus 变为 2；完成后的 files.model 中包含绑定和已烘焙的片段。参见 异步与轮询。

预设是引擎专属的 Tripo 的预设无法在 Meshy 引擎上运行。请从用于生成动画的同一引擎中选择预设。