/ API
API 문서 API 키 발급 →
PicoBerry 생성 API · v1

3D·이미지 생성, 그리고 그 이후 모든 과정까지 — API 하나로.

최고의 엔진으로 생성하고, 같은 자산 위에서 리메시·리텍스처·리깅·내보내기까지 — 하나의 비동기 REST API로 처리합니다. 앱, 자산 파이프라인, AI 에이전트를 위해 설계했습니다.

API 키 발급 → 문서 보기

얼리 액세스 — 개발자를 배치 단위로 온보딩하며, 승인되면 키를 담아 회신드립니다.

베이스 api.picoberry.ai 인증 Bearer pb_live_… 출력 GLB · FBX · PNG
이미지 → 3D · curl
# Generate a 3D model from an image
curl -X POST https://api.picoberry.ai/v1/models/from-image \
  -H "Authorization: Bearer pb_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"imageUrl":"https://…/ref.png","engine":"tripo"}'

# → returns an asset id; poll until it's ready
{ "success": true, "data": {
    "id": "019f3a39-0db2-…",
    "taskStatus": 0,
    "type": "model_3d"
} }
여러 선도 엔진으로 작업을 라우팅합니다
Tripo Meshy Hunyuan 3D gpt-image nano-banana grok-imagine
왜 PicoBerry

단순한 3D 모델 엔드포인트, 그 이상.

다섯 개의 생성 API를 따로 연동할 필요 없습니다. 생성·정제·전달을 하나의 통합으로 — 각 엔진을 직접 호출하는 대신 PicoBerry를 거쳐야 하는 이유입니다.

하나의 통합

Tripo, Meshy, Hunyuan3D, 그리고 이미지 모델까지 하나의 키·스키마·{ success, data } 응답 형식으로 사용합니다. 필드 하나로 엔진을 바꿉니다.

완전한 자산 파이프라인

생성한 뒤, 같은 자산을 id로 리메시·리텍스처·리깅합니다 — 재업로드도, 도구마다 포맷을 맞추는 번거로움도 없습니다.

프로덕션을 위한 설계

비동기 작업, 서명된 웹훅, 서명된 다운로드 URL, 폐기 가능한 키, 요청 제한, 크레딧 추적 — 직접 만들고 유지보수해야 했을 기반 작업을 대신 제공합니다.

예시

API가 만들어내는 결과를 확인하세요.

프롬프트 하나로 텍스처가 입혀진 메시가 나옵니다 — 캐릭터, 크리처, 환경, 소품, 무기, 탈것까지. 모든 타일은 단 한 번의 API 호출로 만든 실제 자산입니다.

