자산

자산 목록

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로 처음부터 대상을 좁히세요.