Claude на Google Cloud

API для доступа к Claude на Agent Platform от Google Cloud практически идентичен 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",
    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
• Кэширование подсказок
• Мышление
• Использование инструментов, включая инструмент Bash, инструмент Computer use, инструмент Memory и инструмент Text editor
• Инструмент веб-поиска
• Цитирование
• Структурированные выходные данные



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

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



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

Claude Fable 5, Claude Opus 5, Claude Opus 4.8, Claude Opus 4.7, Claude Opus 4.6, Claude Sonnet 5 и Claude Sonnet 4.6 имеют контекстное окно в 1 млн токенов на Agent Platform. Другие модели Claude, включая Sonnet 4.5 и Sonnet 4 (устаревшая), имеют контекстное окно в 200 тыс. токенов.

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",
    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",
    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: Цены на облачных платформах