요청별 비용
모델 호출 한 건이나 비동기 작업 한 건의 비용을 확인하고 고객 시스템의 작업과 연결해 저장하세요.
동기 응답, 영상 작업 조회, Batch 정산은 비용이 확인되는 시점과 필드가 다릅니다.
어떤 호출의 비용을 기록하나요?
게이트웨이 비용은 선택한 모델과 실제 사용량에 따라 달라집니다. 현재 모델의 unit 단가는 에셋에서 확인합니다. 아래 값은 호출이나 작업별 추적에 쓰며, 누적 사용량, 잔액, 월별 USD 비용 또는 KRW 청구액 중 필요한 값을 찾는다면 비용 값 찾기에서 시작하세요.
| 호출 방식 | 비용을 확인할 때 | 기록할 값과 식별자 |
|---|---|---|
| 동기 모델 호출 | 성공 응답에서 | 최상위 estimated_cost.amount와 currency, 고객 요청 식별자와 시각 |
| 비동기 영상 | 접수 후 같은 작업 ID의 조회에서 | data.job.usage.amount와 currency, 작업 ID와 시각 |
| Batch | 처리 상태와 별도로 정산을 확인한 뒤 | settlement_status: "settled"와 settled_units, Batch ID |
동기 응답에서 비용 읽기
Chat Completions, Responses, Messages, Embeddings, Image Generations와 Image Edits의 성공 JSON 응답에는 최상위 estimated_cost 객체가 포함됩니다. usage.estimated_cost가 아닙니다. 비용을 계산할 수 없는 응답에서는 값이 null일 수 있습니다.
| 필드 | 타입 | 의미 |
|---|---|---|
estimated_cost.amount | string | 해당 호출의 비용을 소수 문자열로 반환 |
estimated_cost.currency | string | 현재 unit 반환 |
estimated_cost.disclaimer | string | 기존 필드 이름과 함께 제공되는 안내 문구 |
estimated_cost라는 이름에는 estimated가 남아 있지만 amount는 해당 호출의 비용 추적에 사용하는 값입니다. VAT 또는 계약상 정산 조정이 반영된 최종 납부 금액은 아닙니다. 고객 시스템의 요청 식별자, 요청 시각, API 키 이름과 이 값을 연결하고, 응답에 호출 ID가 있으면 함께 보관하세요.
스트리밍에서는 내용 이벤트마다 비용을 반복하지 않고 누적 usage가 있는 이벤트에서 확인합니다. 이벤트 위치는 해당 엔드포인트 명세를 따릅니다. usage 이벤트를 받지 못했거나 비용이 null이면 비용을 0으로 저장하지 말고, 분석 화면의 누적값이 반영됐는지 별도로 확인하세요. 누적값은 특정 호출의 비용을 대신하지 않습니다.
비동기 영상 작업 비용 확인하기
생성 접수 응답의 작업 ID를 저장하고 같은 ID로 Jobs를 조회합니다. data.job.usage.amount와 currency가 제공되면 작업 ID, 요청 시각과 모델 코드에 연결해 기록합니다. items에는 수량과 단위가 있고 unit_price는 생략될 수 있습니다.
해상도, 길이와 입력 조건에 따라 사용량과 단가가 달라집니다. usage가 아직 없다면 무료로 해석하지 말고 같은 작업을 다시 조회합니다. 파일 수령 실패는 자동 환불이 아니며 이 값만으로 최종 스페이스 차감 완료를 확정하지 않습니다. 영상 파일과 비용을 각각 확인하는 순서를 따르세요.
Batch의 확정 비용 확인하기
같은 Batch ID로 Batches를 조회합니다. status: "completed"는 모든 행의 성공이나 비용 확정을 뜻하지 않습니다. settlement_status가 settled이고 settled_units가 null이 아닐 때 유닛 금액 문자열을 확정 비용으로 기록합니다. 정산 중의 null은 무료가 아니며, 정산 완료 뒤 반환된 문자열 "0"과 다릅니다. quarantined라면 자동 조회를 멈추고 Batch ID로 문의합니다.
고객 작업 하나가 여러 요청 또는 작업으로 이뤄지면 각 식별자와 비용을 고객 시스템의 작업 식별자에 연결해 합산합니다. 같은 영상 또는 Batch ID를 반복 조회한 응답은 새 비용으로 다시 더하지 않습니다. Batch 결과 파일과 정산을 확인하는 순서를 따르세요.
기록이 없거나 값이 다를 때
호출 응답의 비용과 분석 화면의 누적값은 범위와 반영 시점이 다릅니다. 요청 시각, API 키와 조회 기간을 대조하세요. 모델 단가는 현재 카탈로그 값이므로 과거 호출의 비용을 현재 단가로 다시 계산해 같아야 한다고 판단하지 마세요.
비용이 계속 없거나 예상과 크게 다르면 렛서 플랫폼에 로그인한 뒤 플랫폼 내 문의 기능에 요청 시각, 작업 또는 Batch ID, API 키 이름을 남깁니다. API 키 값은 보내지 않습니다.