Skip to main content
날짜와 API별로 현재 계정의 요청 횟수 및 실제 차감된 할당량을 집계하며, 월간 보고서, 추세 그래프 및 비용 분석에 적합합니다. 항목별 오류를 확인해야 할 때는 호출 기록 목록을 사용하고, 전체 오프라인 상세 내역이 필요할 때는 호출량 내보내기를 사용하세요.

준비 작업

  1. AceDataCloud 플랫폼에 로그인합니다.
  2. Account Token 콘솔에서 계정 토큰을 생성하고 즉시 저장합니다.
  3. 범위를 좁혀야 하는 경우 서비스 신청 목록, API 자격 증명 목록 또는 API 목록에서 해당 ID를 가져옵니다.
전체 토큰 설명은 계정 토큰 관리를 참조하세요. 이 인터페이스는 Account Token을 사용하며, 비즈니스 Credential은 사용하지 않습니다.

인터페이스 개요

쿼리 파라미터

start_time / end_time은 이전 클라이언트 호환 별칭으로 계속 사용할 수 있으며, 새 연동에서는 created_at_from / created_at_to를 통일하여 사용합니다. 날짜 형식의 created_at_to는 해당 자연일을 포함하며, 즉 다음 날 자정을 경계로 합니다.

요청 예시

베이징 시간 기준 이번 달의 일별/API 집계를 조회하고, 모델 차원도 포함합니다:
지정한 Application의 일주일 사용량을 조회합니다:
Python 예시:

응답 예시

응답 필드

할당량 단위는 관련 Application의 service.unit에 따라 달라집니다. 쿼리에 서로 다른 단위의 서비스가 포함된 경우, 직접 비교하거나 합산하지 않도록 먼저 service_id 또는 application_id별로 나누어 집계하세요. 종료 시간이 시작 시간보다 작거나 같으면, 인터페이스는 완전한 빈 구조를 반환합니다: items=[], total=0, apis={}, requests=0, models=[].

오류 및 성능 권장 사항

  • 기본적으로 include_models를 활성화하지 마세요. 보고서에 실제로 모델 분류가 필요한 경우에만 활성화하세요.
  • 넓은 범위의 쿼리는 우선 service_id 또는 application_id별로 나누어, 단위 혼합을 방지하고 쿼리 비용도 줄이세요.
  • 호출이 없는 날짜는 자동으로 0으로 채워지지 않으므로, 그래프를 그리기 전에 클라이언트에서 날짜 축을 보완하세요.

다음 단계