Генерация текста OpenAI API с веб-поиском

Web search — это инструмент OpenAI API, который позволяет моделям искусственного интеллекта выполнять поиск в интернете для получения актуальной информации перед генерацией ответа.

Объем поискового контекста

Параметр search_context_size определяет объем контекста, получаемого из веб-поиска, для формирования ответа модели. Он регулирует количество токенов, извлекаемых из веб-страниц, что влияет на полноту и детализацию ответа. Изменение этого параметра позволяет контролировать, насколько обширным будет контекст, используемый моделью при генерации ответа.

Возможные значения:

• low — малый объем контекста
• medium — средний объем контекста (по умолчанию)
• high — большой объем контекста

Местоположение пользователя

Параметр user_location позволяет задать местоположение пользователя для веб-поиска. Он используется для улучшения релевантности результатов поиска и предоставления более точных и актуальных ответов.

Параметры:

• type — тип местоположения (всегда approximate)
• country — двухбуквенный ISO-код страны (например, RU для России)
• city — город
• region — регион

Тарификация

Потребление токенов тарифицируется как обычно для выбранной модели. Каждый поиск считается отдельно, стоимость фиксированная и зависит от выбранного объема контекста. Цены здесь.

Responses API

В новой Responses API поиск доступен в качестве инструмента, который можно включать или не включать в параметры запроса. Таким образом, можно контролировать, для каких запросов поиск будет осуществлен, а для каких — нет.

Пример:

curlpythonnode.js
curl "https://api.proxyapi.ru/openai/v1/responses" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <КЛЮЧ>" \
    -d '{
        "model": "gpt-4o",
        "tools": [{
            "type": "web_search_preview",
            "search_context_size": "low",
            "user_location": {
                "type": "approximate",
                "country": "RU",
                "city": "Moscow",
                "region": "Moscow"
            }
        }],
        "input": "Какая сегодня погода?"
    }'

Chat Completions API

В Chat Completions API поиск доступен через обращение к специальным расширениям основных моделей: gpt-4o-search-preview и gpt-4o-mini-search-preview. При запросе к этим моделям, поиск выполняется обязательно, то есть нельзя включать или выключать его для каких-то определенных запросов.

Пример:

curlpythonnode.js
curl "https://api.proxyapi.ru/openai/v1/chat/completions" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <КЛЮЧ>" \
    -d '{
        "model": "gpt-4o-search-preview",
        "web_search_options": {
            "search_context_size": "low",
            "user_location": {
                "type": "approximate",
                "country": "RU",
                "city": "Moscow",
                "region": "Moscow"
            }
        },
        "messages": [
            {
                "role": "user",
                "content": "Какая сегодня погода?"
            }
        ]
    }'