채팅 요금 및 크레딧

API는 선불 크레딧을 사용합니다. 콘솔의 지갑 → 크레딧 추가에서 충전하거나 구독을 선택할 수 있습니다. 구독은 필수가 아닙니다. 지갑에서 API 잔액과 거래 내역도 확인할 수 있습니다.

요금

요금 페이지와 GET /v1/chat/catalog는 실제 과금과 동일한 최신 설정을 사용합니다. 채팅은 입력·출력 각각 100만 토큰당, 음성은 1,000자당 단가로 계산합니다. 모델마다 단가가 다르므로 가격을 고정하지 말고 목록을 조회하세요. 채팅 표준 응답에는 usage가 포함됩니다. 실제 크레딧은 사용 기록 또는 거래 기록에서 확인하세요. billing은 음성 응답에만 포함됩니다.

과금 및 환불

• 채팅 호출 전에 크레딧을 예약하고 실제 토큰 사용량으로 정산하며 남은 금액은 반환합니다.
• 입력에는 대화 기록과 인물 설정이 포함됩니다. 캐시 적중 입력에도 동일한 입력 단가를 적용합니다. 추론 토큰은 출력에 이미 포함되어 중복 과금하지 않습니다.
• 합산 요금은 마지막에 한 번만 소수점 8자리까지 올림합니다. 사용량이 없거나 잘못되면 예약을 해제하고 503을 반환합니다.
• 음성 합성은 채팅과 별도로 과금되며 답변 읽어주기에도 음성 요금이 발생합니다.
• 상위 요청이 실패하면 자동 환불합니다. 잔액이 부족하면 402 insufficient_balance입니다.
• 채팅은 동기 응답이며 비동기 생성 작업으로 등록되지 않습니다.

텍스트는 OpenAI 호환 채팅, 음성과 음성 ID는 음성 및 모델 목록을 참조하세요.

음성 과금

정규화한 텍스트의 과금 대상 문자 수로 계산하고 소수점 8자리까지 올림합니다. 최소 1,000자 단위로 청구하지 않습니다. Speech Light, Speech Pro, Speech Expressive는 UTF-16 코드 단위를 사용합니다. 일반 문자와 한자는 1, 😀 같은 보조 문자는 2입니다. Speech Standard는 Unicode 코드 포인트를 셉니다.

speechModels[].characterCounting 또는 billing.character_counting에서 규칙을 확인하세요. 예를 들어 1,000단위당 0.7크레딧이면 100단위는 0.07크레딧입니다. 합성 실패 시 환불하며, 알 수 없거나 사용할 수 없는 모델은 과금 전에 거부합니다.

로컬 테스트 잔액

Stripe 테스트 결제는 별도 샌드박스 잔액을 충전하므로 실제 API 호출에 사용할 수 없습니다. 로컬 테스트에서는 관리자가 API 잔액을 충전할 수 있습니다. 402는 샌드박스 잔액이 아니라 API 잔액 부족을 뜻합니다. 실제 결제는 확인 후 API 잔액에 반영됩니다.