Перейти к основному содержанию
DeepSeek предлагает два автономных API инструментов для агентов и RAG-пайплайнов, которым требуются актуальные веб-данные:
  • Search: отправьте запрос и получите структурированные результаты веб-поиска (заголовок, ссылка, краткие описания, опционально — содержимое страницы)
  • Fetch: отправьте URL и получите содержимое страницы, уже преобразованное в Markdown
Это не чат-модели. Они не расходуют tokens и тарифицируются за каждый успешный запрос. Ваш код определяет, когда и что искать, а затем передает результаты в любую модель.
Названия моделей: deepseek-search, deepseek-fetch. Эндпоинты: POST /v1/tools/search, POST /v1/tools/fetch. Доступны в группах default / svip. Все данные на этой странице получены в ходе тестирования APIYI 21 октября 2026 г. (UTC+8).
Ключи из группы ClaudeCode не могут вызывать эти два API. Они возвращают ошибку 503 no available channels for model deepseek-search. Создайте отдельный ключ в группе default или svip.

Что это такое и когда это использовать

Обычный сценарий — сначала поиск, затем получение нескольких результатов: summary каждого результата достаточно для оценки релевантности моделью, поэтому запрашивайте целиком только те страницы, которые вам действительно нужны.

Как это соотносится со встроенным поиском в Claude Code

На этой странице описан обычный API: ваш код вызывает /v1/tools/search и /v1/tools/fetch напрямую. В таких клиентах, как Claude Code и Codex, веб-поиск, инициируемый моделью, выполняется через серверный инструмент (web_search) внутри chat API — это совершенно другой механизм. APIYI добавит поддержку встроенного поиска для моделей DeepSeek в этих клиентах в одном из следующих релизов и объявит об этом отдельно.

Цены

Ценообразование в одном предложении: тариф рассчитан на основе «клиентов с крупным депозитом и бонусом 20%», поэтому с учетом бонуса цена соответствует официальной. Базовая цена составляет $0.0009 за запрос; с учетом 20% бонуса за пополнение фактическая стоимость составляет $0.00075 за запрос, что соответствует официальной цене DeepSeek. Обычные клиенты с бонусом 10% платят примерно в 1.09 раза больше официальной цены. Цены включают налоги, возможно выставление счетов. DeepSeek не предоставляет скидок на эти API, и APIYI не закладывает в них прибыль: они предлагаются для гарантии доступности и удобства клиентов. Один ключ APIYI покрывает поиск, извлечение и все основные модели — отдельный аккаунт DeepSeek или его пополнение не требуются.
Цены на модели синхронизированы с официальными тарифами и могут изменяться вслед за ними; приведенная выше таблица носит исключительно ознакомительный характер, а актуальные данные всегда представлены на вкладке Тарифы на модели в верхнем меню навигации: Тарифы на модели.
Правила тарификации (такие же, как и для официального API):
  • Тарифицируются только успешные запросы: HTTP 200 с результатом
  • Ошибки параметров (400) и сбои извлечения (404) не тарифицируются
  • Цена не зависит от count, need_content или длины ответа: 1 результат или 50 результатов с телом страницы считаются за один запрос
  • Каждый вызов фиксируется отдельной строкой в логах консоли под именем модели deepseek-search или deepseek-fetch, что позволяет сверять расходы по моделям

Быстрый старт

В теле запроса не требуется поле model; если вы его передадите, оно будет проигнорировано.

Параметры запроса

Поиск: POST /v1/tools/search

Поисковые операторы (внутри query):

Получение: POST /v1/tools/fetch

Поля ответа

Поиск возвращает {"results": [...]}; каждый результат содержит: Извлечение возвращает {"title": "...", "content": "..."}, где content — содержимое в формате Markdown.

Результаты тестирования

Протестировано 2026-10-21 (UTC+8):

Что необходимо знать

Поисковая система практически всегда возвращает результат: при тестировании строка случайных символов всё равно вернула 3 результата, и запрос был тарифицирован. Аналогично, некоторые сайты при отсутствии страницы возвращают главную страницу или страницу с уведомлением вместо 404 («soft 404»); Fetch считает это успешным получением и тарифицирует его. Выполняйте валидацию поисковых запросов и URL в собственном коде перед отправкой запроса.
Когда Fetch не может получить пригодный для использования контент, он всегда возвращает 404 failed to fetch URL, независимо от того, вернула ли целевая страница 404, домен не существует, адрес является приватным или сайт отклонил доступ. Поле type в теле ошибки всегда имеет значение shell_api_error, поэтому используйте код состояния HTTP вместе с message, чтобы различать ошибки: при 400 исправьте параметры; при 404 попробуйте другой URL; при 429 / 5xx подождите и повторите попытку.
Search и Fetch возвращают исходный контент из интернета, который может содержать рекламу, недостоверную информацию или даже prompt-инъекции, нацеленные на AI. При передаче результатов модели явно указывайте, что это внешний веб-контент, а не инструкции. При отображении результатов на веб-странице или в приложении экранируйте HTML.
Лимиты вышестоящего сервиса составляют 100 QPS для Search и 25 QPS для Fetch, при этом для Fetch действует отдельный лимит на каждый целевой домен. Превышение лимита возвращает 429; подождите немного и повторите попытку. При получении большого количества страниц с одного и того же сайта ограничивайте частоту запросов на стороне клиента.

FAQ

Это встроенные инструменты чат-моделей: модель сама решает, искать ли информацию и что именно искать, а поисковые запросы тарифицируются дополнительно как вызовы инструментов (у OpenAI web_search это $10 за 1 000 вызовов). На этой странице описан автономный API поиска: ваш код определяет, когда и что искать, стоимость запроса составляет лишь малую часть от указанной суммы, а результаты можно передавать в любую модель. Информацию о встроенных инструментах см. в разделах OpenAI Web Search, Claude Web Search и Gemini Web Search.
Напрямую пока нет. Веб-поиск, запускаемый моделью внутри Claude Code, выполняется через серверный инструмент чат-API, а не через этот API, и ключи в группе ClaudeCode также не могут вызывать этот API. В одном из следующих обновлений APIYI добавит поддержку встроенного поиска для моделей DeepSeek в этих клиентах.
Результаты содержат поле date, и вы можете использовать оператор after:, чтобы получать только свежий контент. Во время тестирования отображались новости, опубликованные в тот же день.

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

Песочница поиска

Справочник параметров, коды ошибок и интерактивная панель запросов

Песочница извлечения

Получение любой веб-страницы в формате Markdown

DeepSeek V4 Flash

Чат-модель для совместного использования

Бонусы за пополнение

Чем больше сумма пополнения, тем выше бонус; для клиентов с крупными депозитами действует официальная цена