Wild West Gunsmith Store 텍스트 → 3Drealistic 3d model of gunsmith store wild west Yellow Scuba Tank Starfish 텍스트 → 3DYellow Scuba Tank Starfish Wolf Monk With Staff (Remeshed) 텍스트 → 3DWolf Monk With Staff (Remeshed) Anime Girl In Sci-Fi Suit 텍스트 → 3DAnime Girl In Sci-Fi Suit Banana Palm Tree 텍스트 → 3DBanana Palm Tree Cartoon Lion Safari Guide (Animated: Standing Relax) 텍스트 → 3DCartoon Lion Safari Guide (Animated: Standing Relax) Ashurath Desert Wanderer Character 텍스트 → 3DAAA game-ready playable male character for ORITHAL, a 3D isometric Ancient Fanta Stylized Green Bushy Tree 텍스트 → 3DStylized Green Bushy Tree model 텍스트 → 3Dvalheim style viking boat Brazilian Soccer Player Bobblehead 텍스트 → 3DBrazilian Soccer Player Bobblehead Armored Magma Golem Monster 텍스트 → 3DA massive, game-ready 3D monster model of an armored magma golem, with volcanic Gothic Stone Pedestal with Gems 텍스트 → 3DGothic Stone Pedestal with Gems Stylized Purple Flower 텍스트 → 3DStylized Purple Flower Pirate Village Building 텍스트 → 3Dcreate a pirate village building Sci-Fi Round Device 텍스트 → 3DSci-Fi Round Device Whimsical Medieval Anime House 텍스트 → 3DA charming, whimsical two-story medieval-style house with exaggerated, inviting Anime Stylized Palm Tree 텍스트 → 3DA tall, slender anime-style palm tree stands gracefully, its trunk a smooth, war Anime Girl With Horns 텍스트 → 3DAnime Girl With Horns Anime Boy Adventurer Character 텍스트 → 3DAnime Boy Adventurer Character Low Poly Automatic Gun 텍스트 → 3DA low poly automatic gun for the use in my low poly fps game Stylized Low Poly Pistol 텍스트 → 3Dlow poly semi automatic pistol, hard surface, clean edges, stylized FPS game wea Cute Mermaid Hair Styles 텍스트 → 3DCute Mermaid Hair Styles Cartoon Taco Filled With Beans 텍스트 → 3DCartoon Taco Filled With Beans Chibi Elf Girl T-Pose 텍스트 → 3DChibi Elf Girl T-Pose Chibi Anime Girl Knight (Remeshed) 텍스트 → 3DChibi Anime Girl Knight (Remeshed) Chibi Nun Character 텍스트 → 3DChibi Nun Character Chibi Cyberpunk Girl Character 텍스트 → 3DChibi Cyberpunk Girl Character Underwater Mermaid Treasure Hunt 텍스트 → 3DUnderwater Mermaid Treasure Hunt Spacecraft Air Carrier 텍스트 → 3Dspacecraft air carrier Frost King Character Model 텍스트 → 3DStylized 3D mobile game Frost King character, under 7000 triangles, clean topolo
POST/v1/models/from-text모든 타일 뒤의 호출
curl -X POST https://api.picoberry.ai/v1/models/from-text   -H "Authorization: Bearer pb_live_…"   -d '{"prompt":"armored magma golem, glowing cracks, low-poly","engine":"hunyuan-3.1"}'
퀵스타트

네 단계 만에 자산 다운로드까지.

1

키 발급

액세스를 요청하고, 대시보드에서 키를 발급받아 Authorization: Bearer로 전송합니다.

2

작업 제출

POST /v1/models/from-image — 또는 from-text, images. 자산 id를 반환합니다.

3

폴링 또는 웹훅

GET /v1/assets/{id}를 taskStatus: 2가 될 때까지 확인하거나, 서명된 콜백을 받습니다.

4

다운로드

서명된 GLB/FBX URL을 받습니다 — 또는 먼저 리메시·텍스처·리깅으로 다듬을 수도 있습니다.

전체 과정은 문서에서 확인하세요 — 인증, 비동기 & 폴링, 웹훅.

기능

자산 파이프라인의 모든 단계를 엔드포인트로.

생성한 뒤 같은 자산에서 그대로 정제합니다 — API를 벗어나지 않고 리메시·리텍스처·리깅까지.

POST/v1/images

텍스트 → 이미지

레퍼런스 가이드(최대 4장)와 함께 프롬프트로 이미지를 생성합니다. 그 결과를 그대로 이미지 → 3D에 넣으세요.

POST/v1/models/from-text

텍스트 → 3D

자산을 평범한 텍스트로 설명하세요. 엔진과 폴리곤 예산을 고르면 기본으로 PBR 텍스처가 적용됩니다.

POST/v1/models/from-image

이미지 → 3D

직접 생성한 이미지를 포함해 어떤 이미지든 텍스처가 입혀진 메시로 변환합니다.

POST/v1/assets/{id}/remesh

리메시

목표 삼각형 또는 쿼드 수에 맞춰 리토폴로지합니다. 외형은 유지하고 폴리곤 수만 낮춥니다.

POST/v1/assets/{id}/texture

리텍스처

프롬프트나 레퍼런스 이미지로 PBR 머티리얼을 제자리에서 다시 칠합니다.

POST/v1/assets/{id}/animate

