플랫폼 API
서버에서 스페이스의 운영 데이터를 조회하고 자동화에 연결하세요.
모델 호출과 분리된 플랫폼 API의 기본 URL, 인증, 조회 엔드포인트와 OpenAPI 계약을 다룹니다.
플랫폼 API가 필요한 경우
플랫폼 콘솔에 자주 접속하지 않고 사내 모니터링, 저장 또는 정산 배치에서 스페이스 운영 정보를 가져올 때 사용합니다. 모델 추론을 요청하는 AI 게이트웨이 API와는 기본 URL과 인증 키가 다릅니다.
API 연동 없이 제품 화면에서 사용량을 살펴보려면 AI 게이트웨이 분석을 사용합니다.
조회할 수 있는 정보
현재 문서가 지원하는 조회 항목은 월별 사용량 집계와 스페이스의 현재 유닛 잔액입니다. HTTP 메서드, 경로, 파라미터와 응답 필드는 API 엔드포인트에서 확인합니다.
| 확인하려는 것 | 사용할 엔드포인트 |
|---|---|
| KST 월 기준의 모델 및 API 키별 cost와 호출 수 | GET /usage |
| 현재 보유 및 초과 unit과 호출 차단 상태 | GET /balance |
| 호출 한 건 또는 고객 작업별 비용 | AI 게이트웨이 응답의 estimated_cost를 고객 시스템에 저장 |
플랫폼 API의 사용량 집계와 제품의 AI 게이트웨이 분석은 조회 기간, 단위와 분류 기준이 서로 다릅니다. 같은 데이터라고 가정하지 말고 각 문서의 범위를 따릅니다.
Platform API는 현재 월별 사용량을 조회합니다. 일별 또는 고객 작업별 비용 API로 해석하지 않습니다. 작업별 추적이 필요하면 호출 응답의 비용을 요청 시각과 작업 식별자에 연결해 저장합니다.
구현 순서
- 요청을 보내기 전 인증에서 관리 API 키와
Authorization헤더를 확인합니다. - API 엔드포인트에서 조회할 항목을 고르고 요청 및 응답 형식을 확인합니다.
- 클라이언트 생성이나 스키마 검증이 필요하면 OpenAPI 스키마를 사용합니다.
마지막 업데이트