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

Элементы управления «data residency» (резидентность данных) позволяют вам управлять тем, где обрабатываются и хранятся ваши данные. За это отвечают две независимые настройки:

• Inference geo (география инференса): Управляет тем, где выполняется инференс модели, для каждого отдельного запроса. Задаётся через параметр API inference_geo или как значение по умолчанию для рабочего пространства.
• Workspace geo (география рабочего пространства): Управляет тем, где данные хранятся в состоянии покоя и где происходит обработка на конечных точках (например, транскодирование изображений и выполнение кода). Настраивается на уровне рабочего пространства в Claude Console.

География инференса

Параметр inference_geo управляет тем, где выполняется инференс модели для конкретного запроса API. Добавьте его в любой вызов POST /v1/messages.

Использование API

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    inference_geo="us",
    messages=[
        {"role": "user", "content": "Summarize the key points of this document."}
    ],
)

for block in response.content:
    if block.type == "text":
        print(block.text)
# Проверьте, где фактически выполнялся инференс
print(f"Inference geo: {response.usage.inference_geo}")

Ответ

Объект usage в ответе включает поле inference_geo, указывающее, где был выполнен инференс:

{
  "usage": {
    "input_tokens": 25,
    "output_tokens": 150,
    "inference_geo": "us"
  }
}

Доступность моделей

Параметр inference_geo поддерживается моделями Claude 4.6 и более поздними. Запросы с inference_geo к Claude Opus 4.5, Claude Sonnet 4.5 (устаревшая), Claude Haiku 4.5 или более ранним моделям возвращают ошибку 400.

Ограничения на уровне рабочего пространства

Настройки рабочего пространства также позволяют ограничивать доступные географии инференса:

• allowed_inference_geos: Ограничивает, какие географии может использовать рабочее пространство. Если в запросе указан inference_geo, отсутствующий в этом списке, API возвращает ошибку.
• default_inference_geo: Задаёт резервную географию, когда inference_geo не указан в запросе. Отдельные запросы могут переопределить это значение, явно задав inference_geo.

Эти настройки можно задать через Console или Admin API в поле data_residency.

География рабочего пространства

География рабочего пространства задаётся при создании рабочего пространства и не может быть изменена впоследствии. В настоящее время "us" — единственная доступная география рабочего пространства.

Чтобы задать географию рабочего пространства, создайте новое рабочее пространство в Console:

1. В Console перейдите на страницу Workspaces (platform.claude.com/settings/workspaces).
2. Нажмите Create workspace, чтобы открыть страницу Create workspace (platform.claude.com/settings/workspaces/new) в Console.
3. Введите имя, подтвердите значение в поле Workspace geo и нажмите Create workspace.

Цены

Цены на резидентность данных зависят от поколения модели:

• Модели Claude 4.6 и более поздние: Инференс только в США (inference_geo: "us") тарифицируется по ставке 1,1x от стандартной во всех категориях цен на токены (входные токены, выходные токены, запись в кэш и чтение из кэша). Для Claude Haiku 5.5 множитель также применяется к повышенным ценам для подсказок длиной более 100 000 токенов (см. Цены на длинный контекст).
• Глобальная маршрутизация (inference_geo: "global"): Применяются стандартные цены.
• Более старые модели: Не поддерживают inference_geo (см. Доступность моделей); применяются стандартные цены. Запросы, включающие этот параметр, возвращают ошибку 400.

Эти цены применяются к Claude API (напрямую от Anthropic) и Claude Platform on AWS. В Claude в Microsoft Foundry тот же коэффициент 1,1x применяется к развёртываниям, размещённым в Azure и использующим тип развёртывания US Data Zone Standard. Платформы, управляемые партнёрами (Bedrock и Google Cloud), имеют собственные региональные цены. Подробности см. в разделе Цены на резидентность данных.

Тот же коэффициент применяется к Claude Managed Agents: когда конфигурация модели агента закрепляет inference_geo на значении "us", запросы к модели в сессиях, в которых работает этот агент, тарифицируются с коэффициентом 1,1x от стандартной ставки.

Поддержка Batch API

Параметр inference_geo поддерживается в Batch API. Каждый запрос в пакете может указывать собственное значение inference_geo.

Миграция с устаревших отказов

Если ваша организация ранее отказалась от глобальной маршрутизации, чтобы удерживать инференс в США, ваше рабочее пространство было автоматически настроено с allowed_inference_geos: ["us"] и default_inference_geo: "us". Изменения в коде не требуются. Ваши существующие требования к резидентности данных продолжают соблюдаться с помощью новых географических элементов управления.

Что изменилось

Устаревший отказ был настройкой на уровне организации, которая ограничивала все запросы инфраструктурой, расположенной в США. Новые элементы управления резидентностью данных заменяют её двумя механизмами:

• Управление на уровне запроса: Параметр inference_geo позволяет указывать "us" или "global" в каждом вызове API, обеспечивая гибкость на уровне запроса.
• Управление на уровне рабочего пространства: Настройки default_inference_geo и allowed_inference_geos в Console позволяют применять географические политики ко всем ключам в рабочем пространстве.

Что произошло с вашим рабочим пространством

Ваше рабочее пространство было перенесено автоматически:

Все запросы API, использующие ключи из вашего рабочего пространства, продолжают выполняться на инфраструктуре, расположенной в США. Для сохранения текущего поведения никаких действий не требуется.

Если вы хотите использовать глобальную маршрутизацию

Если ваши требования к резидентности данных изменились и вы хотите воспользоваться глобальной маршрутизацией для повышения производительности и доступности, обновите настройки географии инференса вашего рабочего пространства, включив "global" в список разрешённых географий и установив default_inference_geo в значение "global". Подробности см. в разделе Ограничения на уровне рабочего пространства.

Влияние на цены

Устаревшие модели не затронуты этой миграцией. Актуальные цены на более новые модели см. в разделе Цены.

Текущие ограничения

• Общие ограничения скорости: Ограничения скорости являются общими для всех географий.
• География инференса: Доступны только "us" и "global".
• География рабочего пространства: В настоящее время доступна только "us". Географию рабочего пространства нельзя изменить после его создания.

Следующие шаги