资产

下载与导出

POST/v1/assets/{id}/download

将完成的资产导出为 GLB、FBX 或 OBJ，并获取一个有效期很短的签名下载 URL。

同步直接返回 URL格式 glb、fbx、obj

与生成不同，此调用是同步的：它会执行导出，并在同一响应中返回下载 URL，因此无需轮询。打包体积较大或高度精细的资产可能需要一些时间，请为客户端设置较为宽裕的超时时间。

参数

参数	说明
format必填 string	导出格式，取值为 `glb`、`fbx`、`obj` 之一。
texturePreset可选默认 standard string	`standard` 或 `unity`。`unity` 会为 Unity URP / Built-in 生成通道拆分贴图，并附加一个 `.meta` 附属文件。
name可选默认 model string	导出的基础文件名，最多 100 个字符。

请求

curl -X POST https://api.picoberry.ai/v1/assets/019…/download \
  -H "Authorization: Bearer pb_live_xxx" -H "Content-Type: application/json" \
  -d '{"format":"fbx","texturePreset":"unity"}'

requests.post(f"{BASE}/v1/assets/{id}/download", headers=headers,
    json={"format": "fbx", "texturePreset": "unity"})

await fetch(`${BASE}/v1/assets/${id}/download`, { method: "POST",
  headers: { ...headers, "Content-Type": "application/json" },
  body: JSON.stringify({ format: "fbx", texturePreset: "unity" }) });

响应

响应 · 200

{ "success": true, "data": {
  "url": "https://…signed",
  "format": "glb",
  "archive": false,
  "contentType": "model/gltf-binary",
  "filename": "model.glb"
} }

glb 是单个文件 · fbx / obj 是打包文件 glb 导出会作为单个文件返回（archive: false）。fbx 和 obj 会作为 .zip（archive: true）返回，其中打包了模型 + 贴图；当 texturePreset 为 unity 时还会附带 .meta。

URL 有效期很短 签名 url 会在签发后不久失效，请及时获取；若已失效，请重新请求导出。