• Messages
  • Managed Agents
  • 관리자
Search...
⌘K
조직
Admin API워크스페이스
인증
개요Workload Identity FederationWIF 레퍼런스
모니터링
Usage and Cost APIRate Limits APIClaude Code Analytics API
데이터 및 규정 준수
데이터 상주API 및 데이터 보존
Compliance API
개요액세스 권한 얻기활동 피드채팅, 파일 및 프로젝트조직, 사용자, 역할 및 그룹통합 설계오류FAQ
Log in
Usage and Cost API
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...

Solutions

  • AI agents
  • Code modernization
  • Coding
  • Customer support
  • Education
  • Financial services
  • Government
  • Life sciences

Partners

  • Amazon Bedrock
  • Google Cloud's Vertex AI

Learn

  • Blog
  • Courses
  • Use cases
  • Connectors
  • Customer stories
  • Engineering at Anthropic
  • Events
  • Powered by Claude
  • Service partners
  • Startups program

Company

  • Anthropic
  • Careers
  • Economic Futures
  • Research
  • News
  • Responsible Scaling Policy
  • Security and compliance
  • Transparency

Learn

  • Blog
  • Courses
  • Use cases
  • Connectors
  • Customer stories
  • Engineering at Anthropic
  • Events
  • Powered by Claude
  • Service partners
  • Startups program

Help and security

  • Availability
  • Status
  • Support
  • Discord

Terms and policies

  • Privacy policy
  • Responsible disclosure policy
  • Terms of service: Commercial
  • Terms of service: Consumer
  • Usage policy
관리자/모니터링

Usage 및 Cost API

Usage & Cost Admin API를 사용하여 조직의 API 사용량 및 비용 데이터에 프로그래밍 방식으로 액세스하세요.

Admin API는 개인 계정에서는 사용할 수 없습니다. 팀원과 협업하고 멤버를 추가하려면 Console → Settings → Organization에서 조직을 설정하세요.

Usage & Cost Admin API는 조직의 과거 API 사용량 및 비용 데이터에 대한 프로그래밍 방식의 세분화된 액세스를 제공합니다. 이 데이터는 Claude Console의 Usage 및 Cost 페이지에서 확인할 수 있는 정보와 유사합니다.

이 API를 사용하면 Claude 구현을 더 효과적으로 모니터링, 분석 및 최적화할 수 있습니다:

  • 정확한 사용량 추적: 응답 토큰 카운팅에만 의존하는 대신 정확한 토큰 수와 사용 패턴을 확인할 수 있습니다
  • 비용 조정: 재무 및 회계 팀을 위해 내부 기록을 Anthropic 청구 내역과 대조할 수 있습니다
  • 제품 성능 및 개선: 제품 성능을 모니터링하면서 시스템 변경 사항이 개선 효과를 가져왔는지 측정하거나 알림을 설정할 수 있습니다
  • 속도 제한 및 Priority Tier 최적화: 프롬프트 캐싱이나 특정 프롬프트와 같은 기능을 최적화하여 할당된 용량을 최대한 활용하거나 전용 용량을 구매할 수 있습니다.
  • 고급 분석: Console에서 제공되는 것보다 더 심층적인 데이터 분석을 수행할 수 있습니다

Admin API 키 필요

이 API는 Admin API의 일부입니다. 이러한 엔드포인트에는 표준 API 키와 다른 Admin API 키(sk-ant-admin...으로 시작)가 필요합니다. 관리자 역할을 가진 조직 구성원만 Claude Console을 통해 Admin API 키를 프로비저닝할 수 있습니다.

AWS의 Claude Platform: 프로그래밍 방식의 Usage 및 Cost API 엔드포인트는 현재 사용할 수 없습니다. 대신 Claude Console의 Usage 및 Cost 페이지에서 사용량 및 비용 데이터를 확인하세요.

파트너 솔루션

