요금과 크레딧 차감

API Gateway 는 모델 제공사의 정가(USD)를 그대로 원화로 환산해 크레딧으로 차감합니다. 별도의 수수료나 마진은 없고, 환율 변동에 대비한 5% 버퍼만 환율에 포함됩니다.

호출 한 건의 제공사 정가(USD). 토큰·초·건 등 모델 카드(GET /v1/gateway/models/)의 pricing 단가로 계산합니다. 캐시 할인, 검색·도구 사용량이 모두 반영된 실제 원가입니다.

전 영업일 최종 고시 하나은행 「현찰 사실 때」 × 1.05, 원/USD. 하루 한 번(09:10 KST) 갱신되며 그날 하루 모든 호출에 같은 값이 적용됩니다. 주말·공휴일은 직전 영업일 고시를 그대로 씁니다.

귀사가 크레딧을 산 단가(원/cr), 견적서 숫자 그대로입니다. 국내 계약은 부가세 포함가(예 2.2), 해외 영세율 계약은 부가세 없는 가격이며 vat_included 로 구분합니다. 개인 충전 크레딧은 충전 상품 가격 ÷ 크레딧 수(예 1,000원 ÷ 500 = 2.0)입니다.

부가세 포함 단가로 나눌 때는 원가도 부가세만큼(× 1.1) 올려 같은 기준으로 맞춥니다. 그래서 cost_krw ÷ credit_conversion_rate 가 언제나 차감 크레딧과 같습니다.

차감 크레딧은 소수 넷째 자리까지 정확히 차감합니다. 최소 과금은 없습니다 — 0.015 크레딧짜리 임베딩 호출은 0.015 크레딧이 차감됩니다. 무료 모델은 0 입니다. 콘솔의 잔액·사용 내역은 보기 좋게 반올림해 표시하지만, 실제 잔액은 차감값을 그대로 누적합니다.

크레딧 단가가 등록된 계정의 모든 응답에는 billing 블록이 실립니다. 7개 필드로 한 호출의 원가와 환산을 그대로 보여 주므로, 위 산식을 응답만으로 검산할 수 있습니다.

제공사 정가(USD).

적용 환율(원/USD).

그 환율의 고시 기준일(YYYY-MM-DD).

원화 환산 원가. credit_conversion_rate 와 같은 부가세 기준입니다.

credit_conversion_rate 와 cost_krw 에 부가세가 포함돼 있는지.

크레딧 단가(원/cr).

이 호출로 차감된 크레딧(소수 넷째 자리).

크레딧 단가가 아직 등록되지 않은 계정은 종전대로 1달러 = 1,000 크레딧으로 차감되고 billing 블록이 오지 않습니다. 잔액은 응답에 싣지 않습니다 — /credits 로 조회하세요.

새 이벤트 타입은 추가되지 않습니다 — 기존 SDK 는 모르는 필드를 무시하므로 그대로 동작합니다.

크레딧 단가가 등록된 계정은 GET /v1/gateway/models/ 응답 최상위에 오늘 적용되는 값이 함께 옵니다.

이 네 값이 없으면 아직 종전 방식(1달러 = 1,000 크레딧)으로 차감되는 계정입니다. 이런 계정은 응답이 이전과 같고, 사용 내역의 cost_usd·exchange_rate·cost_krw 도 비어 있습니다.