자산

다운로드 & 내보내기

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은 발급 직후 곧 만료됩니다 — 즉시 가져오고, 만료되면 내보내기를 다시 요청하세요.