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 в документации не называет.
Источники
- https://api-docs.deepseek.com/news/news261113
- https://api-docs.deepseek.com/guides/web_tools
- https://api-docs.deepseek.com/guides/document_parsing
- https://api-docs.deepseek.com/quick_start/pricing
- https://api-docs.deepseek.com/guides/thinking_mode
- https://api-docs.deepseek.com/guides/build_a_chatbot
Комментарии