资产

获取资产

GET/v1/assets/{id}

获取单个资产的状态和结果 —— 每个异步任务都通过该端点进行轮询。

在任意创建请求(生成、重构网格、纹理、动画)之后调用该端点，即可观察任务从排队推进到成功。也可以完全跳过轮询，让 Webhook 在结果就绪的那一刻投递同一个对象。

请求

request
curl https://api.picoberry.ai/v1/assets/019… \
  -H "Authorization: Bearer pb_live_xxx"
requests.get(f"{BASE}/v1/assets/{id}", headers=headers).json()["data"]
const asset = (await (await fetch(`${BASE}/v1/assets/${id}`, { headers })).json()).data;

任务状态

taskStatus 是用于分支判断的整数，progress(0–100)则跟踪运行中任务的进度。

0 · 排队中 已接受，等待开始1 · 处理中 生成正在进行2 · 成功 files 已就绪3 · 失败 积分已退还 —— 请查看 errorCategory

响应

response · succeeded
{ "success": true, "data": {
  "id": "019…",
  "name": "treasure chest",
  "type": "model_3d",
  "taskStatus": 2,
  "progress": 100,
  "createdAt": "2026-08-05T09:12:00.000Z",
  "files": {
    "model": "https://…signed.glb",
    "thumbnail": "https://…signed.png",
    "hasTextures": true
  },
  "nsfw": false,
  "license": "private"
} }

资产对象

字段说明
id
string		资产 id。
name · description
string		标签，以及创建时所用的提示词或备注。
type
string		资产类型 —— 例如 model_3d、image。
taskStatus
integer		0 / 1 / 2 / 3 —— 参见上文的任务状态。
progress
integer		任务运行时为 0–100。
createdAt
string		ISO 8601 创建时间戳。
files
object		成功时填充的带签名结果 URL —— model、preview、image、thumbnail、textures[]，以及一个 hasTextures 标志。
errorCategory · errorDetail
string		仅在任务失败(taskStatus: 3)时存在 —— 失败类别和经过脱敏的详细信息。
nsfw
boolean		资产是否被内容过滤器标记。
license
string		资产的使用权限。
带签名 URL 会过期 files.* 的 URL 有效期很短 —— 请及时下载或复制，不要长期保存。
轮询循环 采用退避策略每隔几秒轮询一次，直到 taskStatus 变为 2 或 3。完整循环见异步与轮询。