KovAPIKovAPI

채팅·이미지·영상의 과금 방식, 크레딧 예약과 정산, 과금되지 않는 경우, 그리고 사용액 확인·충전·환불 방법.

크레딧

잔액은 크레딧으로 표시되며 1달러 = 200크레딧입니다. 요금 페이지와 문서의 가격은 미국 달러로 표시되고, 과금할 때 이 비율로 크레딧으로 환산합니다. /v1/usage는 달러 잔액과 크레딧을 함께 돌려줍니다.

모델 종류별 과금 방식

종류과금 단위설명
채팅토큰 단위: 입력과 출력 요금을 따로 계산(100만 토큰당 미국 달러)캐시 적중분은 더 저렴한 캐시 읽기 요금으로, 추론 토큰은 출력 요금으로 과금됩니다.
이미지장당 과금, 해상도 등급(1K / 2K / 4K)별 요금실제로 전달된 장수만 과금되며, 실패한 이미지는 무료입니다.
영상대부분 초 단위(단가 × 길이), 일부 모델은 클립 단위모델별로 초 단위인지 클립 단위인지는 요금 페이지와 해당 모델 문서에 적혀 있습니다.

모델별 요금 →

채팅 과금 상세

  • usage.prompt_tokens는 입력, usage.completion_tokens는 출력입니다. 캐시 적중분은 캐시 읽기 요금으로 따로 과금됩니다.
  • 추론 모델에서는 사고 토큰이 출력으로 계산되어, 사고 내용을 읽든 읽지 않든 출력 요금으로 과금됩니다. 대부분의 모델은 사고에 쓴 토큰 수를 usage.completion_tokens_details.reasoning_tokens에 알려 줍니다.
  • 스트리밍이 중간에 끊기면 끊기기 전까지 생성된 사용량만 과금되며, 완성된 답변 전체로 과금되지 않습니다.
  • Claude의 프롬프트 캐싱에는 캐시 쓰기 요금도 있습니다. 모델별 캐시 읽기·쓰기 요금은 해당 모델 문서와 요금 페이지에 있습니다.

크레딧 예약과 정산

  • 요청을 실행하기 전에 예상 비용만큼 잔액에서 크레딧을 예약합니다. 잔액이 부족하면 402 insufficient_quota가 돌아오고 모델은 호출되지 않습니다.
  • 채팅은 실제 사용량으로 정산하고 남은 예약분을 돌려줍니다. 이미지는 전달된 장수로 정산하고, 영상은 주문한 길이 또는 클립 수로 정산합니다(예약한 금액과 같음).
  • 동시에 실행되는 요청이 많을수록 예약되는 크레딧도 많아집니다. 잔액이 빠듯하면 예약 때문에 402가 날 수 있으며, 앞선 요청이 정산되면 해소됩니다.

실패한 요청은 무료

실패한 요청은 어떤 경우에도 과금되지 않습니다. 업스트림 오류, 시간 초과, 콘텐츠 거부, 게이트웨이 오류 모두 마찬가지입니다. 비동기 작업이 실패하면 예약된 크레딧이 자동으로 전액 돌아오며, 사유는 호출 로그에 남습니다.

다른 모델이 대신 답변할 때

일부 채팅 모델을 잠시 쓸 수 없을 때, 요청이 실패하지 않도록 게이트웨이가 다른 모델이 대신 답변하게 할 수 있습니다. 이때는 두 모델 가운데 더 낮은 요금으로 과금되며, 호출 로그에 어느 모델이 답변했고 어느 요금이 적용되었는지 표시됩니다.

사용액 확인

  • 콘솔 「호출 로그」: 최근 60일의 모든 호출을 모델, 소요 시간, 사용량, 과금액과 함께 보여 주며, 실패한 호출에는 사유가 표시됩니다.
  • 콘솔 「사용량」: 일별·모델별·키별 합계를 보여 주며 CSV로 내보낼 수 있습니다.
  • 코드에서: GET /v1/usage가 잔액, 누적·오늘 사용액, 모델별 사용량을 돌려줍니다. 자세한 내용은 API 레퍼런스를 보세요.

충전과 환불

콘솔의 「결제」 페이지에서 충전합니다. WeChat Pay는 ¥10(260크레딧)부터, USDT와 카드는 $5부터 가능합니다. 크레딧은 만료되지 않습니다. 가입 및 첫 충전 보너스는 자주 묻는 질문을 보세요.

충전 후 7일 이내에는 사용하지 않은 유료 충전 크레딧을 고객 지원을 통해 환불받을 수 있으며, 환불 1건당 수수료(2026년 10월 29일 이후 충전은 $1.40, 그 이전 충전은 $0.40)가 차감됩니다. 보너스 크레딧은 환불되지 않습니다. USDT 결제도 환불할 수 있습니다.

USDT로 충전

콘솔의 「결제」 페이지에서 USDT와 패키지, 체인을 선택하면 네트워크, 보낼 정확한 금액, 받는 주소가 적힌 결제 페이지가 나옵니다. 이 세 가지대로 한 번 송금하면 온체인에서 확인된 뒤 크레딧이 자동으로 충전됩니다(보통 몇 분).

  • 체인 선택: 기본값은 BEP20이며 거래소에서는 BSC / BNB Smart Chain으로 표시되고 출금 수수료가 가장 낮습니다(바이낸스 기준 약 0.01 USDT). 스캔한 뒤 이 네트워크를 직접 선택하고 ETH나 opBNB는 고르지 마세요. Solana는 바이낸스나 OKX로 스캔하면 네트워크가 자동으로 선택되지만 출금 수수료가 더 높습니다(바이낸스 기준 약 0.3 USDT). TRC20(거래소에서는 TRX · Tron)은 수수료가 가장 높습니다(바이낸스 기준 약 1.5 USDT). 반드시 결제 페이지에 적힌 체인으로 보내세요. 다른 체인으로 보낸 금액은 되찾을 수 없습니다.
  • 금액은 정확히: 같은 체인의 주문은 받는 주소 하나를 함께 쓰며, 시스템은 소수점까지의 금액으로 어느 주문인지 구분합니다. 도착하는 금액이 결제 페이지의 숫자와 정확히 같아야 하며, 많거나 적으면 자동으로 충전되지 않습니다.
  • 수수료는 입력한 금액에서 빠집니다: 거래소에서 출금할 때 출금 수수료는 입력한 수량에서 빠지므로, 「받는 수량 / Recipient receives」 칸이 결제 페이지의 금액과 정확히 같아지도록 하세요. 바이낸스에서는 받는 수량 옆의 ⇆를 누르면 받을 금액을 바로 입력할 수 있습니다.
  • 결제 페이지는 60분 동안 유효합니다: 이 시간 안에 송금하세요. 만료된 뒤 보낸 금액은 자동으로 충전되지 않으니 새로 주문해 주세요.
  • 결제했는데 충전되지 않았다면: 다시 결제하지 마세요. 주문 번호(결제 페이지 하단)와 거래 해시(TxID)를 알려 주시면 확인한 뒤 직접 충전해 드리며, 보통 1시간 안에 처리됩니다.

문의하기 →