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

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

• 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-4-8",
    max_tokens=1024,
    inference_geo="us",
    messages=[
        {"role": "user", "content": "Summarize the key points of this document."}
    ],
)

print(response.content[0].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 Opus 4.6, Claude Sonnet 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, создайте новое рабочее пространство в Console:

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

Цены

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

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

Эти цены применяются к Claude API (собственному) и Claude Platform on AWS. Платформы, управляемые партнёрами (Bedrock и Vertex AI), имеют собственные региональные цены. Подробнее см. в разделе Цены на резидентность данных.

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

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