Claude на Google Cloud

API для доступа к Claude на Google Cloud's Agent Platform практически идентичен Messages API, с двумя ключевыми отличиями в формате запроса:

• На Agent Platform параметр model не передаётся в теле запроса. Вместо этого он указывается в URL конечной точки Google Cloud.
• На Agent Platform параметр anthropic_version передаётся в теле запроса (а не в виде заголовка) и должен иметь значение vertex-2023-10-16.

Agent Platform также поддерживается официальными клиентскими SDK от Anthropic. Это руководство проведёт вас через процесс выполнения запроса к Claude на Agent Platform с использованием одного из клиентских SDK от Anthropic.

Обратите внимание, что это руководство предполагает, что у вас уже есть проект Google Cloud, в котором можно использовать Agent Platform. См. Модели Anthropic Claude на Agent Platform для получения дополнительной информации о необходимой настройке и полного пошагового руководства.

Установка SDK для доступа к Agent Platform

Сначала установите клиентский SDK от Anthropic для выбранного вами языка.

pip install -U "anthropic[vertex]"

Доступ к Agent Platform

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

Обратите внимание, что доступность моделей Anthropic различается в зависимости от региона. Выполните поиск «Claude» в Model Garden или перейдите на страницу Модели Anthropic Claude для получения актуальной информации.

Идентификаторы моделей API

Термины жизненного цикла (Deprecated — устаревшая, Retired — выведенная из эксплуатации) определены в разделе Устаревание моделей. Даты жизненного цикла на платформах, управляемых партнёрами, устанавливаются партнёром и могут отличаться от графика Claude API. Актуальную дату вывода из эксплуатации любой модели на Agent Platform см. в документации Google Cloud по моделям Claude на Agent Platform.

Выполнение запросов

Перед выполнением запросов вам может потребоваться выполнить команду gcloud auth application-default login для аутентификации в Google Cloud.

В следующих примерах показано, как генерировать текст с помощью Claude на Agent Platform:

from anthropic import AnthropicVertex

project_id = "MY_PROJECT_ID"
region = "global"

client = AnthropicVertex(project_id=project_id, region=region)

message = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)

Подробнее см. в документации по клиентским SDK и в официальной документации Agent Platform.

Claude также доступен через Amazon Bedrock, Claude Platform на AWS и Microsoft Foundry.

Хранение данных

Обработка данных для этого предложения регулируется Google Cloud. Подробнее см. в разделе Agent Platform и нулевое хранение данных.

Журналирование активности

Agent Platform предоставляет сервис журналирования запросов и ответов, который позволяет вам записывать подсказки и ответы, связанные с вашим использованием.

Anthropic рекомендует журналировать вашу активность как минимум на скользящей 30-дневной основе, чтобы понимать свою активность и расследовать любые потенциальные злоупотребления.

Поддержка функций

Полный список функций с указанием доступности в Google Cloud см. в разделе Обзор функций.

Основные поддерживаемые функции

• Messages API
• Кэширование подсказок (prompt caching)
• Размышления
• Использование инструментов (tool use), включая инструмент Bash, инструмент использования браузера, инструмент использования компьютера, инструмент памяти и инструмент текстового редактора
• Инструмент веб-поиска
• Цитирование
• Структурированные выходные данные

Неподдерживаемые функции

• Источники входных данных (URL-источники для изображений и документов, Files API)
• Серверные инструменты (выполнение кода, веб-загрузка, советник)
• Инфраструктура агентов (Agent Skills, коннектор MCP, программный вызов инструментов)
• Конечные точки API (Message Batches, Models, Admin, Compliance, Usage and Cost)
• Claude Managed Agents
• Серверный резервный механизм (параметр fallbacks; вместо него используйте шаблон резервного механизма на стороне клиента)

Контекстное окно

