Запись model как deepseek-flash не включает поиск. 13 ноября 2026 года DeepSeek открыл на API инструменты, которые стоят за чат-приложением. Имя deepseek-flash — это DeepSeek-V4.1-Flash-1017. Старые имена deepseek-v4-flash и deepseek-v4-flash-vision-exp по-прежнему попадают сюда и считаются по цене Flash. Контекст — 1 000 000 токенов. Максимальный вывод — 384 000. Рассуждение включено по умолчанию.
Страница датирована 16 ноября 2026 года по журналу от 13 ноября, руководству веб-инструментов, руководству Search и Fetch, руководству по безопасности и странице цен. Три дня назад мы разобрали usage Gemini 4 Carbon. Здесь запрос и счёт меняют поля tools, thinking, safety_check и usage.server_tool_use.
Что открылось 13 ноября
Та же модель принимает инструменты на трёх точках. Messages — это POST https://api.deepseek.com/anthropic/v1/messages с заголовком x-api-key. Responses — POST https://api.deepseek.com/responses. Chat Completions — POST https://api.deepseek.com/chat/completions. Две последние шлют Authorization: Bearer. Search, Fetch, OCR, ASR и TTS есть и как отдельные вызовы. Поиск картинок не на POST /v1/tools/search. Он идёт только внутри deepseek_web_search.
| Возможность | JSON, который её включает | Что возвращается |
|---|---|---|
| Веб-поиск | deepseek_web_search, рассуждение выключено | Модель ищет, когда сама решает, и приводит цитаты |
| Глубокий поиск | deepseek_web_search, рассуждение включено | search, open_page, find_in_page, около 20 вызовов |
| Чтение URL | deepseek_read_url | Ссылки только в последнем сообщении пользователя, не больше первых 10 разных URL |
| Безопасность | safety_check.level = high | Проверка входа и выхода. Для публичного сервиса её нужно включить |
| Файлы | file_id Files API | PDF, Office и изображения разбираются до хода чата |
JSON запроса на трёх точках
Messages называет каждый инструмент дважды: type и name. Responses и Chat шлют только type. tool_choice не может назвать эти инструменты. Это 400, deepseek_web_search cannot be forced. tool_choice none выключает каждый объявленный веб-инструмент, включая чтение URL. В Responses и Chat required считается как auto.
Не шлите allowed_domains, blocked_domains и user_location. Не объявляйте один инструмент дважды. Не смешивайте другой серверный инструмент. Ошибка говорит, что другие инструменты пока нельзя использовать вместе с deepseek_web_search, deepseek_read_url, safety_check или title. В Responses инструмент web_search и text.format не равный text дают 400. В Chat web_search_options и response_format не равный text дают 400. Структурный JSON и эти веб-инструменты не делят один запрос. Свою схему отложите на следующий вызов. См. что такое структурный вывод.
Выключенное рассуждение — поиск с цитатами. Включённое — глубокий поиск. Если оба включены, ход не запускает deepseek_read_url. Ссылки читаются, когда рассуждение выключено или объявлен только deepseek_read_url. Messages и Chat ставят thinking.type в disabled или enabled. Пример Responses для глубокого поиска ставит reasoning.effort в high.
{
"model": "deepseek-flash",
"thinking": {
"type": "disabled"
},
"safety_check": {
"level": "high"
},
"tools": [
{
"type": "deepseek_web_search",
"name": "deepseek_web_search"
},
{
"type": "deepseek_read_url",
"name": "deepseek_read_url"
}
],
"messages": [
{
"role": "user",
"content": "What changed in the DeepSeek API on 13 November 2026?"
}
]
}Responses, поиск с рассуждением:
{
"model": "deepseek-flash",
"reasoning": {
"effort": "high"
},
"safety_check": {
"level": "high"
},
"tools": [
{
"type": "deepseek_web_search"
},
{
"type": "deepseek_read_url"
}
],
"input": "Which official page states the height of Tokyo Tower?"
}Блоки, kind и цитаты
В Messages каждый вызов — это блок server_tool_use и результат. Сопоставляйте их по tool_use_id. В потоке оба блока приходят целиком в content_block_start. Итоговый usage читайте из message_delta. usage в message_start покрывает только первый шаг вывода.
| input.action | name | kind | Результат |
|---|---|---|---|
search | deepseek_web_search | при рассуждении deep_search, иначе search | web_search_tool_result |
open_page | deepseek_web_search | deep_search | web_fetch_tool_result. data — пустая строка. signature нет |
find_in_page | deepseek_web_search | deep_search | Та же форма. title равен null. Не тарифицируется |
read_link | deepseek_read_url | read_link | web_fetch_tool_result плюс signature |
Поиск картинок ставит kind в image_search или deep_image_search. queries — пустой массив. В результате может быть image_url только для показа. Цитаты Messages лежат на блоках text с типом web_search_result_location. cited_text — это текст ответа этого блока, а не цитата со страницы. encrypted_index всегда пустая строка. Один URL не больше одного раза на блок. В потоке они приходят как citations_delta.
Responses кладёт вызов в web_search_call с полями kind и action. Ответ — output_text с пометками url_citation. start_index и end_index считают кодовые точки Unicode. Chat кладёт вызовы в message.server_tool_calls. У каждого шага есть reasoning_content и calls. В message.content нет меток цитат. Цитаты — в message.annotations. message.reasoning_content — только последний шаг.
Ответ, который использовал эти инструменты, нельзя продолжить. API возвращает 400 и просит послать предыдущий запрос снова. На следующем ходе верните содержимое ассистента без изменений, включая kind и signature. Фрагменты поиска и прежнее рассуждение в контекст не возвращаются. Только текст ответа. Прочитанная страница восстанавливается из signature. У read_link поле data всегда пустое. Без подписи запрос всё равно проходит, но страницы уже нет. Коды сбоя: url_not_accessible, url_not_allowed и unavailable. url_not_allowed покрывает и страницу, не прошедшую проверку безопасности.
Один элемент поиска Responses:
{
"type": "web_search_call",
"id": "srvtoolu_s_00_3f2a9c",
"status": "completed",
"kind": "search",
"action": {
"type": "search",
"queries": [
"DeepSeek API 13 November 2026"
],
"sources": [
{
"type": "url",
"url": "https://example.com/news",
"title": "Change log",
"snippet": "Web search and URL reading are now API tools.",
"published_at": "2026-11-13T00:00:00+00:00"
}
]
}
}Отдельный JSON Search и Fetch
Когда ищет ваш код, а не модель, вызывайте сырые JSON API. Search — это POST https://api.deepseek.com/v1/tools/search. query обязателен, от 1 до 128 символов, не из одних пробелов. count от 1 до 50, по умолчанию 10. ori_question необязателен, тоже от 1 до 128 символов. localization — необязательный IP. need_content по умолчанию false. Неизвестные поля игнорируются. Операторы, которые проходят как есть: site:, -site:, -, -"...", "...", lang:, after: и before:.
{
"query": "DeepSeek site:api-docs.deepseek.com after:2026-11-01",
"count": 10,
"need_content": false
}Fetch — это POST https://api.deepseek.com/v1/tools/fetch. Единственное поле — url, не длиннее 8 192 символов, HTTP или HTTPS, с хостом и без имени пользователя и пароля. Тело — title и content в Markdown. Если заголовка нет, это пустая строка.
{
"url": "https://api-docs.deepseek.com/updates"
}| Поле | Что сохранить |
|---|---|
rerank_score | От 0 до 3. 1,5 и выше в руководстве — высокое качество |
authority | От 0 до 4. −1 значит неизвестно. 3 и выше — высокая авторитетность |
snippet / summary | Короткий текст для интерфейса, длинный — для модели |
content | Пусто, если need_content не true или у страницы нет содержания |
date | RFC 3339 в UTC, или null |
file_id, OCR и голосовой JSON
Ввод файла — два шага. POST https://api.deepseek.com/files, поле purpose раньше file. text_recognition отбрасывает графики. rich_layout_recognition вырезает рисунки в текст и тратит токены изображений. Объект файла приходит только после разбора. id выглядит как file-api-.... Обрыв соединения не отменяет разбор, который затем удался: файл сохраняется и тарифицируется. Ни оригинал, ни разбор скачать нельзя. Chat Completions ссылается так:
{
"role": "user",
"content": [
{
"type": "file",
"file_id": "file-api-xxxxxxxxxxxxxxxx"
},
{
"type": "text",
"text": "Summarize the revenue chart."
}
]
}Messages нужен заголовок anthropic-beta: files-api-2025-04-14 и блок document, у которого source.type равен file. Responses использует input_file и file_id. Разобранный документ нельзя послать как блок изображения. Байты или URL файла в запрос чата тоже не кладут. Один запрос ссылается не больше чем на 20 документов и 8 МиБ их текста. Полный разбор остаётся в контексте на следующих ходах. Слишком длинный запрос даёт 400. Тихого обрезания нет.
Пределы: PDF, Word, PowerPoint и обычные изображения, формат определяется по байтам. 100 МиБ, иначе 413. 1 000 страниц. 120 секунд на загрузку, иначе 408. 120 секунд на разбор, иначе 504. 15 одновременных загрузок документов на аккаунт. Файл с паролем даёт 400. Простой текст, csv, json, исходный код, xlsx, xls, epub и mobi используют purpose user_data и не тарифицируются по страницам. Эти файлы — до 32 МиБ, текст — до 8 МиБ. AZW3 и книги с DRM не поддерживаются.
Разбор стоит 0,225 $ за 1 000 страниц, один раз, только если он удался. Дальнейшие ходы чата считают входные токены, а не страницы снова. OCR имеет ту же цену страницы на POST /v1/tools/ocr и не входит в Files API. Это multipart, поля file и purpose, не JSON-тело. ASR — multipart-аудио, не JSON. TTS — JSON, POST /v1/tools/tts:
Прейскурант TTS — 0,45 $ за 10 000 символов, опубликованная временная цена — 0,225 $. Китайский иероглиф считается за 2. Любой другой символ — за 1. Голоса — stella (по умолчанию) и tide. Поля языка нет. Прейскурант ASR — 0,116 $ за час аудио, временная цена 0,058 $, по секундам, дробная секунда округляется до 1. На странице цен нет даты окончания полуцены.
{
"text": "Hello from DeepSeek.",
"voice_id": "stella",
"format": "wav",
"filter_markdown": true
}safety_check и JSON отказа
Для сервиса, до которого доходит публика, поставьте safety_check в {"level":"high"}. low совпадает с отсутствием поля. Любой другой level — это 400. Параметр не заменяет ваши обязанности по проверке, регистрации и маркировке. Ввод, который не прошёл, даёт 400 Content Exists Risk. Эти входные токены всё равно считаются, по цене попадания в кэш. После модели соединение остаётся открытым, пока проверяется весь вывод. Уже отданный текст вернуть нельзя. Замените то, что показали. Токены до отказа считаются. Токены проверки входят в выходные и отдельно лежат в usage.output_tokens_details.safety_tokens у Messages и Responses или в usage.completion_tokens_details.safety_tokens у Chat. Заблокированное изображение может назвать путь вроде messages.1.content.0 в stop_details.explanation, в содержимом отказа или в message.refusal. Запрос с веб-инструментами и без safety_check всё равно может закончиться отказом.
| API | JSON отказа |
|---|---|
| Messages | stop_reason refusal, stop_details.type refusal. Без потока рассуждение и текст ответа убираются, остаются блоки инструментов и один пустой text |
| Responses | status incomplete, incomplete_details.reason content_filter. output оставляет только выполненные web_search_call |
| Chat | finish_reason content_filter. content — пустая строка. annotations опускается. server_tool_calls остаётся, рассуждение каждого шага очищается |
Считать tool_search, а не web_search_requests
Токены и инструменты считайте отдельными строками. Цены Flash — за 1 000 000 токенов. Пик — 01:00–04:00 и 06:00–10:00 UTC, с понедельника по пятницу, без китайских государственных праздников. Любой другой час — вне пика, включая выходные и китайские праздники целиком. Вне пика цена вдвое ниже. cache_creation_input_tokens остаётся 0.
| Окно | Попадание в кэш / 1M | Промах / 1M | Вывод / 1M |
|---|---|---|---|
| Вне пика | $0.003 | $0.15 | $0.60 |
| Пик | $0.006 | $0.30 | $1.20 |
Поиск и веб-fetch стоят 0,75 $ за 1 000 успешных использований, вызвал ли инструмент модель или вы сами вызвали /v1/tools/search либо /v1/tools/fetch. Поиск инструмента с результатами считается по каждому запросу: три запроса — это три раза. count не меняет цену Search API. HTTP 200 с пустым массивом results не считается. Fetch считается, только когда вернулось содержимое страницы. Страница, которую проверка потом заменяет на url_not_allowed или unavailable, уже была получена, поэтому считается. Повторное открытие той же страницы в глубоком поиске бесплатно. find_in_page бесплатен.
Search ограничен 100 запросами в секунду на аккаунт. Fetch — 25, плюс предел на домен. Пределы на аккаунт, а не на ключ, и отдельно от предела одновременности Flash в 2 500. В руководстве поиск с двумя запросами сообщает web_search_requests 1 и tool_search 2. Храните tool_search, tool_fetch и tool_image_search. Не прибавляйте web_search_requests. В Responses и Chat эта тройка в server_tool_use опускается, когда все три равны 0.
Если генерация сорвалась, когда статус HTTP уже 200, тело — это ошибка плюс usage. Поток Messages кончается событием error, после него нет message_delta. Проверьте тело. SDK не бросает исключение на статусе 200. Опубликованный пример того поиска с двумя запросами. thinking_tokens и safety_tokens в этом объекте нет. Они появляются отдельно, когда рассуждение включено или safety_check равен high, и уже входят в output_tokens:
{
"input_tokens": 1905,
"cache_creation_input_tokens": 0,
"cache_read_input_tokens": 0,
"output_tokens": 72,
"service_tier": "standard",
"server_tool_use": {
"web_search_requests": 1,
"web_fetch_requests": 0,
"tool_search": 2,
"tool_fetch": 0,
"tool_image_search": 0
}
}JSON, который стоит проверить до запуска
- В теле стоит
deepseek-flash. У инструментов Messages есть иtype, иname. Рассуждение —disabled, если нужен был поиск с цитатами. - Публичное приложение шлёт
safety_check.levelhigh. На этих вызовахresponse_formatиtext.formatостаютсяtext. - Разбор сопоставляет
tool_use_idиkindи хранитsignatureдля следующего хода. - Счёт использует
tool_search,tool_fetchиtool_image_search, плюс вход без кэша, вход с кэшем и вывод.web_search_requestsне прибавляется. - Отдельный
query— от 1 до 128 символов.count— от 1 до 50. Пустые результаты — не плата.
Проверьте JSON локально валидатором JSON, JSONPath ($.usage.server_tool_use.tool_search) и JSON Diff против предыдущего запроса. Ничего не загружается.
FAQ
thinking меняет поиск?
Да. thinking.type disabled — это веб-поиск с цитатами, kind равен search. enabled — глубокий поиск с рассуждением: search, open_page и find_in_page, около 20 вызовов, kind равен deep_search. Рассуждение включено по умолчанию. Если рассуждение и deepseek_web_search оба включены, этот ход не запускает deepseek_read_url.
Можно ли заставить deepseek_web_search через tool_choice?
Нет. Имя инструмента даёт 400, deepseek_web_search cannot be forced. Решает модель. tool_choice none выключает объявленные веб-инструменты, включая чтение URL. В Responses и Chat required считается как auto.
Счёт должен использовать web_search_requests?
Нет. Это число включает ошибки и нужно для показа. Считайте tool_search, tool_fetch и tool_image_search. В руководстве один блок поиска с двумя запросами сообщает web_search_requests 1 и tool_search 2. Поиск с результатами тарифицируется по каждому запросу. Пустой или неудачный поиск не тарифицируется.
POST /v1/tools/search ищет картинки?
Нет. Поиск картинок идёт только внутри deepseek_web_search. kind равен image_search или deep_image_search, а queries пуст. Каждая картинка — один поиск, каждая область, которую выбрала модель, — ещё один.
Что отправляет публичный сервис для проверки?
DeepSeek пишет: сервис для публики включает safety_check с level high. low совпадает с отсутствием поля. Рискованный ввод даёт 400 Content Exists Risk, и эти входные токены всё равно считаются по цене попадания в кэш. Отказ — это stop_reason refusal, у Responses incomplete с content_filter, у Chat finish_reason content_filter.
Можно ли продолжить ответ, который искал?
Нет. Ответ, где были deepseek_web_search или deepseek_read_url, даёт 400. Отправьте предыдущий запрос снова. На следующем ходе верните блоки ассистента без изменений, включая kind и signature. Без годной подписи запрос всё равно проходит, но страница не возвращается в контекст.
Кратко
Инструменты 13 ноября 2026 года меняют запрос, блоки, которые нужно хранить, и вторую строку счёта. Объявите deepseek_web_search и deepseek_read_url на deepseek-flash. Выключите рассуждение для поиска с цитатами и включите для глубокого поиска. Публичные приложения ставят safety_check.level в high. Считайте tool_search, а не web_search_requests.