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

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

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



Inference geo

Параметр 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

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

Чтобы установить workspace geo, создайте новое рабочее пространство в Console:

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



Ценообразование

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

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

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



Поддержка 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". См. Ограничения на уровне рабочего пространства для подробностей.



Влияние на ценообразование

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



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

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



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