Claude Fable 5.1, Claude Fable 5, Claude Opus 5.5, Claude Opus 5, Claude Opus 4.8, Claude Opus 4.7, Claude Opus 4.6, Claude Sonnet 5.5, Claude Sonnet 5 и Claude Sonnet 4.6 имеют в Agent Platform «context window» (контекстное окно) размером 1M токенов. Другие модели Claude, включая Sonnet 4.5 и Sonnet 4 (устаревшая), имеют контекстное окно размером 200k токенов.

Agent Platform ограничивает размер полезной нагрузки запроса до 30 МБ. При отправке больших документов или множества изображений вы можете достичь этого ограничения раньше, чем ограничения по токенам.

Глобальные, мультирегиональные и региональные конечные точки

Agent Platform предлагает три типа конечных точек:

• Глобальные конечные точки: динамическая маршрутизация для максимальной доступности
• Мультирегиональные конечные точки: динамическая маршрутизация в пределах географической зоны (например, США или Европейского союза) для обеспечения резидентности данных при высокой доступности
• Региональные конечные точки: гарантированная маршрутизация данных через определённые географические регионы

Региональные и мультирегиональные конечные точки включают ценовую надбавку в 10% по сравнению с глобальными конечными точками.

Когда использовать каждый вариант

Глобальные конечные точки (рекомендуется):

• Обеспечивают максимальную доступность и время безотказной работы
• Динамически направляют запросы в регионы с доступной мощностью
• Без ценовой надбавки
• Лучше всего подходят для приложений с гибкими требованиями к резидентности данных
• Поддерживают только трафик с оплатой по мере использования (выделенная пропускная способность требует региональных конечных точек)

Мультирегиональные конечные точки:

• Динамически направляют запросы между регионами в пределах географической зоны (в настоящее время us и eu)
• Полезны, когда вам нужна резидентность данных в пределах широкой географии, но требуется более высокая доступность, чем у одного региона
• Ценовая надбавка в 10% по сравнению с глобальными конечными точками
• Поддерживают только трафик с оплатой по мере использования (выделенная пропускная способность требует региональных конечных точек)

Региональные конечные точки:

• Направляют трафик через определённые географические регионы
• Необходимы для резидентности данных в одном регионе, строгих требований соответствия или выделенной пропускной способности
• Поддерживают как оплату по мере использования, так и выделенную пропускную способность
• Ценовая надбавка в 10% отражает затраты на инфраструктуру для выделенной региональной мощности

Реализация

Использование глобальных конечных точек (рекомендуется):

При инициализации клиента установите для параметра region значение "global":

from anthropic import AnthropicVertex

project_id = "MY_PROJECT_ID"
region = "global"

client = AnthropicVertex(project_id=project_id, region=region)

message = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)

Использование мультирегиональных конечных точек:

Установите для параметра region мультирегиональный идентификатор: "us" для США или "eu" для Европейского союза. SDK направляет запросы на соответствующую мультирегиональную конечную точку (https://aiplatform.us.rep.googleapis.com или https://aiplatform.eu.rep.googleapis.com), которая динамически распределяет трафик между регионами в пределах этой географической области.

from anthropic import AnthropicVertex

project_id = "MY_PROJECT_ID"
region = "us"  # Multi-region identifier: "us" or "eu"

client = AnthropicVertex(project_id=project_id, region=region)

message = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)

Использование региональных конечных точек:

Укажите конкретный регион, например "us-east5" или "europe-west1":

from anthropic import AnthropicVertex

project_id = "MY_PROJECT_ID"
region = "us-east5"  # Specify a specific region

client = AnthropicVertex(project_id=project_id, region=region)

message = client.messages.create(
    # Отдельные региональные конечные точки поддерживают Claude Sonnet 4.6 и более ранние модели; новые модели используют глобальные или мультирегиональные конечные точки
    model="claude-sonnet-4-6",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)

Дополнительные ресурсы

• Цены Agent Platform: Цены на генеративный ИИ на cloud.google.com
• Документация по моделям Claude: Claude на Agent Platform
• Публикация в блоге Google: Глобальная конечная точка для моделей Claude
• Подробности о ценах Anthropic: Цены на облачных платформах