시작하기

인증

모든 요청마다 두 헤더 중 하나에 API 키를 담아 보냅니다. 키는 대시보드에서 발급되며 한 번만 표시됩니다.

이 API는 유료 계정 — 활성 구독 또는 최소 한 번의 크레딧 팩 구매를 완료한 계정 — 에서 사용할 수 있습니다. 무료 계정도 대시보드를 둘러볼 수 있지만, 결제 내역이 등록되기 전까지 /v1 호출은 403을 반환합니다.

키 보내기

인증 헤더
-H "Authorization: Bearer pb_live_xxx"
# or
-H "x-api-key: pb_live_xxx"
headers = {"Authorization": f"Bearer {API_KEY}"}
const headers = { Authorization: `Bearer ${apiKey}` };

키 교체하기

  1. 새 키를 먼저 생성합니다 — 실행 중인 통합을 끊지 마세요.
  2. 새 키를 사용하도록 서비스를 업데이트합니다.
  3. 대시보드에서 기존 키를 폐기합니다.
키는 서버 측에 보관하세요 유출된 pb_live_ 키는 잔액 전체를 소진할 수 있습니다. 시크릿 매니저에 보관하고, 절대 브라우저로 전송하거나 커밋하지 마세요.

누가 API를 사용할 수 있나요

실제 결제 내역이 등록된 계정이라면 누구나 사용할 수 있습니다 — 활성 구독 또는 최소 한 번 완료된 크레딧 팩 구매면 됩니다. 완료된 구매는 영구적으로 자격을 부여하므로, 현재 구독이 유지되고 있지 않아도 됩니다. 결제 내역이 없는 계정에서 호출하면 error.code 6014과 함께 403을 반환합니다.

라이브러리 & 도구

SDK는 필요 없습니다 — /v1은 { success, data } 봉투를 사용하는 순수 REST입니다. 타입이 지정된 클라이언트나 에이전트 통합이 필요하다면:

OpenAPI 3
기계가 읽을 수 있는 스펙

/api-json에서 실시간으로 제공됩니다. Postman·Insomnia로 가져오거나 클라이언트를 생성하세요.

 MCP
@picoberry/mcp-server

Claude·Cursor 또는 모든 MCP 에이전트에서 API를 구동하세요 — npx -y @picoberry/mcp-server.

 REST
직접 호출

curl·Python·JavaScript — 퀵스타트는 복사-붙여넣기로 바로 쓸 수 있습니다.
라이브 스펙에서 타입이 지정된 클라이언트 생성
# Any OpenAPI 3 generator works — e.g. openapi-generator
npx @openapitools/openapi-generator-cli generate \
  -i https://api.picoberry.ai/api-json \
  -g typescript-fetch -o ./picoberry-client