카탈로그

크레딧 잔액

GET/v1/credits

호출한 키의 사용 가능한 크레딧 잔액을 조회합니다 — 총액, 만료되지 않는 크레딧, 곧 만료되는 크레딧.

요청

curl https://api.picoberry.ai/v1/credits \
  -H "Authorization: Bearer pb_live_xxx"

requests.get("https://api.picoberry.ai/v1/credits", headers=headers).json()["data"]

const credits = (await (await fetch(`${BASE}/v1/credits`, { headers })).json()).data;

응답

응답 · 200

{ "success": true, "data": {
  "totalAmount": 4200,
  "unlimitedAmount": 4000,
  "limitedAmount": 200,
  "expiringSoonAmount": 200,
  "nextExpirationDate": "2026-09-01T00:00:00.000Z",
  "expiringWallets": [
    { "id": "019…", "amount": 200, "walletType": "subscription", "expiredAt": "2026-09-01T00:00:00.000Z" }
  ],
  "scopedAmounts": { "1": 149590 }
} }

필드

필드	설명
totalAmount integer	지금 당장 사용 가능한 총 크레딧.
unlimitedAmount integer	만료되지 않는 부분.
limitedAmount integer	만료일이 있는 부분.
expiringSoonAmount integer	가까운 시일 내에 만료되는 크레딧.
nextExpirationDate string · null	다음 만료의 ISO 8601 날짜, 만료 예정이 없으면 `null`.
expiringWallets array	기한이 있는 지급 건마다 한 항목씩 — 각각 `{ id, amount, walletType, expiredAt }`.
scopedAmounts object	용도가 한정된 지급분. 키는 scope id — `1`은 나노바나나 이미지 지급분입니다. `totalAmount`에 포함되지 않습니다: 해당 scope가 지정한 작업에만 쓸 수 있습니다.

일부 크레딧은 만료됩니다 구독 및 보너스 지급분은 기한이 있으며 expiredAt 날짜와 함께 expiringWallets에 나타납니다. 만료되지 않는 구매분은 unlimitedAmount에 있습니다.

나노바나나 지급분 유료 플랜에는 nano-banana, nano-banana-2, nano-banana-pro 에만 쓸 수 있는 월 이미지 지급분이 제공되며, 일반 크레딧보다 먼저 차감됩니다. scopedAmounts 로 보고되고 totalAmount 에는 일부러 넣지 않았습니다 — 즉 totalAmount 가 0 이어도 나노바나나 요청이 실패한다는 뜻이 아닙니다. scopedAmounts["1"] 도 함께 확인하세요.

비용 & 한도 이 엔드포인트는 잔액만 반환합니다. 각 작업의 비용과 요청 속도 제한은 크레딧 및 속도 제한을 참고하세요.