Skip to main content
Эта страница объясняет два рабочих пути для веб-поиска с моделями Claude на APIYI, подтвержденные практическим тестированием в июне 2026 года. Для каналов, тарификации и базовой настройки сначала см. Основы Claude API.

Кратко

Стандартная Claude-группа в APIYI направляет запросы к официальной AWS Claude (Amazon Bedrock), а сам AWS не поддерживает нативный веб-поиск Claude — это ограничение архитектуры Bedrock, а не проблема настройки шлюза. Чтобы получить доступ к вебу, у вас есть два варианта:
Распространенная ошибка: отправка запроса с инструментом web_search в группе по умолчанию не вызывает ошибку — шлюз корректно обрабатывает его, запрос возвращает HTTP 200, но поиск не выполняется; модель просто отвечает на основе своих обучающих данных. Не считайте «нет ошибки» признаком того, что поиск сработал. См. FAQ в конце, чтобы узнать, как это проверить.

Почему это не поддерживается в группе по умолчанию?

web_search / web_fetch Claude — это server-side tools: поиск выполняется собственной серверной инфраструктурой Anthropic. AWS Bedrock предоставляет только model inference и не имеет такого search backend, поэтому интерфейс Bedrock отклоняет эти tools на уровне валидации. В whitelist типов tool у Bedrock входят только client-side tools:
Аналогично, MCP Connector Anthropic (параметр mcp_servers) тоже является server-side функцией и не поддерживается в группе по умолчанию. APIYI предлагает бета-группу под названием ClaudeOfficial (прямой официальный канал Anthropic), которая поддерживает нативные инструменты Claude web_search / web_fetch.
  • Как включить: обратитесь в службу поддержки, чтобы ваш ключ был добавлен в группу ClaudeOfficial
  • Примечание о стабильности: это бета-группа, и она менее стабильна, чем группа по умолчанию — для важных нагрузок подготовьте запасной вариант (в качестве такого варианта хорошо подходит Option 2)

Пример запроса

Версии инструментов: Необязательные параметры: max_uses (ограничивает число поисков), allowed_domains / blocked_domains (фильтрация по домену).

Как проверить, что поиск действительно был выполнен

Успешный ответ содержит блоки server_tool_use и web_search_tool_result в content, с цитатами в тексте ответа и полем-счетчиком в usage:
Если в ответе есть только блоки text, а в usage нет server_tool_use, запрос не дошел до канала, поддерживающего поиск.

Тарификация

  • Названия инструментов: web_search, web_fetch
  • web_search: $10 / 1,000 searches ($0.01 за поиск, считается по usage.server_tool_use.web_search_requests — один ответ может вызвать несколько поисков) плюс обычная плата за token; неудачные поиски не тарифицируются
  • web_fetch: платы за вызов нет; полученный контент тарифицируется как входные token
  • Ориентировочная стоимость одного вопрос-ответа с web (sonnet): примерно $0.02–0.08

Вариант 2: Пользовательский инструмент поиска (работает в группе по умолчанию, рекомендуется для production)

Группа по умолчанию (Bedrock) полностью поддерживает стандартный вызов функций (пользовательские инструменты). Определите инструмент поиска, заставьте ваш клиент выполнять фактический поиск (через Search API, например Tavily / Brave / Serper / Bing), и передавайте результаты обратно модели. В ходе тестирования Claude активно вызывает инструмент, переписывает запросы как на китайском, так и на английском, и выдает ответы с источниками после нескольких раундов поиска.

Полный пример (Python)

Справка по стоимости

  • Комиссии за token модели: один вопрос-ответ с несколькими раундами поиска использует примерно 10k входных + 1–2k выходных token (около $0.05 на sonnet)
  • Комиссии за Search API: бесплатный уровень Tavily — 1,000 вызовов/месяц (платный — примерно $0.008 за вызов), Brave — $3 / 1,000 вызовов; это того же порядка, что и официальный web_search
  • Преимущества: не зависящие от канала, контролируемые и кэшируемые источники поиска, а также сохранение стабильности и преимуществ тарификации кэша у группы по умолчанию

Расширенно: источники поиска MCP

Если вы уже используете экосистему MCP (например, Tavily MCP, Brave MCP), подключитесь к MCP server на стороне клиента и преобразуйте его tools в пользовательские инструменты, показанные выше — принцип идентичен. Примечание: передача параметра mcp_servers напрямую в запросе (server-side MCP) недоступна для группы по умолчанию.

FAQ

Q: Я отправил инструмент web_search в группу по умолчанию и не получил ошибки — значит, он поддерживается? A: Нет. Группа по умолчанию корректно обрабатывает серверные инструменты (игнорирует их); запрос возвращает 200, но поиск не выполняется. Чтобы проверить: посмотрите, содержит ли ответ content блоки server_tool_use и есть ли у usage поле server_tool_use.web_search_requests — если нет, поиск не был выполнен. Q: А что насчет передачи параметра mcp_servers? A: Тоже не поддерживается (это также серверная функция Anthropic). Важно: в этом случае модель может сгенерировать в теле ответа правдоподобный текст «результат инструмента» — это галлюцинация, а не реальные данные. Не полагайтесь на него. Q: Как выбрать между двумя вариантами? A: Для production выбирайте Вариант 2 (стабильный и управляемый). Если вам нужно нативное качество поиска Anthropic, формат цитирования или вы не хотите строить собственный поиск, обратитесь в службу поддержки, чтобы включить бета-группу ClaudeOfficial — и держите готовый резервный вариант.

Связанные документы

Claude API Basics

Каналы, список моделей, настройка и основы тарификации

Claude Prompt Caching

Многораундовый поиск вопросов и ответов хорошо сочетается с кэшированием для значительного снижения затрат