크레딧 충전과 만료
XenoCI는 선불 USD 크레딧에서 분당 요금을 차감합니다, 요율, 충전 방법, 충전 건별 1년 만료, 잔액이 0일 때의 동작, 7일 청약철회를 설명합니다
XenoCI는 선불 크레딧제입니다, 조직 지갑에 USD 크레딧을 충전해 두면 잡이 시작한 분마다 차감됩니다, 구독, 최소 약정, 자동 충전은 없습니다
요율
| 항목 | 값 |
|---|---|
| 분당 요율 (런칭가) | US$0.0396, 부가세 포함 |
| 정가 | US$0.078 (취소선 표시, 49% 할인) |
| 과금 단위 | 시작한 분, ceil(실행 초 / 60) |
| 요율 고정 시점 | 잡이 대기열을 떠나 준비를 시작하는 순간, 잡 응답의 rate_usd_per_min |
| 1시간 빌드 | 약 US$2.38 |
과금되지 않는 것
- VM 준비 시간(슬롯 확보부터 스크립트 시작까지)
- 대기 중이나 준비 중에 취소한 잡(0분)
- 플랫폼 오류(
platform_error)로 끝난 잡, 서버 재시작으로 끊긴 잡
충전하기
소유자와 관리자만 충전할 수 있습니다, 결제는 원화 카드 결제(PortOne 경유)이고 USD 크레딧이 적립됩니다
- 콘솔 왼쪽 아래 크레딧 또는 크레딧 구매를 누릅니다
- 금액을 고릅니다, US$5, US$20, US$50, US$100 또는 기타에서 US$5 이상 US$1,000 이하의 정수
- 결제 수단을 고르고 과세 사업자면 사업자 등록번호(선택)를 넣습니다
- 총 결제 금액(원화)을 확인하고 주문을 누르면 결제창이 열립니다
- 결제가 끝나면 잔액에 바로 적립됩니다
| 규칙 | 내용 |
|---|---|
| 가격 | 부가세 포함, US$N을 충전하면 US$N을 내고 US$N 크레딧을 받습니다 |
| 원화 금액 | ceil(USD × 고정 환율), 환율은 주문 때 고정됩니다 |
| 고정 환율 | 한국은행 고시 매매기준율 × 1.02, KST 영업일마다 한 번 정해지고 주말과 공휴일은 직전 영업일 값 |
| 주문 유효 시간 | 60분, 지나면 만료되고 새 주문을 만듭니다 |
| 환율이 없을 때 | 그날 환율이 아직 없으면 충전이 잠시 닫힙니다(fx_rate_unavailable) |
CLI와 MCP는 결제를 하지 않습니다, xenocast credits topup --open은 콘솔 충전 링크만 엽니다
잔액의 세 가지 숫자
| 이름 | 뜻 |
|---|---|
잔액 (balance) | 원장 합계 |
사용 가능 (available) | 만료되지 않은 충전 건의 남은 합에서 실행 중인 잡이 이미 쓴 금액을 뺀 값, 새 잡 승인은 이 값으로 합니다 |
사용 중 (reserved) | 실행 중인 잡이 이미 쓴 금액, 잡이 시작되면 1분이 잡히고 그 뒤 분마다 늘어납니다 |
콘솔 크레딧 화면, xenocast credits, MCP credits 도구, API 잔액 조회에서 봅니다
만료
- 충전 한 번이 한 건이고 결제일로부터 1년 뒤 같은 시각(UTC)에 만료됩니다, 2월 29일 결제는 2월 28일에 만료됩니다
- 여러 건이 있으면 만료가 빠른 건부터 먼저 씁니다
- 만료된 금액은 원장에
expiry행으로 남고 잔액에서 빠집니다 - 콘솔 크레딧 → 충전 건에 건마다 만료일과 남은 금액, 곧 만료 표시가 있습니다
잔액이 0이 되면
| 상황 | 동작 |
|---|---|
| 새 잡 제출 | 사용 가능 잔액이 1분 요금(US$0.0396)보다 적으면 402 insufficient_credit, 응답에 잔액과 topup_url |
| 실행 중인 잡 | 다음 1분을 예약할 수 없으면 분 경계 직전에 중단합니다, 잡 상태와 end_reason은 credit_exhausted |
| 대기 중인 잡 | 슬롯을 받는 순간 다시 검사해 잔액이 없으면 credit_exhausted로 끝납니다 |
| 정산 | 잔액은 음수가 되지 않습니다, 살아 있는 충전 건까지만 차감합니다 |
CLI, MCP, GitHub Action은 이 오류를 종료 코드 3으로 끝내고 충전 링크를 한 줄로 남깁니다
알림
| 알림 | 언제 |
|---|---|
| 낮은 잔액 | 사용 가능 잔액이 US$1.188(런칭가 30분어치) 이하로 떨어지는 순간, 조직당 24시간에 한 번 |
| 잔액 소진 | 실행 중인 잡이 credit_exhausted로 끊겼을 때, 충전 주기마다 한 번 |
수신자는 소유자와 관리자이고 알림에서 종류별로 끌 수 있습니다
7일 청약철회
결제 후 7일 안에는 아직 쓰지 않은 크레딧만큼을 철회할 수 있습니다
- 크레딧 → 충전 내역에서 그 건의 청약철회를 누릅니다
- 철회한 크레딧은 바로 잔액에서 빠지고, 그만큼의 원화가 결제 수단으로 부분 취소됩니다
- 환불 원화 =
floor(결제 원화 × 남은 크레딧 / 충전 크레딧) - 7일이 지나면
withdrawal_window_closed로 거절됩니다, 그 밖의 환불은 없습니다 - 철회한 금액은 티어 누적 충전액에서 빠지지만 티어는 내려가지 않습니다
참고 콘솔의 충전과 철회가 쓰는 API 경로(환율, 충전 주문, 확인, 철회, 잔액)는 계약에 정의되어 있고 서버 연결은 진행 중입니다, 각 API 페이지의 참고 상자에 현재 상태가 있습니다