Размещение данных

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

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

Inference geo

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

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

curl https://api.anthropic.com/v1/messages \
    --header "x-api-key: $ANTHROPIC_API_KEY" \
    --header "anthropic-version: 2023-06-01" \
    --header "content-type: application/json" \
    --data '{
        "model": "claude-opus-4-6",
        "max_tokens": 1024,
        "inference_geo": "us",
        "messages": [{
            "role": "user",
            "content": "Summarize the key points of this document."
        }]
    }'

Ответ

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

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

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

Параметр inference_geo поддерживается на Claude Opus 4.6 и всех последующих моделях. Более старые модели, выпущенные до Opus 4.6, не поддерживают этот параметр. Запросы с inference_geo к устаревшим моделям возвращают ошибку 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 и новее: Вывод только для США (inference_geo: "us") оценивается в 1,1x стандартной ставки по всем категориям ценообразования токенов (входные токены, выходные токены, записи кэша и чтение кэша).
• Глобальная маршрутизация (inference_geo: "global" или опущено): Применяется стандартное ценообразование.
• Более старые модели: Существующее ценообразование не изменяется независимо от параметров inference_geo.

Это ценообразование применяется только к Claude API (1P). Сторонние платформы (AWS Bedrock, Google Vertex AI, Microsoft Foundry) имеют собственное региональное ценообразование. Подробности см. на странице цен.

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

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