자산

자산 가져오기

GET/v1/assets/{id}

자산 하나의 상태와 결과를 조회합니다 — 모든 비동기 작업에서 폴링하는 엔드포인트입니다.

어떤 생성 요청(생성, 리메시, 텍스처, 애니메이트)이든 그 뒤에 이 엔드포인트를 호출해 작업이 대기에서 성공으로 넘어가는 과정을 지켜보세요. 또는 폴링을 아예 건너뛰고 웹훅으로 준비되는 즉시 같은 객체를 전달받을 수도 있습니다.

요청

요청
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 확인

응답

응답 · 성공
{ "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이 될 때까지 백오프를 두고 몇 초마다 폴링하세요. 전체 루프는 비동기 및 폴링에 있습니다.