Usage — 사용량 요약
API 키로 호출한 Gateway 사용량을 모델별·키별·날짜별로 합산해 돌려줍니다. 앱에서 채팅으로 쓴 크레딧은 들어가지 않습니다.
엔드포인트
| Method | Path | 설명 |
|---|---|---|
| GET | /v1/gateway/usage/ | 기간 안의 Gateway 사용량 합계 |
쿼리 파라미터
from
시작일 (string
YYYY-MM-DD, 한국 시간, 그날 포함). 생략하면 이번 달 1일입니다.to
종료일 (string
YYYY-MM-DD, 한국 시간, 그날 포함). 생략하면 오늘입니다.by
묶는 기준. string
model(기본값), key, day 중 하나입니다.scope
string
key(기본값)는 이 요청에 쓴 키의 사용량만, member는 같은 회원의 모든 키를 합칩니다. 삭제한 키의 사용량도 member에 포함됩니다.to 는 from 으로부터 최대 92일 뒤까지 지정할 수 있습니다(양 끝 날짜 포함이므로 달력상 최대 93일).요청
응답
rows[].key는 by에 따라 달라집니다.by | key 값 |
|---|---|
model | 모델 이름. MCP 도구는 mcp:<묶음> (예: mcp:kr-calendar) |
key | 키 이름과 끝 4자리 (예: 260928-QA (...JQM4)) |
day | 날짜 (2026-09-28) |
rows는 크레딧이 많은 순서입니다(day는 날짜 순).에러
| 상태 | 메시지 | 원인 |
|---|---|---|
400 | The window may not exceed 92 days. | 기간이 92일을 넘음 |
400 | 'from' is after 'to'. | 시작일이 종료일보다 늦음 |
400 | 'from' must be YYYY-MM-DD, … | 날짜 형식 오류 |
400 | 'by' must be one of model, key, day. | 지원하지 않는 by |
400 | 'scope' must be 'key' or 'member'. | 지원하지 않는 scope |
마지막 수정 날짜: Sep 29, 2026