资产

列出资产

GET/v1/assets

按最新顺序列出资产库中的资产。

查询参数

参数说明
page可选默认 1
integer		从 1 开始的页码(≥1)。
limit可选默认 20
integer		每页数量，1–100。
category可选
string		按类型筛选：all、3d、image、remesh、texture、animation、palette。
keyword可选
string		对资产名称进行子串匹配，最多 255 个字符。

请求

请求
curl "https://api.picoberry.ai/v1/assets?category=3d&limit=20" \
  -H "Authorization: Bearer pb_live_xxx"
requests.get("https://api.picoberry.ai/v1/assets", headers=headers,
    params={"category": "3d", "limit": 20})
await fetch(`${BASE}/v1/assets?category=3d&limit=20`, { headers });

响应

响应 · 200
{ "success": true, "data": [
  { "id": "019…", "type": "model_3d", "taskStatus": 2, "files": { "thumbnail": "https://…png" } },
  { "id": "019…", "type": "image", "taskStatus": 2, "files": { "thumbnail": "https://…png" } }
] }

data 是资产数组，其中每一项的结构与 GET /v1/assets/{id} 相同。响应外层还会在 data 之外附带总数，便于翻页至末尾。

分页 逐页递增 page 直到读完总数，并用 category 和 keyword 从一开始就缩小范围。