플랫폼 API
서버에서 현재 스페이스의 AI 게이트웨이 월별 사용량과 유닛 잔액을 조회하세요.
모델 호출용 AI 게이트웨이 API와 기본 URL 및 인증 키가 다릅니다.
조회할 엔드포인트 선택하기
플랫폼 API는 콘솔에 자주 접속하지 않고 사내 모니터링, 저장 또는 정산 배치에서 현재 스페이스의 AI 게이트웨이 데이터를 읽을 때 사용합니다. 모델 추론을 요청하는 API가 아닙니다. 현재 공개된 조회는 아래 두 가지 엔드포인트이며, 둘 다 Admin이 발급한 관리 API 키와 https://openapi.letsur.ai/v1을 사용합니다. 관리 키를 AI 게이트웨이 API 키와 혼용하지 마세요.
선택한 달의 사용량과 비용
GET /usage: 월별 사용량 조회는 month로 선택한 KST 월의 모델 및 AI 게이트웨이 API 키별 요청 수와 USD 비용의 10진수 문자열을 반환합니다. 파라미터와 응답 필드는 상세 페이지에서 확인하세요.
현재 유닛 잔액과 차단 상태
GET /balance: 유닛 잔액 조회는 현재 보유 및 초과 유닛과 호출 차단 상태를 반환합니다. 응답 필드는 상세 페이지에서 확인하세요. 클라이언트나 타입을 생성한다면 문서용 OpenAPI JSON의 제공 범위를 먼저 읽으세요.
이 API로 확인할 수 없는 것
호출 한 건이나 고객 작업 한 건의 비용은 이 API에서 조회하지 않습니다. 동기 응답의 estimated_cost, 영상 작업 조회의 data.job.usage, Batch 정산의 settled_units를 작업 식별자와 함께 저장하는 방법은 요청별 비용에 있습니다. 제품 화면에서 누적 사용을 살펴보려면 AI 게이트웨이 분석을 사용하세요.
월별 USD 비용은 제품 분석 화면의 unit 집계나 스페이스의 KRW 청구액 및 납부 내역과도 다릅니다. 필요한 값의 단위와 기간을 고르려면 비용 값 찾기, 납부 내역을 확인하려면 결제 및 거래로 이동하세요. 현재 플랫폼 API에는 일별 사용량이나 고객 작업별 비용 조회가 제공되지 않습니다.
요청 시작하기
관리 API 키와 요청 헤더 준비하기에서 발급 조건, 재발급의 영향과 Authorization 형식을 확인한 다음 위에서 선택한 엔드포인트 상세의 요청을 보내세요.