后处理

纹理

POST/v1/assets/{id}/texture

根据文本提示词或参考图，为已有 3D 资产重新绘制 PBR 材质，并生成为新的资产。

异步返回一个 id，可轮询或使用 Webhook通常 ~60–120s费用因引擎而异

路径中的 {id} 是源模型。纹理处理会将新的贴图写入新资产，原资产保持不变。

参数

参数	说明
prompt可选 string	描述新表面的文本，最多 1,000 个字符。省略则根据模型自身重新生成纹理。
engine可选 string	使用的纹理引擎，例如 `tripo-texture`、`meshy-texture`、`hunyuan-texture`。省略则使用默认引擎。完整列表：`GET /v1/models?category=texture`。
image可选 file	用于替代提示词、或与提示词配合进行纹理生成的 multipart 参考图（≤20 MB）。参见下方图像引导。
license可选 string	结果的使用权限。默认为私有（保留所有权利）。
callbackUrl可选 string	将完成的资产推送到您的服务器，而非轮询。参见 Webhook。

请求

curl -X POST https://api.picoberry.ai/v1/assets/019…/texture \
  -H "Authorization: Bearer pb_live_xxx" -H "Content-Type: application/json" \
  -d '{"engine":"tripo-texture","prompt":"weathered bronze with green patina"}'

requests.post(f"{BASE}/v1/assets/{id}/texture", headers=headers,
    json={"engine": "tripo-texture", "prompt": "weathered bronze"})

await fetch(`${BASE}/v1/assets/${id}/texture`, { method: "POST",
  headers: { ...headers, "Content-Type": "application/json" },
  body: JSON.stringify({ engine: "tripo-texture", prompt: "weathered bronze" }) });

图像引导

省略 prompt，改用 multipart/form-data 发送 image 部分（≤20 MB），即可用参考图代替文本进行纹理生成，无需图片托管。

multipart

curl -X POST https://api.picoberry.ai/v1/assets/019…/texture \
  -H "Authorization: Bearer pb_live_xxx" \
  -F "engine=tripo-texture" -F "image=@./ref.png"

响应

响应 · 200

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

轮询 GET /v1/assets/{id} 直到 taskStatus 变为 2；完成后的 files.model 即为重新贴图后的网格，files.textures 中存放新的贴图。参见异步与轮询。

费用因引擎而异 每个纹理引擎的定价不同 — 准确费用见 GET /v1/models。