결제

Stripe를 통해 충전하면 잔액이 지갑에 들어오고, 각 API 호출 비용이 실시간으로 차감됩니다. 잔액이 0이 되면 다시 충전할 때까지 호출에 402 insufficient_quota가 반환됩니다.

요금 산정 방식

각 호출에 대해 Kunavo는 다음 두 값 중 더 큰 값을 사용자 비용으로 계산합니다.

• 카탈로그 비용 — 모델 카드에 표시된 가격(토큰 1M개당, 이미지당, 동영상 초당 등)에 실제 사용량을 곱한 값입니다.
• 상위 제공자 비용 — 특정 호출에 대해 상위 제공자가 Kunavo에 청구한 비용입니다. 크레딧으로 표시되며 1크레딧 = $0.005입니다.
• 가격 가산 배율 — 일반적으로 1.5입니다(상위 공급업체가 Kunavo에 청구하는 비용에 50% 가산). 상위 공급업체의 도매 가격이 해당 공급업체의 공식 요금에 더 가까운 일부 중국 공급업체 모델의 경우, 공식 요금보다 낮은 가격을 유지하기 위해 배율을 1.2로 낮춥니다.

max()를 사용하면 (a) 고객이 표시된 카탈로그 가격보다 적게 지불하는 일이 없고, (b) 업스트림 비용이 예상치 못하게 급등한 호출에서도 저희가 손실을 보지 않습니다.

모달리티별 과금 단위

긴 프롬프트에는 제공자의 긴 컨텍스트 요금이 적용됩니다. GPT-5.5, GPT-5.6 Sol과 Terra, GPT-6 Astra에서는 입력 토큰이 272K를 초과하는 프롬프트의 전체 요청에 2× 입력 요금(캐시 읽기 및 쓰기 포함)과 1.5× 출력 요금이 적용됩니다. 이는 OpenAI가 공개한 요금 등급입니다. Claude에는 긴 컨텍스트 할증이 없습니다. 1M 컨텍스트에도 일반 요금이 적용됩니다.

캐시된 토큰

채팅 모델은 안정적인 프롬프트 접두부를 캐시합니다. 캐시 읽기에는 일반 입력 요금보다 훨씬 낮은 요금이 적용되며, Claude와 OpenAI 모두 0.10×, 및 0.025× on Claude Fable 5.1, 0.05× on Claude Opus 5.5의 요금이 적용됩니다. 캐시 쓰기에는 모든 Claude 모델에서 1시간 TTL 쓰기를 포함해 입력 요금의 1.25×가 적용됩니다(Anthropic의 2×보다 낮음). GPT-5.6 Sol, Terra, Luna 및 GPT-6 Astra에도 이 요금이 적용되며, 그 외 모든 모델에서는 일반 입력 요금이 적용됩니다. 각 토큰 유형에는 해당 모델 고유의 할인이 적용되므로 캐시 가격도 입력 및 출력 가격과 동일한 비율로 제공자의 정가에서 할인됩니다. 위의 max() 하한은 캐시를 고려해 계산되므로 카탈로그 가격으로 할인 효과가 상쇄되지 않고 고객에게 그대로 적용됩니다.

전체 가격표와 cache_control 사용 설정 방법, Kunavo의 어피니티 라우팅이 캐시를 활성 상태로 유지하는 방식은 프롬프트 캐싱 가이드에서 확인하세요.

정밀도

Kunavo에서는 모든 금액을 micro_cents 단위로 저장합니다.

• 1 USD = 100,000,000 micro_cents
• 1 cent = 1,000,000 micro_cents
• 최소 청구 단위: 0.0001 cent ($0.000001). 실제 채팅 호출에는 이 최소 금액이 청구되는 경우가 많습니다.

대시보드에 작은 금액은 USD 소수점 이하 6자리까지, 센트 단위에 도달한 금액은 소수점 이하 2자리까지 반올림해 표시합니다. 내부 회계에는 정확한 금액을 사용합니다.

충전

