요청별 비용

요청 비용을 결정하는 값

게이트웨이 호출 비용은 모델과 사용량에 따라 달라집니다. 제품에 표시되는 현재 에셋별 unit 단가는 에셋에서 확인합니다.

모델 단가

모델마다 입력 및 출력 또는 처리 단위별 단가가 다릅니다. 현재 단가와 지원 엔드포인트는 AI 게이트웨이의 에셋 화면에서 확인합니다.

요청 사용량

요청에 사용한 양은 입력 및 출력 토큰처럼 엔드포인트가 반환하는 사용량 필드에서 확인합니다. 필드 이름과 위치는 엔드포인트마다 다릅니다.

호출 비용

게이트웨이가 해당 호출에 대해 계산하고 과금 기록에 사용하는 비용입니다. 응답에서는 기존 필드 이름인 estimated_cost로 반환합니다.

응답에서 호출 비용 찾기

Chat Completions, Responses, Messages, Embeddings, Image Generations와 Image Edits의 성공 JSON 응답에는 최상위 estimated_cost 객체가 포함됩니다. usage.estimated_cost가 아닙니다. cost를 계산할 수 없는 응답에서는 값이 null일 수 있습니다.

스트리밍에서는 content event마다 비용을 반복하지 않고 누적 usage가 있는 event에 estimated_cost를 제공합니다. event 이름과 위치는 엔드포인트마다 다르므로 엔드포인트별 streaming 계약을 확인합니다. usage event를 받지 못했거나 cost가 null이면 제품의 분석에서 반영된 누적값을 확인합니다.

작업별 비용 저장하기

호출 한 건을 추적하려면 응답의 호출 ID, estimated_cost.amount, estimated_cost.currency, 요청 시각과 사용한 API 키 이름을 고객 시스템에 저장합니다. 영상이나 업무 한 건이 여러 API 호출로 구성되면 고객 시스템의 작업 식별자를 함께 저장하고 같은 작업에 속한 호출 비용을 합산합니다.

콘솔에 자주 접속하지 않는 운영 환경에서는 Platform API의 /usage로 월별 모델 및 API 키 cost를 대조하고 /balance로 현재 유닛 상태를 확인합니다. Platform API의 월별 집계는 호출별 기록을 대신하지 않습니다.

단가, 누적 사용량 및 유닛 잔액과 구분하기

호출 비용이 없거나 다르게 보일 때

응답의 호출 비용과 분석 화면의 누적값이 다릅니다.

응답 값은 호출 한 건의 비용이고 분석 화면은 반영된 사용량의 누적 집계입니다. 조회 범위와 반영 시점을 확인하고, 차이가 계속 크면 렛서 플랫폼에 로그인한 뒤 플랫폼 내 문의 기능에 요청 시각과 API 키 이름을 남깁니다. API 키 값은 보내지 않습니다.

정확한 단가는 어디서 보나요?

왼쪽 메뉴에서 AI 게이트웨이 > 에셋으로 이동해 현재 unit 단가를 확인합니다.