---
title: API использования и стоимости
url: https://platform.claude.com/docs/ru/manage-claude/usage-cost-api
description: Программный доступ к данным об использовании API и затратах вашей организации с помощью Usage and Cost Admin API.
---

<Tip>
  **Admin API недоступен для индивидуальных учётных записей.** Чтобы сотрудничать с коллегами и добавлять участников, настройте свою организацию на странице [Organization](https://platform.claude.com/settings/organization) (`platform.claude.com/settings/organization`) в Claude Console.
</Tip>

Usage and Cost Admin API предоставляет программный и детализированный доступ к историческим данным об использовании API и затратах вашей организации. Эти данные аналогичны информации, доступной на странице [Usage](https://platform.claude.com/usage) (`platform.claude.com/usage`) и странице [Cost](https://platform.claude.com/cost) (`platform.claude.com/cost`) в Claude Console.

Этот API позволяет вам лучше отслеживать, анализировать и оптимизировать ваши реализации на базе Claude:

* **Точное отслеживание использования:** получайте точные подсчёты токенов и шаблоны использования вместо того, чтобы полагаться исключительно на подсчёт токенов в ответах
* **Сверка затрат:** сопоставляйте внутренние записи со счетами Anthropic для финансовых и бухгалтерских команд
* **Производительность и улучшение продукта:** отслеживайте производительность продукта, измеряя, улучшили ли его изменения в системе, или настраивайте оповещения
* **Оптимизация [ограничений скорости](https://platform.claude.com/docs/ru/api/rate-limits):** оптимизируйте такие функции, как «prompt caching» ([кэширование подсказок](https://platform.claude.com/docs/ru/build-with-claude/prompt-caching)), или конкретные подсказки, чтобы максимально эффективно использовать выделенную вам ёмкость.
* **Расширенный анализ:** выполняйте более глубокий анализ данных, чем доступен в Console

<Check>
  **Требуются учётные данные Admin API.** Эти конечные точки являются частью Admin API. Вы можете получить к ним доступ, используя [ключ Admin API](https://platform.claude.com/docs/ru/manage-claude/admin-api-keys), токен OAuth с областью действия `org:admin` либо ключ личной или сервисной учётной записи, не ограниченный рабочим пространством; ключи API рабочего пространства не подходят. Подробности см. в разделе [Аутентификация](https://platform.claude.com/docs/ru/manage-claude/admin-api#authentication).
</Check>

Организации Claude Enterprise вместо этого используют ключ Analytics API с другим API; см. раздел [Какой API вам нужен?](https://platform.claude.com/docs/ru/manage-claude/usage-cost-api#which-api-do-you-need).

<Note>
  **Claude Platform на AWS:** программные конечные точки Usage and Cost API в настоящее время недоступны. Вместо этого просматривайте данные об использовании и стоимости на страницах **Usage** и **Cost** в Claude Console.
</Note>

## Какой API вам нужен?

Anthropic предоставляет отчётность о стоимости и использовании через два API, в зависимости от того, каким продуктом Claude управляет ваша организация:

| Ваша организация                 | API                                                                                                                                            | Тип ключа                                                                                                                                               |
| -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Claude Console (Claude Platform) | Usage and Cost Admin API, описанный на этой странице                                                                                           | Ключ Admin API (`sk-ant-admin01-...`) или другие [учётные данные Admin API](https://platform.claude.com/docs/ru/manage-claude/admin-api#authentication) |
| Claude Enterprise (claude.ai)    | [Claude Enterprise Analytics API](https://platform.claude.com/docs/ru/api/beta/organization/analytics) (конечные точки затрат и использования) | Ключ Analytics API                                                                                                                                      |

Родительские организации Claude Enterprise не отображаются в Claude Console и не имеют ключей Admin API, поэтому для них ключ Analytics API — единственный путь к этим данным. См. [Analytics APIs](https://platform.claude.com/docs/ru/manage-claude/analytics-api), чтобы узнать, как создать каждый тип ключа и к каким планам применяются данные о стоимости Claude Enterprise.

## Партнёрские решения

Ведущие платформы наблюдаемости предлагают готовые к использованию интеграции для мониторинга использования и стоимости Claude API без написания собственного кода. Эти интеграции предоставляют панели мониторинга, оповещения и аналитику, помогающие эффективно управлять использованием API.

<CardGroup cols={3}>
  <Card title="CloudZero" icon="chart" href="https://docs.cloudzero.com/docs/connections-anthropic">
    Платформа облачной аналитики для отслеживания и прогнозирования затрат
  </Card>

  <Card title="Datadog" icon="chart" href="https://docs.datadoghq.com/integrations/anthropic/">
    Наблюдаемость LLM с автоматической трассировкой и мониторингом
  </Card>

  <Card title="Grafana Cloud" icon="chart" href="https://grafana.com/docs/grafana-cloud/monitor-infrastructure/integrations/integration-reference/integration-anthropic/">
    Безагентная интеграция для простой наблюдаемости LLM с готовыми панелями мониторинга и оповещениями
  </Card>

  <Card title="Harness" icon="chart" href="https://developer.harness.io/docs/cloud-cost-management/provider-integrations/ai-providers/anthropic/">
    FinOps-платформа для управления затратами на облако и ИИ
  </Card>

  <Card title="Honeycomb" icon="polygon" href="https://docs.honeycomb.io/integrations/anthropic-usage-monitoring/">
    Расширенные запросы и визуализация через OpenTelemetry
  </Card>

  <Card title="Tempo" icon="chart" href="https://help.tempo.io/workforceintelligence/latest/connect-to-anthropic">
    Распределение использования и затрат по рабочим элементам Jira
  </Card>

  <Card title="Vantage" icon="chart" href="https://docs.vantage.sh/connecting_anthropic">
    FinOps-платформа для наблюдаемости затрат и использования LLM
  </Card>
</CardGroup>

## Быстрый старт

Получите ежедневное использование вашей организации за последние 7 дней:

```bash 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" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"
```

<Tip>
  **Установите заголовок User-Agent для интеграций**

  Если вы создаёте интеграцию, установите заголовок User-Agent, чтобы помочь Anthropic понять шаблоны использования:

  ```text wrap
  User-Agent: YourApp/1.0.0 (https://yourapp.com)
  ```
</Tip>

## Usage API

Отслеживайте потребление токенов в вашей организации с подробной разбивкой по модели, рабочему пространству и уровню обслуживания с помощью конечной точки `/v1/organizations/usage_report/messages`.

### Ключевые понятия

* **Временные интервалы (time buckets):** агрегируйте данные об использовании в фиксированных интервалах (`1m`, `1h` или `1d`)
* **Отслеживание токенов:** измеряйте некэшированные входные токены, кэшированные входные токены, токены создания кэша и выходные токены
* **Фильтрация и группировка:** фильтруйте по ключу API, рабочему пространству, модели, уровню обслуживания, «context window» (контекстному окну), [резидентности данных](https://platform.claude.com/docs/ru/manage-claude/data-residency) или скорости и группируйте результаты по этим измерениям
* **Использование серверных инструментов:** отслеживайте использование серверных инструментов, таких как веб-поиск

Полные сведения о параметрах и схемах ответов см. в [справочнике Usage API](https://platform.claude.com/docs/ru/api/beta/organization/usage_report/retrieve_messages).

### Базовые примеры

#### Ежедневное использование по модели

```bash 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" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"
```

#### Почасовое использование с фильтрацией

```bash 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-5-5&\
service_tiers[]=batch&\
context_window[]=0-200k&\
bucket_width=1h" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"
```

#### Фильтрация использования по ключам API и рабочим пространствам

```bash 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" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"
```

<Tip>
  Чтобы получить идентификаторы ключей API вашей организации, используйте конечную точку [List API Keys](https://platform.claude.com/docs/ru/api/organization/api_keys/list).

  Чтобы получить идентификаторы рабочих пространств вашей организации, используйте конечную точку [List Workspaces](https://platform.claude.com/docs/ru/api/organization/workspaces/list) или найдите идентификаторы рабочих пространств вашей организации в Claude Console.
</Tip>

#### Резидентность данных

Отслеживайте ваши [средства управления резидентностью данных](https://platform.claude.com/docs/ru/manage-claude/data-residency), группируя и фильтруя использование по измерению `inference_geo`. Это полезно для проверки географической маршрутизации в вашей организации.

```bash 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" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"
```

Вы также можете отфильтровать по конкретному географическому региону. Допустимые значения: `global`, `us` и `not_available`:

```bash 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" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"
```

<Note>
  Модели, выпущенные до февраля 2026 года (до Claude Opus 4.6 и Claude Sonnet 4.6), не поддерживают параметр запроса `inference_geo`, поэтому их отчёты об использовании возвращают `"not_available"` для этого измерения. Вы можете использовать `not_available` в качестве значения фильтра в `inference_geos[]`, чтобы выбрать эти модели.
</Note>

#### Быстрый режим

Отслеживайте использование [быстрого режима](https://platform.claude.com/docs/ru/build-with-claude/fast-mode), группируя и фильтруя по измерению `speed`. Это полезно для мониторинга использования стандартного режима по сравнению с быстрым.

```bash 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" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"
```

Вы также можете отфильтровать по конкретной скорости. Допустимые значения: `standard` и `fast`:

```bash 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" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"
```

### Ограничения временной гранулярности

| Гранулярность | Лимит по умолчанию | Максимальный лимит | Сценарий использования          |
| ------------- | ------------------ | ------------------ | ------------------------------- |
| `1m`          | 60 интервалов      | 1 440 интервалов   | Мониторинг в реальном времени   |
| `1h`          | 24 интервала       | 168 интервалов     | Ежедневные шаблоны              |
| `1d`          | 7 интервалов       | 31 интервал        | Еженедельные/ежемесячные отчёты |

## Cost API

Получайте разбивку стоимости на уровне сервисов в долларах США с помощью конечной точки `/v1/organizations/cost_report`.

### Ключевые понятия

* **Валюта:** все затраты в долларах США, представленные в виде десятичных строк в наименьших единицах (центах)
* **Типы затрат:** отслеживайте затраты на использование токенов, веб-поиск и выполнение кода
* **Группировка:** группируйте затраты по рабочему пространству или описанию для подробной разбивки. При группировке по `description` ответы включают разобранные поля, такие как `model` и `inference_geo`
* **Временные интервалы:** только ежедневная гранулярность (`1d`)

Полные сведения о параметрах и схемах ответов см. в [справочнике Cost API](https://platform.claude.com/docs/ru/api/beta/organization/cost_report/retrieve).

<Warning>
  Затраты Priority Tier используют другую модель выставления счетов и не включены в конечную точку стоимости. Вместо этого отслеживайте использование Priority Tier через конечную точку использования.
</Warning>

### Базовый пример

```bash 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" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"
```

## Пагинация

Обе конечные точки поддерживают пагинацию для больших наборов данных:

1. Выполните начальный запрос.
2. Если `has_more` равно `true`, используйте значение `next_page` в следующем запросе.
3. Продолжайте, пока `has_more` не станет `false`.

```bash 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" \
  -H "anthropic-version: 2023-06-01" \
  -H "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..." \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"
```

## Распространённые сценарии использования

Изучите подробные реализации в [Claude Cookbook](https://platform.claude.com/cookbook):

* **Ежедневные отчёты об использовании:** отслеживайте тенденции потребления токенов
* **Атрибуция затрат:** распределяйте расходы по рабочим пространствам для внутренних взаиморасчётов
* **Эффективность кэша:** измеряйте и оптимизируйте кэширование подсказок
* **Мониторинг бюджета:** настраивайте оповещения о порогах расходов
* **Экспорт в CSV:** формируйте отчёты для финансовых команд

## Часто задаваемые вопросы

### Насколько свежи данные?

Данные об использовании и стоимости обычно появляются в течение 5 минут после завершения запроса к API, хотя иногда задержки могут быть дольше.

### Какова рекомендуемая частота опроса?

API поддерживает опрос один раз в минуту при постоянном использовании. Для коротких всплесков (например, при загрузке данных с пагинацией) допустим более частый опрос. Кэшируйте результаты для панелей мониторинга, требующих частых обновлений.

### Как отслеживать использование выполнения кода?

Затраты на выполнение кода отображаются в конечной точке стоимости, сгруппированные под `Code Execution Usage` в поле описания. Выполнение кода не включено в конечную точку использования.

### Как отслеживать использование Priority Tier?

Фильтруйте или группируйте по `service_tier` в конечной точке использования и ищите значение `priority`. Затраты Priority Tier недоступны в конечной точке стоимости.

### Что происходит с использованием playground?

Использование API из playground в Claude Console (а до него — из устаревшего Workbench) не связано с ключом API, поэтому `api_key_id` будет `null` даже при группировке по этому измерению.

### Как представлено рабочее пространство по умолчанию?

Использование и затраты, отнесённые к рабочему пространству по умолчанию, имеют значение `null` для `workspace_id`.

### Как получить разбивку затрат по пользователям для Claude Code?

Используйте [Claude Code Analytics API](https://platform.claude.com/docs/ru/manage-claude/claude-code-analytics-api), который предоставляет оценочные затраты и метрики продуктивности по каждому пользователю без ограничений производительности, связанных с разбивкой затрат по множеству ключей API. Для общего использования API с большим количеством ключей используйте [Usage API](https://platform.claude.com/docs/ru/manage-claude/usage-cost-api#usage-api), чтобы отслеживать потребление токенов как косвенный показатель стоимости.

## См. также

Используйте Usage and Cost API, чтобы обеспечить лучший опыт для ваших пользователей, управлять затратами и сохранять ваше ограничение скорости. Узнайте больше о некоторых других функциях:

* [Admin API](https://platform.claude.com/docs/ru/manage-claude/admin-api)
* [Справочник Admin API](https://platform.claude.com/docs/ru/api/beta/organization)
* [Analytics APIs](https://platform.claude.com/docs/ru/manage-claude/analytics-api) — какой аналитический API и тип ключа нужен вашей организации
* [Цены](https://platform.claude.com/docs/ru/about-claude/pricing)
* [Кэширование подсказок](https://platform.claude.com/docs/ru/build-with-claude/prompt-caching) — оптимизируйте затраты с помощью кэширования
* [Пакетная обработка](https://platform.claude.com/docs/ru/build-with-claude/batch-processing) — скидка 50% на пакетные запросы
* [Ограничения скорости](https://platform.claude.com/docs/ru/api/rate-limits) — разберитесь в уровнях использования
* [Rate Limits API](https://platform.claude.com/docs/ru/manage-claude/rate-limits-api) — просматривайте настроенные ограничения скорости
* [Резидентность данных](https://platform.claude.com/docs/ru/manage-claude/data-residency) — управляйте географией инференса