리메시
POST/v1/assets/{id}/remesh
이미 AI로 생성한 자산을 완전히 새로운 자산으로 리토폴로지합니다 — 실루엣은 유지하고 폴리곤 수는 줄입니다.
경로의 {id}는 원본입니다 — 텍스트 → 3D, 이미지 → 3D, 또는 이전 후처리 단계에서 생성한 어떤 모델이든 될 수 있습니다. 리메시는 결과를 새 자산에 기록하며 원본은 그대로 둡니다.
파라미터
| 파라미터 | 설명 |
|---|---|
| engine선택 string | 사용할 리토폴로지 엔진 — 예: pb-remesh, tripo-remesh, tripo-remesh-quad(쿼드 출력), meshy-remesh, hunyuan-remesh. 생략하면 기본값을 사용합니다. 정식 목록: GET /v1/models?category=remesh. |
| polycount선택 integer | 목표 폴리곤 수, 100–2,000,000. 자체 호스팅 pb-remesh 엔진은 500–500,000 범위를 지원합니다. 생략하면 엔진이 자동으로 선택합니다. |
| license선택 string | 결과물의 사용 권한. 기본값은 비공개(모든 권리 보유)입니다. |
| callbackUrl선택 string | 폴링 대신 완성된 자산을 여러분의 서버로 푸시합니다 — 웹훅을 참고하세요. |
원본은 AI로 생성한 자산이어야 합니다 리메시는 PicoBerry가 생성한 모델만 받습니다. 업로드한 메시는 리메시할 수 없으며,
error.code 13005와 함께 400을 반환합니다.요청
요청
curl -X POST https://api.picoberry.ai/v1/assets/019…/remesh \
-H "Authorization: Bearer pb_live_xxx" -H "Content-Type: application/json" \
-d '{"engine":"tripo-remesh-quad","polycount":8000}'requests.post(f"{BASE}/v1/assets/{id}/remesh", headers=headers,
json={"engine": "tripo-remesh-quad", "polycount": 8000})await fetch(`${BASE}/v1/assets/${id}/remesh`, { method: "POST",
headers: { ...headers, "Content-Type": "application/json" },
body: JSON.stringify({ engine: "tripo-remesh-quad", polycount: 8000 }) });응답
응답 · 200
{ "success": true, "data": { "id": "019…", "taskStatus": 0 } }이것은 생성 응답입니다 — 새 자산이 지금 처리 중입니다. taskStatus가 2가 될 때까지 GET /v1/assets/{id}를 폴링하면, files.model에 리토폴로지된 메시가 담깁니다. 반복 루프는 비동기 및 폴링을 참고하세요.
비용은 엔진마다 다릅니다 PB Remesh는 10크레딧부터 시작하며, Tripo·Meshy·Hunyuan 엔진은 더 높은 가격입니다. 엔진별 정확한 비용은
GET /v1/models에 있습니다.