시작하기

비동기 & 폴링

생성 호출은 자산과 작업 상태를 담아 즉시 응답합니다. 완료될 때까지 폴링하거나 웹훅을 등록하세요.

0 대기1 처리 중2 성공3 실패

성공하면 files 에 결과물(model, image, thumbnail, textures)에 대한 수명이 짧은 서명된 URL이 담깁니다.

완료될 때까지 폴링

폴링

curl https://api.picoberry.ai/v1/assets/019f3a39-… \
  -H "Authorization: Bearer pb_live_xxx"

import time, requests
while True:
    a = requests.get(f"https://api.picoberry.ai/v1/assets/{id}", headers=headers).json()["data"]
    if a["taskStatus"] in (2, 3): break
    time.sleep(4)
model_url = a["files"]["model"]

let a;
do {
  a = (await (await fetch(`${BASE}/v1/assets/${id}`, { headers })).json()).data;
  if (a.taskStatus < 2) await new Promise(r => setTimeout(r, 4000));
} while (a.taskStatus < 2);
const modelUrl = a.files.model;

넉넉한 타임아웃을 설정하세요 3D 작업은 보통 ~60–120초 걸립니다. 몇 초 간격으로 폴링하고, 작업이 멈췄다고 판단하기 전에 1분을 충분히 넘겨 계속 폴링하세요.