시작하기

PicoBerry API 레퍼런스

프로그래밍 방식으로 3D와 이미지를 생성하는 리소스 지향 REST API입니다 — 텍스트 → 이미지, 텍스트/이미지 → 3D는 물론, 여러분이 생성한 어떤 자산에도 리메시·텍스처·오토리깅을 적용할 수 있습니다.

기본 URLhttps://api.picoberry.ai

버전v1

인증Bearer / x-api-key

이 API는 JSON을 받고(파일 업로드는 multipart/form-data), JSON을 반환하며, 표준 HTTP 상태 코드를 사용하고, 모든 응답을 { success, data } 봉투로 감쌉니다. 생성은 비동기입니다: 생성 요청은 자산 id를 반환하며, 완료되면 폴링하거나 웹훅을 받습니다.

여기서 시작하세요

복사-붙여넣기 네 단계로 API 키부터 3D 모델 다운로드까지.

키를 발급하고 첫 인증 요청을 보내보세요.

비동기 & 폴링

모든 작업에서 생성 → 폴링 → 결과가 어떻게 동작하는지 설명합니다.

텍스트 → 3D

자산을 말로 설명하면 게임에 바로 쓸 수 있는 메시를 받습니다.

이미지 → 3D

한 장 또는 여러 뷰(멀티뷰)의 이미지를 텍스처가 입혀진 3D 모델로 변환합니다.

폴링 대신 서명된 콜백을 푸시로 받습니다.

크레딧 & 제한

비용, 요청 제한, 그리고 실패 시 환불.

하나의 API, 모든 엔진

요청마다 생성 엔진을 고르세요 — 3D는 tripo, meshy, hunyuan-3.1, trellis-2, 이미지는 nano-banana, gpt-image. 카탈로그와 모델별 정확한 비용은 GET /v1/models가 기준입니다.