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

Настройки резидентности данных позволяют управлять тем, где обрабатываются и хранятся ваши данные. За это отвечают два независимых параметра:

• 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",
    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.



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

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

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

1. Перейдите в Settings > Workspaces.
2. Создайте новое рабочее пространство.
3. Выберите географию рабочего пространства.



Цены

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

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

Эти цены применяются к Claude API (собственному) и Claude Platform на 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". Workspace geo нельзя изменить после создания рабочего пространства.



Дальнейшие шаги