PicoBerry API 레퍼런스
프로그래밍 방식으로 3D와 이미지를 생성하는 리소스 지향 REST API입니다 — 텍스트 → 이미지, 텍스트/이미지 → 3D는 물론, 여러분이 생성한 어떤 자산에도 리메시·텍스처·오토리깅을 적용할 수 있습니다.
이 API는 JSON을 받고(파일 업로드는 multipart/form-data), JSON을 반환하며, 표준 HTTP 상태 코드를 사용하고, 모든 응답을 { success, data } 봉투로 감쌉니다. 생성은 비동기입니다: 생성 요청은 자산 id를 반환하며, 완료되면 폴링하거나 웹훅을 받습니다.
여기서 시작하세요
복사-붙여넣기 네 단계로 API 키부터 3D 모델 다운로드까지.
시작하기키를 발급하고 첫 인증 요청을 보내보세요.
시작하기모든 작업에서 생성 → 폴링 → 결과가 어떻게 동작하는지 설명합니다.
생성자산을 말로 설명하면 텍스처가 입혀진 메시를 받습니다.
생성한 장 또는 여러 뷰(멀티뷰)의 이미지를 텍스처가 입혀진 3D 모델로 변환합니다.
전달폴링 대신 서명된 콜백을 푸시로 받습니다.
시작하기비용, 요청 제한, 그리고 실패 시 환불.
엔드포인트 개요
모든 엔드포인트는 https://api.picoberry.ai/v1 아래에 있습니다. 생성은 비동기입니다 — 생성 요청은 폴링하거나 웹훅으로 받을 id를 반환하며, 후처리 요청은 그 동일한 id를 사용합니다.
| 엔드포인트 | 용도 |
|---|---|
POST /v1/images | 텍스트 → 이미지 |
POST /v1/models/from-text | 텍스트 → 3D |
POST /v1/models/from-image | 이미지 한 장 또는 2–4개 뷰 → 3D |
POST /v1/images/parts-board | 이미지를 부품으로 분해 |
POST /v1/assets/{id}/remesh | 모델 리토폴로지 |
POST /v1/assets/{id}/texture | 모델 재텍스처 |
POST /v1/assets/{id}/animate | 오토리깅 & 애니메이션 |
POST /v1/assets/{id}/download | GLB / FBX / OBJ 내보내기 (동기) |
GET /v1/assets/{id} | 상태 폴링 & 결과 가져오기 |
GET /v1/assets | 자산 목록 조회 |
GET /v1/models | 엔진 카탈로그 & 모델별 비용 |
GET /v1/credits | 지갑 잔액 & 플랜 |
POST /v1/collections | 자산을 컬렉션으로 정리 |
라이브러리
Claude Code·Cursor·Claude Desktop·Cline 에서 이 API 를 그대로 사용. npx -y @picoberry/mcp-server
MCP 서버 소스, 예제 워크플로, 복붙용 클라이언트 설정.
RESTSDK 없이 curl·Python·JavaScript 로 /v1 호출.
하나의 API, 모든 엔진
요청마다 생성 엔진을 고르세요 — 3D는 tripo, meshy, hunyuan-3.1, trellis-2, 이미지는 nano-banana, gpt-image. 카탈로그와 모델별 정확한 비용은 GET /v1/models가 기준입니다.