사용량

차원별 토큰 사용량 조회

UsageListPage Beta.Organization.Analytics.Usage.List(parameters, cancellationToken = default)

GET/v1/organizations/analytics/usage

Requires anthropic-beta: analytics-usage-cost-2026-08-24. How to send beta headers

날짜 범위에 걸친 토큰 사용량을 차원별로 나누어 조회합니다.

Models

class BetaAnalyticsUsageGroup { Actor; ActorType; AgentID; /* 16 more */ }

The dimension values one usage row is broken out by; each is null unless its dimension is in group_by[].

enum BetaAnalyticsUsageGroupBy

class BetaAnalyticsUsageItem { EndingAt; Group; StartingAt; Usage; }

class BetaAnalyticsUsageMetrics { CacheCreation; CacheReadInputTokens; OutputTokens; /* 4 more */ }

The token usage of one row.

required BetaCacheCreation CacheCreation

The number of input tokens for cache creation.

required long Ephemeral1hInputTokens

The number of input tokens used to create the 1 hour cache entry.

minimum0

required long Ephemeral5mInputTokens

The number of input tokens used to create the 5 minute cache entry.

minimum0

required long CacheReadInputTokens

The number of input tokens read from the cache.

required long OutputTokens

The number of output tokens generated.

required long? Requests

Number of API requests in this row's scope. For sandbox / code-execution events, this counts execution spans rather than HTTP requests (these rows surface with product: null).

required BetaAnalyticsServerToolUse ServerToolUse

Server-side tool usage metrics.

required long WebSearchRequests

The number of web search requests made.

required long TotalTokens

Total token count across all token types. This is the value the default order_by (total_tokens) sorts on.

required long UncachedInputTokens

The number of uncached input tokens processed.

enum BetaAnalyticsUsageOrderBy

OutputTokens("output_tokens")

Requests("requests")

Time("time")

TotalTokens("total_tokens")

UncachedInputTokens("uncached_input_tokens")