AI 3D 생성 API — 여러 엔진을 하나의 API로
모델 전환, 작업 큐, 내보내기, 에셋 전달 스택을 직접 만들지 않고 제품 안에 AI 3D 생성을 붙이세요. PicoBerry는 text-to-3D, image-to-3D, 후속 처리, 다운로드 가능한 게임 에셋 출력을 하나의 비동기 API로 제공합니다.
# 이미지에서 3D 모델 생성
curl -X POST https://api.picoberry.ai/v1/models/from-image \
-H "Authorization: Bearer ***" \
-H "Content-Type: application/json" \
-d '{"imageUrl":"https://.../ref.png","engine":"tripo"}'
3D 생성 파이프라인을 직접 만들지 않고 출시하기
대부분의 팀에게 필요한 것은 단순한 모델 엔드포인트가 아닙니다. 업로드 처리, 엔진 선택, 비동기 작업 추적, 결과 저장, 내보내기 포맷, 사용량 관리, 그리고 제품의 다음 단계로 에셋을 넘기는 흐름이 필요합니다. PicoBerry는 이 파이프라인을 하나의 API 계약 뒤에 묶습니다.
# prompt/image → 3D
POST /v1/models/from-image
{ "imageUrl": "ref.png", "engine": "tripo" }텍스트·이미지에서 3D로
텍스트 프롬프트나 레퍼런스 이미지를 받아 3D 후보를 생성하고, 리메쉬·리텍스처·리깅·내보내기 같은 후속 작업으로 이어갈 수 있습니다.
# same request, switch engines
{ ..., "engine": "tripo" }
{ ..., "engine": "meshy" }
{ ..., "engine": "hunyuan3d" }여러 엔진, 하나의 계약
요청마다 적합한 엔진을 선택하세요. Tripo, Meshy, Hunyuan3D를 실험하더라도 인증, 작업 추적, 에셋 기록, 내보내기 흐름은 같은 방식으로 유지됩니다.
# submit → get a task id
{ "taskId": "job_a1b2", "status": "queued" }
# poll/webhook until succeeded비동기 작업 흐름
3D 생성은 즉시 끝나는 작업이 아니므로 API는 큐 기반 흐름에 맞춰 설계됩니다. 작업을 제출하고 ID를 저장한 뒤 poll 또는 webhook으로 완료를 확인합니다.
API 키에서 다운로드 가능한 에셋까지
통합은 작게 시작할 수 있습니다. API 키를 만들고, 생성 작업을 제출하고, 상태를 추적한 뒤 완성된 에셋을 자체 사용자 플로우, 워크스페이스, 인벤토리, 에디터, 파이프라인에 연결하세요.
API 키 만들기
PicoBerry 대시보드에서 키를 만들고 서버 사이드에서 안전하게 사용하세요. 환경, 툴, 팀별로 키를 분리하면 사용량을 더 명확히 볼 수 있습니다.
작업 제출
프롬프트, 이미지 URL, 엔진 선택, 출력 옵션을 /v1 엔드포인트로 보냅니다. UI를 막지 않고 task 또는 asset 식별자를 즉시 받을 수 있습니다.
Poll 또는 webhook 수신
task ID로 상태를 추적하거나 webhook을 등록해 백엔드가 사용자 알림, 워크스페이스 갱신, 다음 자동화 단계를 실행하게 하세요.
에셋 다운로드
완성된 모델을 가져와 웹 뷰어, 프로젝트, 게임 엔진 워크플로우, 후속 편집 단계에 연결합니다.
개발자 중심 기능
PicoBerry API는 일회성 데모가 아니라 반복 가능한 에셋 생성을 제품에 붙여야 하는 팀을 위한 API입니다. 내부 툴, 크리에이터 워크플로우, 게임 에셋 마켓플레이스, AI 에이전트, 자동화 콘텐츠 파이프라인에 연결할 수 있습니다.
OpenAPI 스펙과 타입 클라이언트
요청과 응답의 기준으로 OpenAPI 스펙을 사용하세요. 탐색 단계에서는 Postman에 불러오고, 실제 통합 단계에서는 백엔드 언어에 맞는 타입 클라이언트를 생성할 수 있습니다.
Webhook 전달
폴링에서 이벤트 기반 흐름으로 옮겨가세요. 생성이 완료되면 서비스가 프로젝트 상태를 갱신하고, 사용자를 알리고, 리뷰나 내보내기 처리를 이어갈 수 있습니다.
AI 에이전트를 위한 MCP 서버
PicoBerry MCP 서버를 통해 AI 코딩 툴과 에이전트 워크플로우에 생성을 연결할 수 있습니다. 에이전트가 앱, 게임, 툴 제작 흐름 안에서 에셋 후보를 요청할 수 있습니다.
사용량·크레딧 추적
대시보드에서 크레딧 사용량을 추적해 개발, 내부 툴, 고객-facing 기능, 실험 흐름을 구분하고 확장 전에 비용 구조를 볼 수 있습니다.
AMPLIFY 2026 PPT 워크플로우 반영
이 페이지는 PPT의 핵심 흐름을 반영합니다. 생성에서 멈추지 않고, 에셋을 수정·적용한 뒤 실제 게임 장면에서 플레이 테스트하는 루프까지 보여줍니다.
PPT 데모 영상: PicoBerry와 UModeler X 에셋을 Unity 안에 적용해 생성 → 통합 → 플레이 테스트로 이어지는 흐름입니다.
Case 1 · 2D 게임 워크플로우
AI 생성 3D 에셋과 UModeler X 수정 에셋을 Unity 2D 게임에 넣고 Render/Sort 3D as 2D, 2D Light, Sprite Mask, Shader로 통합합니다.
Case 2 · AI RPG + PicoBerry API
Claude Code나 ChatGPT Codex가 게임 구조를 빠르게 만들고, PicoBerry API가 캐릭터·몬스터·아이템·프롭의 비주얼 레이어를 자동 생성합니다.
Case 3 · 캐릭터 파이프라인
이미지 생성에서 3D 생성, 파츠 분리, 리깅, 애니메이션, 의상 교체, 최종 Unity 씬 결과까지 확장되는 흐름입니다.
실제 동작 흐름 보기
API의 가치는 후보 에셋 생성, 결과 비교, 에셋 기록 유지, 그리고 다음 워크플로우 단계로 파일을 전달하는 능력으로 판단해야 합니다.
제품에서 리뷰, 선택, 후속 처리, 내보내기로 넘길 수 있는 다양한 3D 후보 에셋입니다.
Quickstart 흐름: 인증하고, 첫 요청을 제출하고, 응답을 확인한 뒤 자체 백엔드 플로우에 연결합니다.
{ "success": true, "data": {
"id": "019f3a39-0db2-…",
"taskStatus": 0,
"type": "model_3d"
} }
# later
{ "modelUrls": { "glb": ".../model.glb" } }비동기 예시 흐름: 작업을 제출하고 반환된 식별자를 저장한 뒤, 완료를 확인하고 생성된 모델 URL을 가져옵니다.
자주 묻는 질문
PicoBerry API는 무엇인가요?
PicoBerry API는 AI 3D 생성을 위한 비동기 REST API입니다. 백엔드에서 생성 작업을 제출하고, 상태를 추적하고, 완료 이벤트를 받고, 생성된 모델 파일을 제품이나 파이프라인에 연결할 수 있습니다.
여러 생성 엔진을 하나의 API로 사용할 수 있나요?
네. PicoBerry는 여러 생성 엔진을 하나의 제품 측 계약으로 라우팅할 수 있도록 설계되었습니다. 인증, 작업 추적, 에셋 기록, 내보내기 흐름을 유지하면서 요청에 맞는 엔진을 선택할 수 있습니다.
게임에만 사용할 수 있나요?
아닙니다. 이 페이지는 PicoBerry의 핵심 워크플로우인 게임 툴과 3D 에셋 파이프라인에 초점을 둡니다. 같은 API 패턴은 크리에이터 툴, 마켓플레이스, 내부 자동화, AI 에이전트, 교육 툴 등에도 활용할 수 있습니다.
생성된 에셋을 바로 최종 작업에 쓸 수 있나요?
생성 결과는 후보 에셋으로 보는 것이 안전합니다. 프로토타이핑, 반복 제작, 리뷰, 후속 전달에 유용하지만 프로젝트에 따라 토폴로지, 머티리얼, 스케일, 리깅, 콜리전, 라이선스, 엔진별 요구사항을 검토해야 합니다.
Webhook을 지원하나요?
네. API 워크플로우는 비동기입니다. 생성 작업을 제출하고 반환된 식별자를 보관한 뒤, poll 또는 webhook으로 완료 시점을 받을 수 있습니다.
개발자는 어떻게 시작하나요?
PicoBerry 계정을 만들고 API 접근을 요청한 뒤 첫 서버 사이드 호출부터 통합하세요. API 키는 클라이언트 코드에 노출하지 말고, 환경이나 제품별로 키를 분리하는 것을 권장합니다.
3D 생성 레이어는 한 번 구축하고, 에셋이 필요한 모든 제품 흐름에서 사용하세요.
하나의 API 호출에서 시작해 앱, 툴, 에이전트, 게임 에셋 파이프라인으로 AI 3D 생성을 연결하세요.