메인 콘텐츠로 건너뛰기

개요

이 엔드포인트는 물리 라우팅 메타데이터를 노출하지 않고 API 키 단위 사용 내역을 반환합니다.

쿼리 파라미터

파라미터타입기본값 / 제한설명
pageinteger기본값 1, 최소 11부터 시작하는 페이지 번호
limitinteger기본값 50, 최소 1, 최대 100페이지 크기
logicalModelstring최대 길이 100요청된 논리 모델 이름
modelVendorstring최대 길이 100공개 모델 공급자
sceneenum-chat, image, audio, video, embedding, rerank, translation, music, 3d
accessChannelenum-platform 또는 byok
startDatestring-포함되는 시작 경계값. 타임존이 포함된 RFC3339 또는 YYYY-MM-DD 지원
endDatestring-포함되는 종료 경계값. 타임존이 포함된 RFC3339 또는 YYYY-MM-DD 지원
startDateendDate 를 함께 보내는 경우 startDateendDate 보다 빠르거나 같아야 합니다.

참고 사항

  • 응답은 페이지네이션됩니다.
  • 응답에는 공개 가능한 과금 및 리포팅 필드만 포함됩니다.
  • 내부 라우팅 및 물리 채널 메타데이터는 의도적으로 숨겨집니다.
  • 모든 금액 응답 필드는 USD 원값을 유지하며, 이제 cost_cny, total_cost_cny, 각 breakdown 내부의 cost_cny 같은 RMB 표시값도 함께 반환합니다.
  • api_key.exchange_rate는 해당 응답의 모든 *_cny 값에 사용된 USD→CNY 환율입니다.

예시

curl "https://api.lemondata.cc/v1/management/api-keys/key_abc123def456/usage?page=1&limit=20&scene=video&accessChannel=platform&startDate=2026-03-01&endDate=2026-03-31" \
  -H "Authorization: Bearer mt-your-management-token"

요청 / 응답

정확한 스키마와 응답 필드는 상단의 인터랙티브 OpenAPI 패널을 참고하세요.