Stripe Checkout을 통해 /app/billing에서 지갑을 충전할 수 있습니다. Stripe가 지원하는 곳에서는 Visa, Mastercard, Amex, JCB, UnionPay 카드를 사용할 수 있으며, 인도를 제외한 모든 곳에서 Apple Pay, Google Pay 및 Link를 사용할 수 있습니다. 국가별 결제 수단은 구매자의 시장에 따라 표시됩니다. 미국에서는 Cash App Pay, Klarna, Afterpay, ACH 은행 자동이체(영업일 기준 3~5일 후 정산), 암호화폐(스테이블코인), 그리고 $100 이상 충전 시 Affirm, $100~$1,500 충전 시 Zip을 사용할 수 있습니다. 중국 본토에서는 Alipay와 WeChat Pay, 한국에서는 KakaoPay, Naver Pay, PAYCO, Samsung Pay 및 국내 카드, 인도에서는 UPI, 브라질에서는 Pix, 네덜란드에서는 iDEAL, 벨기에에서는 Bancontact, 오스트리아에서는 EPS, 포르투갈에서는 MB WAY, 이탈리아에서는 Satispay, 폴란드에서는 BLIK, 영국에서는 Bacs Direct Debit, 영국·아일랜드·핀란드 구매자에게는 Pay by Bank를 사용할 수 있습니다.

등급별 요금

자동 충전

선택 사항입니다. /app/billing에 카드를 한 번 저장하고 세 가지 값을 설정하세요. 충전을 시작할 잔액 기준, 한 번에 추가할 금액, 월별 한도입니다. 그러면 지갑이 자동으로 충전됩니다. 정산 후 잔액이 기준 아래로 떨어지면 몇 초 안에 충전되며, 그사이에 잔액 부족으로 요청이 거부되는 경우에는 요청에 응답하기 전에 충전됩니다. 따라서 무인 에이전트가 402로 멈추지 않습니다.

충전이 진행 중일 때 요청이 거부되면 402와 Retry-After: 3가 반환됩니다. 그 외 모든 거부 응답에는 다음에 취할 조치가 표시됩니다. 같은 페이지에서 언제든지 자동 충전을 끄거나 값을 변경할 수 있습니다.

웹훅 처리 시간

Stripe Checkout을 완료하면 웹훅을 통해 잔액이 갱신됩니다. 결제 확인 후 일반적으로 5–10초 이내에 웹훅이 실행됩니다. 카드 결제는 거의 즉시 반영되지만, 비동기 방식으로만 확인되는 결제 수단은 정산에 며칠이 걸릴 수 있습니다. 자금이 입금될 때까지 주문은 processing로 표시되며 정산 웹훅이 실행되면 지갑에 잔액이 충전됩니다. 다시 결제할 필요가 없으며 기다리는 동안 아무것도 만료되지 않습니다. 완료되지 않은 주문은 pending로 표시되고 정리 작업이 24시간 후 expired로 라벨을 변경합니다. 이 라벨 변경은 표시상의 변경일 뿐 아무것도 취소하지 않습니다.

크레딧 원장

잔액 변동은 모두 추가만 가능한 원장에 기록됩니다.

각 행에는 balance_after_micro_cents가 기록되어 이벤트별 시점의 스냅샷을 확인할 수 있습니다. 전체 내역은 /app/billing에서 확인하세요.

사용량 로그

모든 API 호출은 usage_logs에 한 행으로 기록됩니다:

• 모델, 상태(성공 / 오류), HTTP 상태 코드
• 입력 / 출력 토큰, 캐시 토큰 및 캐시 쓰기 토큰, 이미지 수, 초, 문자 수
• upstream_cost_micro_cents — Kunavo가 업스트림에 지불한 금액
• cost_micro_cents — 사용자가 지불한 금액(마크업 적용 후)
• 지연 시간, 요청 IP, 사용자 에이전트, API 키 접두사

필터와 호출별 상세 페이지가 있는 /app/usage에서 확인할 수 있습니다.

실패한 호출도 비용이 발생하나요?

아니요. Kunavo는 status = success에 대해서만 요금을 청구합니다. 업스트림에서 4xx / 5xx를 반환하거나 작업 시간이 초과되면 호출은 기록되지만 비용은 $0입니다. 업스트림 비용은 사용자에게 전가하지 않고 Kunavo가 부담합니다.

환불

환불은 support@kunavo.com을 통해 사례별로 처리됩니다. 일반적인 환불 사례:

• Kunavo 측 장애로 예산에 손실이 발생한 경우.
• 표시된 카탈로그 가격보다 더 많이 청구된 가격 책정 오류.
• Stripe를 통한 실수로 인한 중복 충전.

환불은 기본적으로 지갑 크레딧으로 지급됩니다. 요청 시 Stripe를 통한 은행 계좌 환불도 가능합니다.

다음 단계

• 공식 가격 대비 할인율이 포함된 전체 가격표
• 오류 코드(할당량 포함)
• 신용카드 없이 Claude API 결제하기