PicoBerry API를 쓰면 워크스페이스에서 하던 작업 — 텍스트로 이미지, 텍스트·이미지로 3D, 파츠 분해, 리메시, 텍스처, UV 펼치기, 리깅·애니메이션, 다운로드 — 을 코드에서 직접 호출해 자동화할 수 있습니다. AI 어시스턴트(Claude·Cursor 등)에서 쓰고 싶다면 MCP를 참고하세요.

누가 쓸 수 있나요

API는 한 번이라도 결제한 계정(요금제 구독 또는 크레딧 팩 구매), 지금 유료 구독 중인 계정, 또는 MAX 팀원이 쓸 수 있습니다. 조건에 맞지 않는 계정에서 키를 만들려고 하면 유료 요금제 안내가 뜹니다.

API로 생성해도 웹과 똑같이 크레딧이 차감되고, API로 받는 다운로드도 월 다운로드 횟수에 포함됩니다.

API 키 만들기

대시보드의 API Keys 탭을 엽니다 (picoberry.ai/dashboard/api-keys). 이 화면은 영어로 표시됩니다.
키 이름을 적고(선택, 예: "게임 파이프라인") Create key를 누릅니다.
새 키(pb_live_…)가 한 번만 표시됩니다. 바로 복사해 안전한 곳에 보관한 뒤 I've saved it — dismiss를 누르세요. 창을 닫으면 다시 볼 수 없습니다.

요청을 보낼 때는 키를 Authorization: Bearer <키> 헤더에 담습니다. 계정당 활성 키는 20개까지 만들 수 있으며, 목록에서 키마다 이름, 앞부분, 만든 날짜와 마지막 사용 시각을 볼 수 있습니다.

키 일시 중지와 재개

키 하나가 하루(한국 시간 기준)에 20,000 크레딧을 넘게 쓰면, 예기치 않은 과금을 막기 위해 그 키가 자동으로 일시 중지되고 이메일로 알려 드립니다.

중지된 키에는 Paused 표시가 붙고, 그동안은 결과 조회와 다운로드만 됩니다. 새 생성 요청은 거절됩니다.
사용량이 본인이 의도한 것이라면 Resume을 눌러 같은 키로 바로 이어서 쓸 수 있습니다. 재개하면 그날 한 번 더 같은 한도만큼 쓸 수 있고, 다시 넘으면 또 중지됩니다.
모르는 사용량이라면 재개하지 말고 키를 폐기한 뒤 새 키를 만드세요.

개발자 문서

엔드포인트별 요청·응답, 인증, 비동기 작업 처리, 오류 코드, curl·Python·JavaScript 예제는 개발자 문서 api.picoberry.ai/docs에 정리돼 있습니다. 시작하기(Quickstart)부터 이미지·3D 생성, 파츠 분해, 리메시, 텍스처, 애니메이션, 다운로드, 에셋·컬렉션·크레딧 조회까지 다룹니다.