오토리깅 & 애니메이션

휴머노이드를 자동으로 리깅하고 걷기·달리기·대기 클립을 리타깃합니다 — 수동 웨이트 작업이 필요 없습니다.

POST/v1/assets/{id}/download

내보내기

GLB, FBX, OBJ로 — 채널 분리 맵과 .meta까지 함께 제공하는 Unity 텍스처 프리셋을 지원합니다.

GET/v1/assets

자산 & 컬렉션

생성한 모든 것을 목록화하고, 불러오고, 정리합니다. 서명된 URL로 바로 다운로드할 수 있습니다.

엔진 지원

요청마다 알맞은 엔진을 고르세요.

작업마다 engine 필드 하나만 지정하면 됩니다. 엔진마다 강점이 다르니, 기본값으로 시작해 특정 룩이나 예산이 필요할 때 바꾸세요.

엔진종류적합한 용도입력출력일반 소요
Tripo3D빠르고 안정적인 텍스트·이미지 → 3Dtext · imageGLB · FBX~60–90s
Meshy3D스타일라이즈드 3D 자산text · imageGLB · FBX~2 min
Hunyuan3D3D고디테일, 선명한 지오메트리text · imageGLB · FBX~2–3 min
gpt-image이미지정밀한 프롬프트·레퍼런스 편집text · imagePNG~20–40s
nano-banana이미지빠른 이미지 생성·편집text · imagePNG~10–20s
grok-imagine이미지xAI Imagine — 스타일라이즈드 생성·편집text · imagePNG~15–30s

일반 소요 시간은 표준 작업 기준이며, 복잡한 자산은 더 오래 걸립니다. 공식 카탈로그와 모델별 크레딧 비용은 GET /v1/models에서 항상 실시간으로 확인할 수 있습니다.

6+
엔진
하나의 API 뒤에 3D·이미지 모델.
~90s
일반 3D 작업
표준 텍스트/이미지 → 3D 기준; 복잡한 자산은 더 오래 걸립니다.
240
요청 / 분
IP별 기본 한도; 사용자당 생성 120건/분. 요청 시 상향 가능합니다.
GLB
+ FBX / OBJ
PBR 텍스처와 Unity 대응 프리셋을, 서명된 URL로 제공합니다.
활용 분야

프롬프트에서 출시 가능한 자산까지.

게임 개발

몇 분 만에 씬을 채웁니다

프롬프트 하나로 소품 변형을 한꺼번에 생성하고, 각각을 약 5k 삼각형 예산으로 리메시한 뒤, Unity 대응 GLB로 내보냅니다 — 하나의 파이프라인, 하나의 자산 id로.

XR & 공간 컴퓨팅

필요할 때마다 자산을

AR 착용 체험과 월드 빌딩을 위한 가볍고 텍스처가 입혀진 로우폴리 메시를 만들고, 앱이 런타임에 가져오는 서명된 URL로 전달합니다.

이커머스

제품을 3D로

제품 사진 한 장을 웹 뷰어용 인터랙티브 3D 프리뷰로 바꿉니다 — 이미지 → 3D, 웹 예산에 맞춘 리메시, 그리고 GLB 내보내기.

에이전트 & 도구

LLM을 위한 3D 도구

PicoBerry를 MCP 도구로 노출하면, 에이전트가 스스로 자산을 생성·정제·다운로드할 수 있습니다 — 텍스트나 이미지를 넣으면 GLB가 나옵니다.

자주 묻는 질문

연동하기 전에.

