The Admin API is unavailable for individual accounts. To collaborate with teammates and add members, set up your organization in Console → Settings → Organization.
Usage & Cost Admin API는 조직의 과거 API 사용량 및 비용 데이터에 대한 프로그래밍 방식의 세분화된 액세스를 제공합니다. 이 데이터는 Claude Console의 사용량 및 비용 페이지에서 사용 가능한 정보와 유사합니다.
이 API를 통해 Claude 구현을 더 잘 모니터링, 분석 및 최적화할 수 있습니다:
Admin API 키 필수
이 API는 Admin API의 일부입니다. 이 엔드포인트는 표준 API 키와 다른 Admin API 키(sk-ant-admin...로 시작)가 필요합니다. 관리자 역할을 가진 조직 구성원만 Claude Console을 통해 Admin API 키를 프로비저닝할 수 있습니다.
주요 관찰성 플랫폼은 사용자 정의 코드를 작성하지 않고도 Claude API 사용량 및 비용을 모니터링하기 위한 즉시 사용 가능한 통합을 제공합니다. 이러한 통합은 API 사용량을 효과적으로 관리하는 데 도움이 되는 대시보드, 경고 및 분석을 제공합니다.
비용 추적 및 예측을 위한 클라우드 인텔리전스 플랫폼
자동 추적 및 모니터링을 포함한 LLM 관찰성
기본 제공 대시보드 및 경고를 포함한 쉬운 LLM 관찰성을 위한 에이전트리스 통합
OpenTelemetry를 통한 고급 쿼리 및 시각화
LLM 비용 및 사용량 관찰성을 위한 FinOps 플랫폼
지난 7일간의 조직 일일 사용량 확보:
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: $ADMIN_API_KEY"통합을 위해 User-Agent 헤더 설정
통합을 구축하는 경우 User-Agent 헤더를 설정하여 사용 패턴을 이해하는 데 도움을 주세요:
User-Agent: YourApp/1.0.0 (https://yourapp.com)/v1/organizations/usage_report/messages 엔드포인트를 사용하여 모델, 워크스페이스 및 서비스 계층별 세부 분석을 통해 조직 전체의 토큰 소비를 추적합니다.
1m, 1h 또는 1d)으로 사용량 데이터 집계완전한 매개변수 세부 정보 및 응답 스키마는 사용량 API 참조를 참조하세요.
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: $ADMIN_API_KEY"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-7&\
service_tiers[]=batch&\
context_window[]=0-200k&\
bucket_width=1h" \
--header "anthropic-version: 2023-06-01" \
--header "x-api-key: $ADMIN_API_KEY"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: $ADMIN_API_KEY"inference_geo 차원으로 사용량을 그룹화하고 필터링하여 데이터 거주지 제어를 추적합니다. 이는 조직 전체의 지리적 라우팅을 확인하는 데 유용합니다.
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: $ADMIN_API_KEY"특정 지역으로 필터링할 수도 있습니다. 유효한 값은 global, us 및 not_available입니다:
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: $ADMIN_API_KEY"2026년 2월 이전에 출시된 모델(Claude Opus 4.6 이전)은 inference_geo 요청 매개변수를 지원하지 않으므로 사용량 보고서는 이 차원에 대해 "not_available"을 반환합니다. inference_geos[]의 필터 값으로 not_available을 사용하여 해당 모델을 대상으로 할 수 있습니다.
speed 차원으로 그룹화하고 필터링하여 빠른 모드 사용량을 추적합니다. 이는 표준 모드 대 빠른 모드 사용량을 모니터링하는 데 유용합니다.
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: $ADMIN_API_KEY"특정 속도로 필터링할 수도 있습니다. 유효한 값은 standard 및 fast입니다:
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: $ADMIN_API_KEY"speeds[] 필터와 speed group_by 값 모두 fast-mode-2026-02-01 베타 헤더가 필요합니다.
| 세분성 | 기본 제한 | 최대 제한 | 사용 사례 |
|---|---|---|---|
1m | 60 버킷 | 1440 버킷 | 실시간 모니터링 |
1h | 24 버킷 | 168 버킷 | 일일 패턴 |
1d | 7 버킷 | 31 버킷 | 주간/월간 보고서 |
/v1/organizations/cost_report 엔드포인트를 사용하여 USD의 서비스 수준 비용 분석을 검색합니다.
description으로 그룹화할 때 응답에는 model 및 inference_geo와 같은 구문 분석된 필드 포함1d)완전한 매개변수 세부 정보 및 응답 스키마는 비용 API 참조를 참조하세요.
우선순위 계층 비용은 다른 청구 모델을 사용하며 비용 엔드포인트에 포함되지 않습니다. 사용량 엔드포인트를 통해 우선순위 계층 사용량을 추적하세요.
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: $ADMIN_API_KEY"두 엔드포인트 모두 큰 데이터 세트에 대한 페이지 매김을 지원합니다:
has_more가 true이면 다음 요청에서 next_page 값 사용has_more가 false가 될 때까지 계속# 첫 번째 요청
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: $ADMIN_API_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: $ADMIN_API_KEY"Claude Cookbook에서 자세한 구현을 살펴보세요:
사용량 및 비용 데이터는 일반적으로 API 요청 완료 후 5분 이내에 나타나지만 지연이 더 길 수도 있습니다.
API는 지속적인 사용을 위해 분당 한 번 폴링을 지원합니다. 짧은 버스트(예: 페이지가 매겨진 데이터 다운로드)의 경우 더 자주 폴링하는 것이 허용됩니다. 자주 업데이트해야 하는 대시보드의 결과를 캐시하세요.
코드 실행 비용은 설명 필드의 Code Execution Usage 아래에 그룹화된 비용 엔드포인트에 나타납니다. 코드 실행은 사용량 엔드포인트에 포함되지 않습니다.
사용량 엔드포인트에서 service_tier로 필터링하거나 그룹화하고 priority 값을 찾으세요. 우선순위 계층 비용은 비용 엔드포인트에서 사용할 수 없습니다.
Workbench의 API 사용량은 API 키와 연결되지 않으므로 해당 차원으로 그룹화할 때에도 api_key_id는 null입니다.
기본 워크스페이스에 귀속된 사용량 및 비용은 workspace_id에 대해 null 값을 갖습니다.
Claude Code Analytics API를 사용하세요. 이는 많은 API 키로 비용을 분석할 때의 성능 제한 없이 사용자별 예상 비용 및 생산성 메트릭을 제공합니다. 많은 키를 사용한 일반 API 사용의 경우 사용량 API를 사용하여 토큰 소비를 비용 프록시로 추적하세요.
사용량 및 비용 API는 사용자에게 더 나은 경험을 제공하고, 비용을 관리하며, 속도 제한을 유지하는 데 도움이 될 수 있습니다. 이러한 다른 기능에 대해 자세히 알아보세요:
Was this page helpful?