После того как DeepSeek 13 ноября открыл инструменты приложения: как в JSON deepseek-flash объявить deepseek_web_search, deepseek_read_url и safety_check и считать tool_search отдельно от токенов?

Идентификатор модели не включает поиск. tools, thinking и safety_check задают JSON. Оплачиваемое число — tool_search.

Запись 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 вызовов
Чтение URLdeepseek_read_urlСсылки только в последнем сообщении пользователя, не больше первых 10 разных URL
Безопасностьsafety_check.level = highПроверка входа и выхода. Для публичного сервиса её нужно включить
Файлыfile_id Files APIPDF, 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.actionnamekindРезультат
searchdeepseek_web_searchпри рассуждении deep_search, иначе searchweb_search_tool_result
open_pagedeepseek_web_searchdeep_searchweb_fetch_tool_result. data — пустая строка. signature нет
find_in_pagedeepseek_web_searchdeep_searchТа же форма. title равен null. Не тарифицируется
read_linkdeepseek_read_urlread_linkweb_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 или у страницы нет содержания
dateRFC 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 всё равно может закончиться отказом.

APIJSON отказа
Messagesstop_reason refusal, stop_details.type refusal. Без потока рассуждение и текст ответа убираются, остаются блоки инструментов и один пустой text
Responsesstatus incomplete, incomplete_details.reason content_filter. output оставляет только выполненные web_search_call
Chatfinish_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, который стоит проверить до запуска

  1. В теле стоит deepseek-flash. У инструментов Messages есть и type, и name. Рассуждение — disabled, если нужен был поиск с цитатами.
  2. Публичное приложение шлёт safety_check.level high. На этих вызовах response_format и text.format остаются text.
  3. Разбор сопоставляет tool_use_id и kind и хранит signature для следующего хода.
  4. Счёт использует tool_search, tool_fetch и tool_image_search, плюс вход без кэша, вход с кэшем и вывод. web_search_requests не прибавляется.
  5. Отдельный 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.