DeepSeek открыла поиск и файлы в API: минимальный запрос и его цена

Два запроса curl из документации DeepSeek: поиск в вебе и вопрос по загруженному PDF. Считаем цену по цифрам из примера и показываем, где счёт растёт незаметно.
DeepSeek открыла поиск и файлы в API: минимальный запрос и его цена

13 ноября DeepSeek открыла в API то, что раньше было только в её приложении: поиск в вебе с цитатами, чтение ссылок и разбор файлов. Поисковик, парсер PDF и цикл вызова инструментов больше не нужно подключать самостоятельно. Сервер DeepSeek сам ищет и читает страницы, а клиент получает готовый ответ.

Ниже два минимальных запроса, собранных по документации, и расчёт их цены. Запросы мы не запускали: число токенов и поля ответа взяты из примеров DeepSeek, а арифметика наша.

Запрос с поиском в вебе

Для встроенных инструментов в документации указана одна модель — deepseek-flash. Поиск включается одним элементом в массиве tools:

        curl https://api.deepseek.com/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${DEEPSEEK_API_KEY}" \
  -d '{
    "model": "deepseek-flash",
    "thinking": {"type": "disabled"},
    "tools": [{"type": "deepseek_web_search"}],
    "messages": [{"role": "user", "content": "What is the population of Iceland?"}]
  }'
    

Строка "thinking": {"type": "disabled"} здесь главная. По описанию режима рассуждений он включён по умолчанию. А с включёнными рассуждениями тот же инструмент работает иначе: модель в несколько шагов выполняет поиск, открывает страницы и ищет в них текст. Это дольше и дороже, подробности — в разделе про цену.

Искать или нет, модель решает сама. Заставить её нельзя: по документации веб-инструментов tool_choice с именем deepseek_web_search возвращает ошибку 400. Если поиск включён, сервер сам выставляет temperature, top_p и ещё несколько параметров: по руководству по сборке чат-бота, переданные значения игнорируются.

В ответе Chat Completions вызовы поиска лежат в message.server_tool_calls, текст в message.content, а цитаты в message.annotations. Для счёта важен объект usage. Вот как он выглядит в примере DeepSeek для этого же вопроса в протоколе Messages:

        "usage": {
  "input_tokens": 1905,
  "output_tokens": 72,
  "server_tool_use": {"web_search_requests": 1, "web_fetch_requests": 0, "tool_search": 2, "tool_fetch": 0, "tool_image_search": 0}
}
    

Обратите внимание на разницу между web_search_requests и tool_search. Первое поле показывает число блоков с результатами и нужно для интерфейса. Деньги списываются по второму: модель сделала один поисковый вызов, но в нём было два запроса, и оплачиваются оба.

Запрос по файлу

Здесь два шага. Сначала файл загружается в Files API, и сервер разбирает его в текст:

        curl https://api.deepseek.com/files \
  -H "Authorization: Bearer ${DEEPSEEK_API_KEY}" \
  -F purpose="text_recognition" \
  -F file="@report.pdf"
    

Поле purpose должно идти раньше поля file, иначе сервер вернёт 400. Значение text_recognition извлекает только текст. Если модели нужно видеть графики и схемы, документация по разбору файлов предлагает rich_layout_recognition: рисунки вырезаются и передаются модели, но расходуют входные токены.

Ответ приходит только после разбора и содержит идентификатор файла. Его подставляют во второй запрос:

        curl https://api.deepseek.com/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${DEEPSEEK_API_KEY}" \
  -d '{
    "model": "deepseek-flash",
    "messages": [{"role": "user", "content": [
      {"type": "file", "file_id": "file-api-xxxxxxxxxxxxxxxx"},
      {"type": "text", "text": "Summarize the key points of this document."}
    ]}]
  }'
    

Документ, которому нужен разбор, нельзя передать содержимым или ссылкой прямо в запросе — только через file_id. Обычный текст, CSV, JSON и исходный код разбирать не нужно: их загружают с purpose="user_data", и такая загрузка бесплатна.

Сколько это стоит

Цены со страницы тарифов на 16 ноября:

Что оплачивается Цена
Поиск, текстовый и по картинкам $0,75 за 1000 запросов
Загрузка страницы $0,75 за 1000 страниц
Разбор файла $0,225 за 1000 страниц документа
Входные токены deepseek-flash, мимо кэша $0,30 за 1 млн в пик, $0,15 вне пика
Входные токены, попадание в кэш $0,006 за 1 млн в пик, $0,003 вне пика
Выходные токены $1,20 за 1 млн в пик, $0,60 вне пика

Пиковые часы у DeepSeek: с 01:00 до 04:00 и с 06:00 до 10:00 UTC по будням, кроме официальных праздников Китая. По Москве это с 4 до 7 утра и с 9 до 13 часов.

Посчитаем запрос про Исландию по usage из примера. Два поиска стоят $0,0015. Токены в пик: 1905 входных дают $0,00057, 72 выходных — ещё $0,00009. Итого — около $0,0022 за запрос, или $2,16 за тысячу таких запросов. Вне пика выйдет $1,83 за тысячу. Это расчёт Proglib по одному примеру из документации; на длинных ответах доля токенов будет больше.

Вывод из арифметики такой: в коротком запросе с поиском плата за сам поиск составляет около 70% счёта в пик и около 82% вне пика. Токены дёшевы, поэтому экономить стоит на числе поисковых запросов.

С файлом расчёт другой. Разбор PDF на 30 страниц стоит $0,00675 и оплачивается один раз, при загрузке. Дальше за разбор платить не нужно: в каждом запросе с этим file_id оплачиваются токены, как в обычном чате. Текст документа целиком попадает в контекст и считается входными токенами.

Где счёт растёт незаметно

  • Забытый thinking. С включёнными рассуждениями поиск превращается в многошаговый: по документации модель делает примерно до 20 вызовов инструментов перед ответом. Оплачивается каждый поисковый запрос и каждая страница, загруженная из сети. Повторное открытие той же страницы и поиск текста внутри неё бесплатны.
  • Несколько запросов в одном вызове. Вызов с тремя запросами считается за три. Неудачный поиск и поиск без результатов не оплачиваются.
  • Документ в длинном диалоге. Полный текст файла остаётся в контексте во всех следующих раундах. Если контекст переполнится, запрос вернёт 400: молча обрезать документ сервер не станет.
  • Чтение ссылок. Инструмент deepseek_read_url загружает страницы по ссылкам из сообщения пользователя, и каждая успешно полученная страница оплачивается как загрузка.

Ограничения, о которые легко споткнуться

  • Файл: до 100 МиБ и до 1000 страниц, загрузка и разбор должны уложиться в 120 секунд каждый.
  • В одном запросе не больше 20 документов, их текст в сумме не больше 8 МиБ.
  • Результаты поиска и открытые при поиске страницы в следующие раунды диалога не переходят, остаётся только текст ответа.
  • При включённых рассуждениях и объявленном deepseek_web_search ссылки из сообщения отдельно не читаются. Чтобы модель прочитала именно вашу ссылку, объявите только deepseek_read_url или выключите рассуждения.
  • Публичным приложениям DeepSeek предписывает включать проверку безопасности. За модерацию и маркировку контента, созданного ИИ, отвечает разработчик.

Перед тем как встраивать поиск в продукт, прогоните десяток типичных вопросов своих пользователей и сложите tool_search, tool_fetch и tool_image_search из ответов. Умножьте сумму на $0,00075 и прибавьте стоимость токенов: так вы получите реальную цену своего сценария. Лимиты на число поисков в минуту DeepSeek в документации не называет.

Источники

По теме

Комментарии