Anthropic
Admin API Anthropic описывает потребление Claude API на уровне организации двумя отчётами. Usage Report считает токены в разбивке по кэшу промптов: uncached input, cache write (5-минутный и часовой кэш) и cache read. Cost Report показывает ежедневные затраты по статьям расходов в центах США.
Renta синхронизирует оба отчёта в хранилище данных в виде статистики по временным бакетам с разбивкой по воркспейсам, API-ключам, моделям, уровням сервиса и контекстным окнам.
Аутентификация
Renta аутентифицируется организационным ключом Admin API key. Создайте его в Anthropic Console в разделе Settings > Admin keys: ключ начинается с sk-ant-admin. Обычные API-ключи не подойдут: отчётные эндпоинты Admin API их отклоняют.
Подключение источника Anthropic
- Перейдите в раздел Connections > Catalog в левом меню.
- Откройте категорию AI и нажмите на карточку Anthropic.
Заполните форму подключения:
- Source name.
Укажите название источника данных. Оно используется только в интерфейсе Renta. - Admin API key.
Вставьте ваш Admin API key Anthropic (начинается сsk-ant-admin).
Нажмите Save, чтобы завершить.
Новый источник появится в списке Sources со статусом Active. Теперь его можно использовать в пайплайнах.
Создание пайплайна Anthropic
После подключения источника свяжите его с назначением и настройте пайплайн.
В левом меню нажмите New pipeline. На шаге Source выберите Anthropic в списке Already connected и нажмите Next step.
Выберите созданное ранее подключение Anthropic и нажмите Next step.
На шаге Destination выберите ваше назначение (например, Google BigQuery) и нажмите Next step.
Выберите подключение назначения, в которое нужно загружать данные, и нажмите Next step.
Настройка пайплайна
На последнем шаге выберите, какой отчёт Anthropic выгружать и как Renta будет его загружать.
Тип отчёта и гранулярность
Выберите отчёт и размер его временных бакетов.
-
Report Types Выберите один из двух отчётов. Каждый пайплайн выгружает один отчёт в одну таблицу назначения.
Тип отчёта Данные Usage Report Количество токенов по запросам к Claude API: некэшированн ые входные токены, запись в кэш промптов (5-минутный и часовой), чтение из кэша, выходные токены, а также количество серверных запросов веб-поиска. Cost Report Ежедневные затраты в центах США по статьям расходов с привязкой к воркспейсу, модели, типу токенов и типу затрат. -
Granularity Выберите размер временного бакета: Minute, Hour или Day. Каждая строка таблицы назначения соответствует одному бакету для одной комбинации значений измерений. Для
Cost Reportдоступен только вариант Day: эндпоинт затрат Anthropic поддерживает только дневные бакеты.
Параметры
Выберите поля, которые попадут в таблицу назначения. Доступный набор зависит от типа отчёта: каждый отчёт сочетает колонки измерений, собственные метрики и поля временного бакета.
| Название | Имя в API | Описание |
|---|---|---|
API Key ID text | api_key_id | Identifier of the API key that generated the usage. Null for usage from the Workbench. |
Workspace ID text | workspace_id | Identifier of the workspace. Null for the default workspace. |
Account ID text | account_id | Identifier of the account associated with the usage. Null when not attributable to a specific account. |
Service Account ID text | service_account_id | Identifier of the service account associated with the usage. Null when not applicable. |
Model text | model | Claude model that produced the usage. For example: claude-sonnet-4-5-20250929. |
Service Tier text | service_tier | Service tier of the requests. For example: standard, batch, priority. |
Context Window text | context_window | Context window bucket of the requests. For example: 0-200k, 200k-1m. |
Inference Geo text | inference_geo | Geographic region where inference was performed. Null when not available. |
Uncached Input Tokens int | uncached_input_tokens | Number of input tokens that were not read from or written to the cache. |
Cache Creation Ephemeral 5m Input Tokens int | cache_creation_ephemeral_5m_input_tokens | Number of input tokens written to the 5-minute ephemeral prompt cache. |
Cache Creation Ephemeral 1h Input Tokens int | cache_creation_ephemeral_1h_input_tokens | Number of input tokens written to the 1-hour ephemeral prompt cache. |
Cache Read Input Tokens int | cache_read_input_tokens | Number of input tokens read from the prompt cache. |
Output Tokens int | output_tokens | Number of output tokens generated. |
Web Search Requests int | server_tool_use_web_search_requests | Number of server-side web search tool requests. |
Bucket Starting At datetime | bucket_starting_at | Start of the time bucket (UTC, RFC 3339). Bucket size depends on the selected granularity: 1 minute, 1 hour or 1 day. |
Bucket Ending At datetime | bucket_ending_at | End of the time bucket (UTC, RFC 3339, exclusive). |
Bucket Starting Date · Обязательный date | bucket_starting_date | Day-granularity partition key derived from bucket_starting_at. Required — destination tables partition by this column. |
| Название | Имя в API | Описание |
|---|---|---|
Workspace ID text | workspace_id | Identifier of the workspace the cost belongs to. Null for the default workspace. |
Description text | description | Human-readable description of the cost line item. For example: Claude Sonnet 4.5 Usage - Input Tokens. |
Cost Type text | cost_type | Type of the cost line item. For example: tokens, web_search, code_execution. |
Model text | model | Claude model the cost is attributed to. Null for non-token costs. For example: claude-sonnet-4-5-20250929. |
Token Type text | token_type | Token type the cost is attributed to. For example: uncached_input_tokens, output_tokens, cache_read_input_tokens. |
Context Window text | context_window | Context window bucket of the priced requests. For example: 0-200k, 200k-1m. |
Service Tier text | service_tier | Service tier of the priced requests. For example: standard, batch, priority. |
Inference Geo text | inference_geo | Geographic region where inference was performed. May be not_available. |
Amount text | amount | Cost amount in USD cents as a decimal string. For example: 17.0289 means $0.170289. |
Currency text | currency | Currency of the amount. Always USD. |
Bucket Starting At datetime | bucket_starting_at | Start of the daily time bucket (UTC, RFC 3339). |
Bucket Ending At datetime | bucket_ending_at | End of the daily time bucket (UTC, RFC 3339, exclusive). |
Bucket Starting Date · Обязательный date | bucket_starting_date | Day-granularity partition key derived from bucket_starting_at. Required — destination tables partition by this column. |
Отметьте поля в списке или нажмите Select All. В таблице назначения колонки называются API-именами, указанными под каждым полем: Workspace ID превращается в workspace_id.
В каждом отчёте есть также три временных поля: Bucket Starting At и Bucket Ending At (границы бакета в UTC) и Bucket Starting Date, дата с точностью до дня, по которой партиционируется таблица назначения. Поле Bucket Starting Date отмечено заранее, убрать его нельзя.
Имя таблицы и диапазон дат
Назовите пайплайн и задайте исторический период загрузки.
- Integration name.
Название пайплайна. Используется только в интерфейсе Renta. - Table name.
Имя таблицы назначения. Можно оставить сгенерированное имя или указать своё.
- Date start.
Первая дата периода выгрузки. - Date end.
Последняя дата периода выгрузки. Оставьте значение Today, чтобы продолжать собирать новые данные при каждом запуске.
Период перезаписи
Период перезаписи определяет, сколько последних дней Renta перезагружает при каждом запуске.
При каждом запуске Renta заново запрашивает отчёт начиная с даты последнего успешного запуска минус период перезаписи. Затронутые дни удаляются из таблицы назначения и вставляются заново, более старые данные не меняются. Значение по умолчанию: Last 1 day.
Расписание
Выберите, как часто запускается пайпл айн.
| Тип расписания | Описание |
|---|---|
| Manual | Пайплайн запускается только вручную через интерфейс или по API. |
| Daily | Пайплайн запускается раз в день в указанное время обновления. |
| Interval | Пайплайн запускается через заданные интервалы времени. |
| Cron Expression | Пайплайн запускается по расписанию, заданному cron-выражением. |
Для расписания Daily укажите Update time (точное время запуска), затем нажмите Create pipeline.
Новый пайплайн появится в разделе Pipelines на вкладке ETL, где можно отслеживать запуски, прогресс и имя таблицы назначения.
Стратегия синхронизации
Оба отчёта Anthropic представляют собой статистику по временным бакетам, поэтому у них одна стратегия синхронизации.
| Стратегия | Поддерживаемые типы отчётов | Описание |
|---|---|---|
| Инкрементальное обновление | Usage Report, Cost Report | Каждая таблица назначения партиционируется по колонке bucket_starting_date. При каждом запуске Renta перезагружает окно от последнего успешного запуска минус период перезаписи до конца диапазона дат: эти дневные партиции удаляются и вставляются заново, более старые партиции не меняются. |
Ready to get started?
Build your data pipeline today or get a personalized demo. Start free!
Need help?
Get expert support to ensure your project succeeds. We're here to help!
Feature requests?
Help shape our product! Share your ideas for new features and integrations.