OpenAI Responses API web_search теперь возвращает изображения

OpenAI Responses API web_search теперь возвращает изображения вместе с текстовыми цитатами. Когда мигрировать с web_search_preview и маршрутизировать visual grounding workload.

Опубликовано источник OpenAI

Архивный материал, подготовленный с помощью ИИ по указанному источнику и опубликованный без индивидуальной проверки. Ответственный редактор: Joe Werner.

Абстрактная редакционная иллюстрация: поисковый запрос возвращает текстовые цитаты и изображения, проходящие через слой маршрутизации API
Машинный перевод с английского оригинала — читать оригинал

9 июня OpenAI тихо опубликовала в changelog значимое изменение, влияющее на routing-решения: инструмент web search в Responses API теперь возвращает изображения наряду с текстовыми результатами — функциональность, недоступная в Chat Completions API.

Официальная формулировка лаконична: «Web search теперь может возвращать изображения вместе с обычными текстовыми результатами. Используйте image search, когда приложению нужны актуальные или web-привязанные визуальные материалы — фотографии товаров, достопримечательности, места, события или визуальные референсы.»

Для AI engineering-команд, маршрутизирующих запросы через routing layer, это больше, чем просто feature flag. Поддержка image search теперь является фактором выбора endpoint — а не только выбора модели.

Что изменилось в web search Responses API

Инструмент web_search в Responses API теперь возвращает элементы-изображения в дополнение к существующим текстовым цитатам и аннотациям url_citation. OpenAI явно указала сценарии использования:

  • Фотографии товаров и визуальный контент для e-commerce
  • Изображения достопримечательностей и локаций
  • Освещение событий (конференции, спортивные мероприятия, новости)
  • Визуальные референсы для мультимодальных downstream-задач

Сам инструмент web search поддерживает три режима работы:

РежимОптимален дляПримечания
Non-reasoning (быстрый)Быстрые запросыПростой pass-through, без внутреннего планирования
Agentic search (reasoning models)Сложные workflowsМодель управляет многошаговым поиском; рекомендуется gpt-5.5
Deep researchРасширенные исследованияСотни источников; запускать в background mode

Результаты image search доступны во всех трёх режимах. Устаревший инструмент web_search_preview не получает новых возможностей и не поддерживает image search — мигрируйте на { "type": "web_search" }.

Почему выбор endpoint теперь важен для routing-команд

До этого изменения основным routing-аргументом в пользу Responses API перед Chat Completions было управление stateful multi-turn диалогами и поддержка фоновых задач. Теперь появился второй конкретный capability gap: только web search в Responses API возвращает изображения. Chat Completions с gpt-5-search-api поддерживает текстовый web search для legacy-интеграций, но не поддерживает image grounding.

Если agent-pipeline требует:

  • Отображать пользователям web-привязанные изображения в ответах
  • Привязывать актуальные визуальные референсы к downstream image-generation задачам
  • Запускать мультимодальные исследования с синтезом актуального визуального контента

…то правильный endpoint — Responses API, и routing policy должна явно это закрепить.

Минимальный вызов Responses API с web search:

import OpenAI from "openai";
const client = new OpenAI();

const response = await client.responses.create({
  model: "gpt-5.5",
  tools: [{ type: "web_search" }],
  input: "Покажи изображения нового офиса Anthropic в Лондоне",
});

console.log(response.output_text);
// цитаты доступны в response.output[n].content[0].annotations

На что обратить внимание

Изменения структуры ответа. Результаты image search появляются как дополнительные элементы рядом с web_search_call action и аннотациями url_citation. Командам, программно парсящим response.output, следует корректно обрабатывать новые типы output-элементов — убедитесь, что код не выбрасывает исключение при встрече с неизвестными типами.

Биллинг tool calls. Каждое действие search в web_search_call тарифицируется как tool call по ценам OpenAI. Image search не добавляет отдельную строку в счёт — изображения возвращаются в рамках того же search call, — однако более длинные ответы с богатыми image metadata могут увеличить количество токенов.

Путь миграции с web_search_preview. Оригинальный инструмент web_search_preview остаётся доступным, но не получает новых возможностей, включая image search, filters, external_web_access и return_token_budget. OpenAI рекомендует мигрировать новые интеграции на { "type": "web_search" }.

Матрица routing-решений

При выборе правильного endpoint и конфигурации инструмента для web search-нагрузок используйте эту таблицу:

ТребованиеEndpointИнструмент
Только текстовые web-результаты, новая интеграцияResponses APIweb_search
Изображения + текстовые web-результатыResponses APIweb_search
Legacy Chat Completions, только текстChat Completionsgpt-5-search-api
Многошаговые исследования (deep)Responses API + backgroundweb_search + gpt-5.5
Сохранить существующий Chat Completions кодChat Completionsgpt-5-search-api

Если OpenAI-запросы маршрутизируются через unified gateway, это различие означает: routing rules не могут одинаково обрабатывать все web_search-нагрузки. Запрос, требующий visual grounding, должен явно направляться по Responses API пути; иначе image results просто не будут возвращены.

По теме

Редакционная иллюстрация с тремя орбитальными уровнями и символом выполнения кода в центре, обозначающая Programmatic Tool Calling GPT-5.6 и политику многомодельного роутинга, на нейтральном фоне

GPT-5.6 GA: Programmatic Tool Calling перемещает оркестрацию инструментов внутрь модели — что операторам нужно обновить немедленно

GPT-5.6 Sol, Terra и Luna доступны в общем доступе с подтверждёнными ценами. Новая функция Responses API — Programmatic Tool Calling — смещает диспетчеризацию инструментов внутрь модели, обходя слой оркестрации на стороне шлюза.

источник OpenAI
Редакционная иллюстрация с разветвляющимися путями API-маршрутизации, где ветвь agents sessions уходит в сторону от основного шлюза на тёмном приглушённом фоне

OpenAI Agents API Beta: Новый обход шлюза, который операторам необходимо учесть

Публичная бета Agents API от OpenAI вводит отдельное пространство имён client.beta.agents, не проходящее через /v1/chat/completions. Для команд с AI-шлюзами: слепые зоны в биллинге, пробелы в аудите и новый scope API key.

источник OpenAI
Помощь и контакты