메인 콘텐츠로 건너뛰기
날짜와 API별로 현재 계정의 요청 횟수와 실제 차감된 할당량을 집계하며, 월간 보고서, 추세 차트 및 비용 분석 제작에 적합합니다. 항목별 오류 추적이 필요할 때는 호출 기록 목록을 사용하고, 전체 오프라인 상세 내역이 필요할 때는 호출량 내보내기를 사용하세요. 호출 기록과 청구 요약의 조회 범위는 최근 60일이며, 요청 및 응답 본문은 별도로 최근 30일 동안 보관됩니다. 본문 만료는 해당 기록의 실제 차감, 사용량 또는 집계 통계에 영향을 주지 않습니다.

준비 작업

  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으로 채워지지 않으므로, 차트 작성 전에 클라이언트에서 날짜 축을 보완하세요.

다음 단계