OpenAI Responses API web_search теперь возвращает изображения
OpenAI Responses API web_search теперь возвращает изображения вместе с текстовыми цитатами. Когда мигрировать с web_search_preview и маршрутизировать visual grounding workload.
Архивный материал, подготовленный с помощью ИИ по указанному источнику и опубликованный без индивидуальной проверки. Ответственный редактор: Joe Werner.

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 API | web_search |
| Изображения + текстовые web-результаты | Responses API | web_search |
| Legacy Chat Completions, только текст | Chat Completions | gpt-5-search-api |
| Многошаговые исследования (deep) | Responses API + background | web_search + gpt-5.5 |
| Сохранить существующий Chat Completions код | Chat Completions | gpt-5-search-api |
Если OpenAI-запросы маршрутизируются через unified gateway, это различие означает: routing rules не могут одинаково обрабатывать все web_search-нагрузки. Запрос, требующий visual grounding, должен явно направляться по Responses API пути; иначе image results просто не будут возвращены.
По теме
- Маршрутизация AI-провайдеров — как TheRouter маршрутизирует запросы между провайдерами и типами endpoint
- OpenAI API Changelog — официальный источник
- Руководство по web search — справочник по web search в Responses API
Похожие материалы
Новости AI-роутинга и провайдеров →
GPT-5.6 GA: Programmatic Tool Calling перемещает оркестрацию инструментов внутрь модели — что операторам нужно обновить немедленно
GPT-5.6 Sol, Terra и Luna доступны в общем доступе с подтверждёнными ценами. Новая функция Responses API — Programmatic Tool Calling — смещает диспетчеризацию инструментов внутрь модели, обходя слой оркестрации на стороне шлюза.

OpenAI Prompt Cache Diagnostics стал GA: что нельзя убирать на уровне gateway
OpenAI выпустил Prompt Cache Diagnostics в GA для Responses API. Новые поля comparison_response_id и reason объясняют промахи кеша — но если gateway удаляет prompt_cache_options, диагностика молча исчезает.

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