Компания DeepSeek расширила свою платформу API, представив два новых автономных инструмента: конечную точку поиска (Search endpoint), которая запрашивает веб и предоставляет структурированные результаты, и конечную точку получения данных (Fetch endpoint), которая извлекает содержимое одной страницы и возвращает его в формате Markdown.
Согласно документации API на китайском языке, эти инструменты предназначены для того, чтобы приложения, использующие агентов и генерацию с дополненной выборкой (RAG), могли получать доступ к актуальному контенту из интернета без необходимости привлечения стороннего поискового провайдера.
Оба инструмента представляют собой сырые JSON API и используют ту же аутентификацию Bearer, что и остальная часть API DeepSeek. Поиск доступен по адресу api.deepseek.com/v1/tools/search, а получение данных — по api.deepseek.com/v1/tools/fetch.
Детали работы функции поиска
Запрос поиска принимает поисковый запрос длиной до 128 символов и может вернуть от 1 до 50 результатов, при этом по умолчанию установлено 10. Разработчики могут передавать оригинальный вопрос пользователя, чтобы помочь сервису определить намерение, указывать IP-адрес для получения локализованных результатов и запрашивать полный текст страницы. Запросы поддерживают операторы, такие как site: и -site: для включения или исключения доменов, кавычки для точных фраз, lang: для ограничения языков, а также после: и перед: для ограничения дат публикации.
Каждый полученный результат включает заголовок, URL, краткое описание размером примерно от 100 до 200 символов для отображения, более подробное резюме объемом около 600–800 символов, предназначенное для чтения моделями, необязательное поле полного текста, дату публикации, оценку переранжирования от 0 до 3 и рейтинг авторитетности от 0 до 4.
Функциональность получения данных
Инструмент Fetch принимает один URL-адрес в формате HTTP или HTTPS и возвращает заголовок страницы вместе с ее содержимым в формате Markdown. DeepSeek отмечает, что результаты зависят от доступности целевого сайта и его политик доступа, а заблокированные или недоступные страницы возвращают ошибку.
Модель ценообразования и лимиты
Стоимость рассчитывается за каждый запрос, а не за токен или результат. И Поиск, и Получение данных стоят 5 юаней за каждые 1000 успешных запросов. Биллингу подлежат только вызовы, которые возвращают HTTP 200 с контентом: поиск должен вернуть список результатов, не являющийся пустым, а Fetch — текст страницы. Неудачные запросы, пустые поиски и таймауты бесплатны, и количество запрошенных результатов не влияет на цену.
Запросы, инициированные через инструмент Web Search в Claude Code или функцию web_search в Codex, не будут облагаться платой за Поиск в течение первых двух недель после запуска API Search. DeepSeek заявляет, что после этого будет применяться стандартное ценообразование, и точную дату начала выставления счетов они объявят отдельно.
Лимиты скорости устанавливаются на уровне учетной записи, а не ключа. Поиск и Fetch ограничены 5 запросами в секунду каждый, и эти лимиты отслеживаются независимо друг от друга и от ограничений параллелизма моделей. Для Fetch также действуют лимиты на домен, и превышение любого из этих лимитов приводит к возврату HTTP 429.