체리와 결제

청구 시점, 환불, 소진 순서, 만료, 잔액 부족 응답입니다.

체리가 나가는 곳

체리는 팀 지갑에서 나갑니다. 설정의 결제 화면(/settings/billing)에서 잔액, 충전, 내 이용 현황, 내 사용량, 체리 내역을 한곳에서 봅니다.
영역보이는 것
체리 잔액지금 쓸 수 있는 체리와 체리 충전 버튼
내 이용 현황사용 가능, 무상 체리, 충전 체리, 진행 중(예약), 만료 예정
내 사용량최근 기간(UTC)에 쓴 체리 합계. 환불된 금액은 빼고 확정된 사용만 더합니다.
체리 내역충전, 사용, 환불 내역을 최신순으로 보여 줍니다. 환불된 예약은 예약 해제로 표시됩니다.
키별·모델별 사용량은 내 사용량의 열쇠·모델별 사용량 보기에서 이어집니다.

청구 시점

  1. 생성을 접수하면 견적 금액이 곧바로 보류됩니다. 보류된 체리는 잔액에서 빠지고, 이용 현황의 진행 중(예약) 에 따로 보입니다. 사용 가능 잔액과 합쳐 보여 주지 않습니다.
  2. 작업이 정상으로 끝나면 보류가 확정됩니다. 확정은 새로 체리를 더 가져가는 것이 아니라 이미 보류한 금액을 굳히는 것입니다.
  3. 실제 청구액이 보류액보다 작게 정해지면 차액이 같은 처리 안에서 돌아옵니다.
  4. 실패나 취소로 끝나면 보류가 환불됩니다. 사용자 입력이 원인인 실패는 환불되지 않습니다. 코드별 규칙은 오류와 지출의 환불 규칙을 보세요.
같은 멱등 키로 다시 접수하면 같은 보류를 돌려주고 새로 체리를 가져가지 않습니다. 같은 확정·환불 요청을 다시 보내도 한 번만 반영됩니다.

무엇부터 쓰이나

  • 무상 체리가 충전 체리보다 먼저 쓰입니다.
  • 같은 종류 안에서는 만료가 빠른 것부터, 만료 없는 것은 맨 뒤에 쓰입니다.
  • 이용 현황은 이 순서대로 정렬되어 종류별 양과 만료일(“날짜까지” 또는 만료 없음)을 보여 줍니다.

지급과 만료

구분값
가입 지급가입을 마칠 때 500체리, 계정당 한 번
연결 지급처음 AI 도구를 연결해 승인할 때 20체리, 계정당 한 번
무상 체리 만료지급일부터 60일
충전 체리 만료구매일부터 1년
만료 예정 표시만료 7일 전부터
만료 정책이 생기기 전에 있던 잔액은 만료되지 않습니다. 가입 지급량은 공개 가격 경로 GET /pricing/public의 signupBonusCherry로도 읽을 수 있고, 같은 응답의 imageBasis는 이미지 한 장의 체리 환산 기준입니다. 이미지 카탈로그가 아직 준비되지 않았으면 imageBasis는 null입니다.

충전

  1. 요금제 화면(/pricing)이나 결제 화면의 체리 충전으로 들어갑니다.
  2. 패키지의 충전하기 버튼으로 결제합니다.
  3. 결제를 마치면 충전 완료 화면(/cherry-store/success)으로, 끝내지 못하면 결제 실패 화면(/cherry-store/fail)으로 돌아옵니다. 실패 화면에서도 주문 복구 정보는 지워지지 않으니 요금제 화면의 체리 충전 구역에서 다시 시도합니다.

환불과 청약철회

구매 버튼 근처에 이런 안내가 보입니다. 이미 사용한 체리에는 청약철회가 제한될 수 있고, 쓰지 않은 체리는 철회할 수 있습니다. 쓰지 않은 충전 체리는 남은 비율만큼 환불을 신청할 수 있고, 무상 체리는 환불에서 빠집니다. 자세한 조건은 환불 정책과 유료 서비스 약관이 정합니다.

잔액이 모자랄 때

  • 화면에서는 생성을 시작할 때 "체리가 부족해요. 필요 N체리, 보유 M체리."가 보입니다. 충전한 뒤 같은 동작을 다시 하면 됩니다.
  • 공개 REST와 MCP는 402 INSUFFICIENT_CHERRY로 답하고 details에 required_cherry(보류하려던 양)와 balance_cherry(지금 쓸 수 있는 양)가 있습니다. 충전한 뒤 같은 요청을 다시 보냅니다.
  • 잔액 부족으로 거절된 요청은 작업을 만들지 않습니다.
  • 키에 지출 한도가 있으면 잔액이 충분해도 한도 때문에 429 SPEND_LIMIT_EXCEEDED가 날 수 있습니다. 두 경우는 error.code로 구분합니다.

동시 생성 한도

이용 현황의 동시 생성에 이미지, 영상, 오디오별로 진행 중인 수와 한도가 보입니다. 한도에 닿으면 "동시에 만들 수 있는 이미지 수는 N개예요. 지금 M개가 진행 중이니 끝난 뒤 다시 시도해 주세요."라고 안내합니다. 값은 서버 설정이라 이 문서에 적지 않습니다.

관련