주요 옵저버빌리티 플랫폼은 커스텀 코드를 작성하지 않고도 Claude API 사용량 및 비용을 모니터링할 수 있는 즉시 사용 가능한 통합을 제공합니다. 이러한 통합은 API 사용량을 효과적으로 관리하는 데 도움이 되는 대시보드, 알림 및 분석 기능을 제공합니다.

CloudZero

비용 추적 및 예측을 위한 클라우드 인텔리전스 플랫폼

빠른 시작

지난 7일간 조직의 일일 사용량을 가져옵니다:

cURL
curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2025-01-08T00:00:00Z&\
ending_at=2025-01-15T00:00:00Z&\
bucket_width=1d" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

통합을 위한 User-Agent 헤더 설정

통합을 구축하는 경우 사용 패턴을 파악할 수 있도록 User-Agent 헤더를 설정하세요:

User-Agent: YourApp/1.0.0 (https://yourapp.com)

Usage API

/v1/organizations/usage_report/messages 엔드포인트를 사용하여 모델, 워크스페이스 및 서비스 티어별 상세 분석과 함께 조직 전체의 토큰 소비량을 추적하세요.

주요 개념

  • 시간 버킷: 고정된 간격(1m, 1h 또는 1d)으로 사용량 데이터를 집계합니다
  • 토큰 추적: 캐시되지 않은 입력, 캐시된 입력, 캐시 생성 및 출력 토큰을 측정합니다
  • 필터링 및 그룹화: API 키, 워크스페이스, 모델, 서비스 티어, 컨텍스트 윈도우, 데이터 레지던시 또는 속도(베타)별로 필터링하고 이러한 차원별로 결과를 그룹화합니다
  • 서버 도구 사용: 웹 검색과 같은 서버 측 도구의 사용량을 추적합니다

전체 매개변수 세부 정보 및 응답 스키마는 Usage API 레퍼런스를 참조하세요.

기본 예제

모델별 일일 사용량

cURL
curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2025-01-01T00:00:00Z&\
ending_at=2025-01-08T00:00:00Z&\
group_by[]=model&\
bucket_width=1d" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

필터링을 적용한 시간별 사용량

cURL
curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2025-01-15T00:00:00Z&\
ending_at=2025-01-15T23:59:59Z&\
models[]=claude-opus-4-8&\
service_tiers[]=batch&\
context_window[]=0-200k&\
bucket_width=1h" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

API 키 및 워크스페이스별 사용량 필터링

cURL
curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2025-01-01T00:00:00Z&\
ending_at=2025-01-08T00:00:00Z&\
api_key_ids[]=apikey_01Rj2N8SVvo6BePZj99NhmiT&\
api_key_ids[]=apikey_01ABC123DEF456GHI789JKL&\
workspace_ids[]=wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ&\
workspace_ids[]=wrkspc_01XYZ789ABC123DEF456MNO&\
bucket_width=1d" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

조직의 API 키 ID를 가져오려면 List API Keys 엔드포인트를 사용하세요.

조직의 워크스페이스 ID를 가져오려면 List Workspaces 엔드포인트를 사용하거나 Claude Console에서 조직의 워크스페이스 ID를 확인하세요.

데이터 레지던시

inference_geo 차원으로 사용량을 그룹화하고 필터링하여 데이터 레지던시 제어를 추적하세요. 이는 조직 전체의 지리적 라우팅을 확인하는 데 유용합니다.

cURL
curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2026-02-01T00:00:00Z&\
ending_at=2026-02-08T00:00:00Z&\
group_by[]=inference_geo&\
group_by[]=model&\
bucket_width=1d" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

특정 지역으로 필터링할 수도 있습니다. 유효한 값은 global, us 및 not_available입니다:

cURL
curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2026-02-01T00:00:00Z&\
ending_at=2026-02-08T00:00:00Z&\
inference_geos[]=us&\
group_by[]=model&\
bucket_width=1d" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

2026년 2월 이전에 출시된 모델(Claude Opus 4.6 및 Claude Sonnet 4.6 이전)은 inference_geo 요청 매개변수를 지원하지 않으므로 해당 사용량 보고서는 이 차원에 대해 "not_available"을 반환합니다. inference_geos[]에서 not_available을 필터 값으로 사용하여 해당 모델을 대상으로 지정할 수 있습니다.

Fast mode (리서치 프리뷰)

speed 차원으로 그룹화하고 필터링하여 fast mode 사용량을 추적하세요. 이는 standard 모드와 fast 모드 사용량을 모니터링하는 데 유용합니다.

cURL
curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2026-02-01T00:00:00Z&\
ending_at=2026-02-08T00:00:00Z&\
group_by[]=speed&\
group_by[]=model&\
bucket_width=1d" \
  --header "anthropic-version: 2023-06-01" \
  --header "anthropic-beta: fast-mode-2026-02-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

특정 속도로 필터링할 수도 있습니다. 유효한 값은 standard 및 fast입니다:

cURL
curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2026-02-01T00:00:00Z&\
ending_at=2026-02-08T00:00:00Z&\
speeds[]=fast&\
group_by[]=model&\
bucket_width=1d" \
  --header "anthropic-version: 2023-06-01" \
  --header "anthropic-beta: fast-mode-2026-02-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

speeds[] 필터와 speed group_by 값 모두 fast-mode-2026-02-01 베타 헤더가 필요합니다.

시간 세분화 제한

세분화기본 제한최대 제한사용 사례
1m60 버킷1440 버킷실시간 모니터링
1h24 버킷168 버킷일일 패턴
1d7 버킷31 버킷주간/월간 보고서

Cost API

/v1/organizations/cost_report 엔드포인트를 사용하여 서비스 수준의 비용 분석을 USD로 조회하세요.

주요 개념

  • 통화: 모든 비용은 USD로 표시되며 최소 단위(센트)의 십진수 문자열로 보고됩니다
  • 비용 유형: 토큰 사용량, 웹 검색 및 코드 실행 비용을 추적합니다
  • 그룹화: 상세 분석을 위해 워크스페이스 또는 설명별로 비용을 그룹화합니다. description으로 그룹화하면 응답에 model 및 inference_geo와 같은 파싱된 필드가 포함됩니다
  • 시간 버킷: 일일 세분화만 지원(1d)

전체 매개변수 세부 정보 및 응답 스키마는 Cost API 레퍼런스를 참조하세요.

Priority Tier 비용은 다른 청구 모델을 사용하며 cost 엔드포인트에 포함되지 않습니다. 대신 usage 엔드포인트를 통해 Priority Tier 사용량을 추적하세요.

기본 예제

cURL
curl "https://api.anthropic.com/v1/organizations/cost_report?\
starting_at=2025-01-01T00:00:00Z&\
ending_at=2025-01-31T00:00:00Z&\
group_by[]=workspace_id&\
group_by[]=description" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

페이지네이션

두 엔드포인트 모두 대용량 데이터셋에 대한 페이지네이션을 지원합니다:

  1. 초기 요청을 보냅니다
  2. has_more가 true인 경우 다음 요청에서 next_page 값을 사용합니다
  3. has_more가 false가 될 때까지 계속합니다
cURL
# 첫 번째 요청
curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2025-01-01T00:00:00Z&\
ending_at=2025-01-31T00:00:00Z&\
limit=7" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

# 응답에 포함된 내용: "has_more": true, "next_page": "page_xyz..."

# 페이지네이션을 사용한 다음 요청
curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2025-01-01T00:00:00Z&\
ending_at=2025-01-31T00:00:00Z&\
limit=7&\
page=page_xyz..." \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

일반적인 사용 사례

Claude Cookbook에서 상세한 구현을 살펴보세요:

  • 일일 사용량 보고서: 토큰 소비 추세 추적
  • 비용 귀속: 차지백을 위해 워크스페이스별로 비용 할당
  • 캐시 효율성: 프롬프트 캐싱 측정 및 최적화
  • 예산 모니터링: 지출 임계값에 대한 알림 설정
  • CSV 내보내기: 재무 팀을 위한 보고서 생성

자주 묻는 질문

데이터는 얼마나 최신 상태인가요?

사용량 및 비용 데이터는 일반적으로 API 요청 완료 후 5분 이내에 표시되지만, 간혹 지연이 더 길어질 수 있습니다.

권장 폴링 빈도는 어떻게 되나요?

API는 지속적인 사용의 경우 분당 1회 폴링을 지원합니다. 짧은 버스트(예: 페이지네이션된 데이터 다운로드)의 경우 더 빈번한 폴링이 허용됩니다. 자주 업데이트가 필요한 대시보드의 경우 결과를 캐시하세요.

코드 실행 사용량은 어떻게 추적하나요?

코드 실행 비용은 cost 엔드포인트에서 description 필드의 Code Execution Usage 아래에 그룹화되어 표시됩니다. 코드 실행은 usage 엔드포인트에 포함되지 않습니다.

Priority Tier 사용량은 어떻게 추적하나요?

usage 엔드포인트에서 service_tier로 필터링하거나 그룹화하고 priority 값을 확인하세요. Priority Tier 비용은 cost 엔드포인트에서 제공되지 않습니다.

Workbench 사용량은 어떻게 처리되나요?

Workbench에서의 API 사용량은 API 키와 연결되지 않으므로 해당 차원으로 그룹화하더라도 api_key_id는 null이 됩니다.

기본 워크스페이스는 어떻게 표시되나요?

기본 워크스페이스에 귀속된 사용량 및 비용은 workspace_id에 대해 null 값을 가집니다.

Claude Code의 사용자별 비용 분석은 어떻게 얻나요?

Claude Code Analytics API를 사용하세요. 이 API는 많은 API 키별로 비용을 분석할 때 발생하는 성능 제한 없이 사용자별 예상 비용 및 생산성 지표를 제공합니다. 많은 키를 사용하는 일반 API 사용량의 경우 Usage API를 사용하여 비용 대리 지표로 토큰 소비량을 추적하세요.

참고 자료

Usage 및 Cost API는 사용자에게 더 나은 경험을 제공하고, 비용을 관리하며, 속도 제한을 유지하는 데 도움이 될 수 있습니다. 다음과 같은 다른 기능에 대해 자세히 알아보세요:

  • Admin API
  • Admin API 레퍼런스
  • 가격 책정
  • 프롬프트 캐싱 - 캐싱으로 비용 최적화
  • 배치 처리 - 배치 요청 50% 할인
  • 속도 제한 - 사용량 티어 이해하기
  • Rate Limits API - 구성된 속도 제한 조회
  • 데이터 레지던시 - 추론 지역 제어

Was this page helpful?

  • 파트너 솔루션
  • 빠른 시작
  • Usage API
  • 주요 개념
  • 기본 예제
  • 시간 세분화 제한
  • Cost API
  • 주요 개념
  • 기본 예제
  • 페이지네이션
  • 일반적인 사용 사례
  • 자주 묻는 질문
  • 데이터는 얼마나 최신 상태인가요?
  • 권장 폴링 빈도는 어떻게 되나요?
  • 코드 실행 사용량은 어떻게 추적하나요?
  • Priority Tier 사용량은 어떻게 추적하나요?
  • Workbench 사용량은 어떻게 처리되나요?
  • 기본 워크스페이스는 어떻게 표시되나요?
  • Claude Code의 사용자별 비용 분석은 어떻게 얻나요?
  • 참고 자료
Datadog

자동 추적 및 모니터링 기능을 갖춘 LLM 옵저버빌리티

Grafana Cloud

즉시 사용 가능한 대시보드 및 알림으로 간편한 LLM 옵저버빌리티를 제공하는 에이전트리스 통합

Honeycomb

OpenTelemetry를 통한 고급 쿼리 및 시각화

Vantage

LLM 비용 및 사용량 옵저버빌리티를 위한 FinOps 플랫폼