액세스는 어떻게 받고 인증하나요?+
이 API는 현재 얼리 액세스 단계입니다. 액세스를 요청하시면 계정에 키 발급을 활성화해 드립니다. 그다음 대시보드에서 키를 발급받아 — 키는 한 번만 표시됩니다 — Authorization: Bearer pb_live_…(또는 x-api-key)로 전송하세요.
생성은 동기 방식인가요?+
아니요 — 비동기 방식입니다. 생성 호출은 taskStatus: 0인 자산 id를 반환합니다. GET /v1/assets/{id}를 taskStatus가 2(성공)가 될 때까지 폴링하거나, 웹훅을 등록해 결과를 푸시로 받으세요.
요금은 어떻게 부과되나요?+
생성은 통합 지갑의 크레딧을 사용합니다 — 3D 모델 약 60–80 크레딧, 이미지 약 15–50 크레딧입니다. 크레딧은 작업 시작 시 차감되며 실패하면 자동으로 환불됩니다. 실시간 잔액은 GET /v1/credits에서 확인할 수 있습니다.
요청 제한은 어떻게 되나요?+
IP당 분당 240 요청, 사용자당 분당 120 생성 요청입니다. 한도를 초과하면 error.code: 10003과 함께 429를 반환합니다 — 잠시 대기 후 재시도하세요.
어떤 포맷으로 내보낼 수 있나요?+
GLB(단일 파일), 또는 텍스처와 함께 .zip으로 묶인 FBX / OBJ. Unity 프리셋은 채널을 분리하고 .meta를 함께 제공합니다.
웹훅을 받을 수 있나요?+
네. 어떤 작업에든 callbackUrl과 webhookSecret을 전달하면, 완료 시 PicoBerry가 서명된 asset.succeeded / asset.failed 이벤트를 POST합니다. X-PB-Signature HMAC을 검증하고 X-PB-Delivery-Id로 중복을 제거하세요.
엔진을 직접 고를 수 있나요?+
네 — 작업마다 engine 필드를 지정하면 됩니다(3D는 tripo, meshy, hunyuan-3.1; 이미지는 nano-banana, gpt-image, grok-imagine). 비워 두면 해당 작업 유형의 기본값을 사용합니다. 실시간 카탈로그와 모델별 비용은 GET /v1/models에서 확인할 수 있습니다.
작업이 실패하면 어떻게 되나요?+
크레딧은 작업 시작 시 차감되고 실패하면 자동으로 환불됩니다 — 성공한 생성에 대해서만 요금이 부과됩니다. 실패에는 유형이 지정된 error.code가 포함됩니다. 에러 처리를 참고하세요.
프로덕션에서 사용할 수 있나요?+
네 — 이 API는 프로덕션을 위해 만들어졌습니다: 비동기 작업, 서명된 웹훅, 서명된 다운로드 URL, 요청 제한까지. 더 높은 한도나 대량 가격이 필요하신가요? 문의하세요.
연동을 어떻게 테스트하나요?+
저비용 모델로 실제 API에 대해 검증하세요 — 실패한 작업에는 요금이 부과되지 않으며, GET /v1/credits로 언제든 잔액을 확인할 수 있습니다.
SDK나 OpenAPI 스펙을 제공하나요?+
전체 REST 레퍼런스는 문서에 있으며, OpenAPI 3 스펙은 GET /api-json에서 제공됩니다 — Postman으로 가져오거나 타입이 지정된 클라이언트를 생성하세요. 언어별 SDK는 아직 배포되지 않았지만, 그동안 스펙으로 대부분의 언어에서 클라이언트를 생성할 수 있습니다.
자산의 소유권은 누구에게 있나요? 상업적으로 사용할 수 있나요?+
생성한 자산의 소유권과 상업적 사용 조건은 서비스 약관에 명시되어 있습니다. 특정한 활용 사례가 있으신가요? 문의하세요.
업로드한 파일을 저장하나요? 자산은 얼마나 보관되나요?+
업로드한 파일과 생성된 자산이 어떻게 저장·보관되는지는 개인정보 처리방침에 안내되어 있습니다. 소유한 자산은 대시보드에서 관리할 수 있습니다.

API 키를 발급받으세요.

PicoBerry 대시보드에 로그인해 키를 발급받으세요 — 키는 한 번만 표시됩니다.

API 키 발급 → 문서 보기

먼저 살펴보고 싶으신가요? 문서와 모델 카탈로그를 둘러보세요.