그 밖에 / 요금제와 잔여 건수

요금제와 잔여 건수

GET/billing/usage

GET/billing/plans

usage 는 현재 요금제와 남은 건수, 지금까지 쓴 건수, 다음에 채워지는 시각을 돌려줍니다. 여러 건을 보내기 전에 확인하세요. plans 는 요금제별 가격과 월 지급 건수를 돌려줍니다(인증 없이 부를 수 있습니다).

필드	뜻
`plan`	`free` · `basic` · `pro` · `enterprise`
`credits`	지금 남은 건수
`monthlyCredits`	매달 채워지는 건수. 구독이 없으면 `null`
`creditsRenewAt`	남은 건수가 소멸하고 다음 달치로 채워지는 시각. 구독이 없으면 `null`(소멸 없음)
`expired`	지금까지 소멸한 누적 건수
`grantedFree`	가입 지급분 등 무료로 받은 누적 건수
`grantedPaid`	구독·충전으로 받은 누적 건수
`used`	지금까지 실제로 쓴 건수(환불분 제외)
`subscription`	구독 상태와 다음 갱신일. 구독이 없으면 `null`

건수는 워크스페이스 단위로 하나입니다. 콘솔에서 보내든 API 로 보내든 같은 통에서 빠집니다. 그리고 이월되지 않습니다. creditsRenewAt 이 지나면 남은 건수가 소멸하고 monthlyCredits 만큼으로 다시 채워지니, 그 전에 다 쓰도록 일정을 잡으세요.

이전원본 검증 다음ChatGPT에 연결하기

더 궁금한 점이 있나요?

콘솔 사용법은 사용자 가이드를 보세요. 연동 중 막히면 hello@lillo.cx 로 요청·응답을 함께 보내 주세요.

잔여 건수

bash

curl https://api.pindersign.net/v1/billing/usage \
  -H "Authorization: Bearer psk_xxxxxxxx"