Nachdem DeepSeek am 13. November die App-Werkzeuge geöffnet hat: Wie deklariert deepseek-flash-JSON deepseek_web_search, deepseek_read_url und safety_check, und wie rechnet man tool_search getrennt von Tokens ab?

Die Modell-ID schaltet die Suche nicht ein. tools, thinking und safety_check bestimmen das JSON. Die berechnete Zahl ist tool_search.

model auf deepseek-flash zu setzen schaltet die Suche nicht ein. Am 13. November 2026 hat DeepSeek die Werkzeuge hinter der Chat-App auf der API geöffnet. Die ID deepseek-flash ist DeepSeek-V4.1-Flash-1017. Die alten IDs deepseek-v4-flash und deepseek-v4-flash-vision-exp laufen weiterhin hierher und werden zum Flash-Preis berechnet. Der Kontext hat 1.000.000 Tokens. Die maximale Ausgabe hat 384.000. Denken ist der Standard.

Diese Seite steht auf dem 16. November 2026 und folgt dem Changelog vom 13. November, dem Leitfaden zu den Web-Tools, dem Search- und Fetch-Leitfaden, dem Sicherheitsleitfaden und der Preisseite. Vor drei Tagen ging es um Gemini 4 Carbon und usage. Hier ändern tools, thinking, safety_check und usage.server_tool_use die Anfrage und die Rechnung.

Was am 13. November offen ging

Dasselbe Modell nimmt die Tools an drei Endpunkten an. Messages ist POST https://api.deepseek.com/anthropic/v1/messages mit x-api-key. Responses ist POST https://api.deepseek.com/responses. Chat Completions ist POST https://api.deepseek.com/chat/completions. Die letzten beiden senden Authorization: Bearer. Search, Fetch, OCR, ASR und TTS gibt es auch als eigene Aufrufe. Bildsuche liegt nicht auf POST /v1/tools/search. Sie läuft nur in deepseek_web_search.

FähigkeitJSON, das sie einschaltetWas zurückkommt
Websuchedeepseek_web_search, Denken ausDas Modell sucht, wenn es das für nötig hält, und zitiert
Tiefe Denksuchedeepseek_web_search, Denken ansearch, open_page, find_in_page, etwa 20 Aufrufe
URL lesendeepseek_read_urlLinks nur in der letzten Nutzernachricht, höchstens die ersten 10 verschiedenen URLs
Sicherheitsafety_check.level = highPrüfung von Ein- und Ausgabe. Für einen öffentlichen Dienst verlangt
DateienFiles-API file_idPDF, Office und Bilder werden vor der Runde gelesen

Request-JSON an drei Endpunkten

Messages nennt jedes Tool zweimal, type und name. Responses und Chat senden nur type. tool_choice darf diese Tools nicht benennen. Das ergibt 400, deepseek_web_search cannot be forced. tool_choice none schaltet jedes deklarierte Web-Tool aus, auch das Lesen von URLs. Bei Responses und Chat gilt required als auto.

Senden Sie nicht allowed_domains, blocked_domains oder user_location. Deklarieren Sie dasselbe Tool nicht zweimal. Mischen Sie kein weiteres Server-Tool hinein. Die Fehlermeldung sagt, andere Tools könnten noch nicht zusammen mit deepseek_web_search, deepseek_read_url, safety_check oder title verwendet werden. Bei Responses ergeben ein web_search-Tool und text.format ungleich text den Status 400. Bei Chat ergeben web_search_options und response_format ungleich text den Status 400. Strukturiertes JSON und diese Web-Tools teilen sich keine Anfrage. Legen Sie das eigene Schema auf einen späteren Aufruf. Siehe was strukturierte Ausgabe ist.

Denken aus ist die Suche mit Zitaten. Denken an ist die tiefe Denksuche. Sind beide an, läuft deepseek_read_url in dieser Runde nicht. Links werden gelesen, wenn Denken aus ist oder nur deepseek_read_url deklariert ist. Messages und Chat setzen thinking.type auf disabled oder enabled. Das Responses-Beispiel für die tiefe Denksuche setzt reasoning.effort auf 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, mit Denksuche:

{
  "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?"
}

Blöcke, kind und Zitate

Bei Messages ist jeder Aufruf ein Block server_tool_use plus ein Ergebnis. Ordnen Sie sie über tool_use_id zu. Im Stream kommen beide Blöcke vollständig in content_block_start. Die endgültige usage steht in message_delta. Die usage in message_start deckt nur den ersten Inferenzschritt ab.

input.actionnamekindErgebnis
searchdeepseek_web_searchdeep_search beim Denken, sonst searchweb_search_tool_result
open_pagedeepseek_web_searchdeep_searchweb_fetch_tool_result. data ist leer. Keine signature
find_in_pagedeepseek_web_searchdeep_searchGleiche Form. title ist null. Nicht berechnet
read_linkdeepseek_read_urlread_linkweb_fetch_tool_result plus signature

Bildsuche setzt kind auf image_search oder deep_image_search. queries ist ein leeres Array. Ein Treffer kann image_url nur zur Anzeige tragen. Zitate bei Messages sitzen auf text-Blöcken als web_search_result_location. cited_text ist der Antworttext dieses Blocks, kein Zitat von der Seite. encrypted_index ist immer ein leerer String. Eine URL höchstens einmal pro Block. Im Stream kommen sie als citations_delta.

Responses legt den Aufruf in ein web_search_call mit kind und action. Die Antwort ist output_text mit url_citation-Annotationen. start_index und end_index zählen Unicode-Codepunkte. Chat legt Aufrufe in message.server_tool_calls. Jeder Schritt hat reasoning_content und calls. message.content hat keine Zitatmarken. Zitate stehen in message.annotations. message.reasoning_content ist nur der letzte Schritt.

Eine Antwort, die diese Tools genutzt hat, lässt sich nicht fortsetzen. Die API antwortet mit 400 und verlangt, die vorige Anfrage erneut zu senden. In der nächsten Runde geben Sie den Assistant-Inhalt unverändert zurück, einschließlich kind und signature. Suchschnipsel und früheres Denken kommen nicht erneut in den Kontext. Nur der Antworttext. Eine gelesene Seite kommt aus signature zurück. Bei read_link ist data immer leer. Ohne Signatur gelingt die Anfrage, die Seite ist aber weg. Fehlercodes sind url_not_accessible, url_not_allowed und unavailable. url_not_allowed deckt auch eine Seite ab, die die Sicherheitsprüfung nicht bestanden hat.

Ein Search-Eintrag bei 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"
      }
    ]
  }
}

Eigenständiges Search- und Fetch-JSON

Wenn Ihr Code und nicht das Modell sucht, rufen Sie die rohen JSON-APIs. Search ist POST https://api.deepseek.com/v1/tools/search. query ist Pflicht, 1 bis 128 Zeichen, nicht nur Leerzeichen. count ist 1 bis 50 und standardmäßig 10. ori_question ist optional, ebenfalls 1 bis 128 Zeichen. localization ist eine optionale IP. need_content ist standardmäßig false. Unbekannte Felder werden ignoriert. Operatoren, die durchgereicht werden: site:, -site:, -, -"...", "...", lang:, after: und before:.

{
  "query": "DeepSeek site:api-docs.deepseek.com after:2026-11-01",
  "count": 10,
  "need_content": false
}

Fetch ist POST https://api.deepseek.com/v1/tools/fetch. Das einzige Feld ist url, höchstens 8.192 Zeichen, HTTP oder HTTPS, mit Host und ohne Benutzername oder Passwort. Der Körper ist title und content als Markdown. Fehlt der Titel, ist er ein leerer String.

{
  "url": "https://api-docs.deepseek.com/updates"
}
FeldWas Sie speichern
rerank_score0 bis 3. 1,5 und darüber gilt im Leitfaden als hochwertig
authority0 bis 4. −1 heißt unbekannt. 3 und darüber ist hoch autoritativ
snippet / summaryKurz für die Oberfläche, lang für das Modell
contentLeer, wenn need_content nicht true ist oder die Seite keinen Inhalt hat
dateRFC 3339 in UTC, oder null

file_id, OCR und Sprache als JSON

Dateieingabe hat zwei Schritte. POST https://api.deepseek.com/files, purpose vor file. text_recognition lässt Diagramme weg. rich_layout_recognition schneidet Abbildungen in den Text und verbraucht Bild-Tokens. Das Dateiobjekt kommt erst nach dem Parsen. id sieht aus wie file-api-.... Ein Abbruch bricht ein danach erfolgreiches Parsen nicht ab: die Datei wird gespeichert und berechnet. Original und Parse lassen sich nicht herunterladen. Chat Completions verweist so darauf:

{
  "role": "user",
  "content": [
    {
      "type": "file",
      "file_id": "file-api-xxxxxxxxxxxxxxxx"
    },
    {
      "type": "text",
      "text": "Summarize the revenue chart."
    }
  ]
}

Messages braucht den Header anthropic-beta: files-api-2025-04-14 und einen document-Block mit source.type file. Responses nutzt input_file und file_id. Ein geparstes Dokument kann nicht als Bildblock gesendet werden. Bytes oder eine Datei-URL gehören nicht in die Chat-Anfrage. Eine Anfrage darf höchstens 20 Dokumente und 8 MiB Text nennen. Der volle Parse bleibt in späteren Runden im Kontext. Zu lang ergibt 400. Nichts wird still abgeschnitten.

Grenzen: PDF, Word, PowerPoint und gängige Bilder, das Format kommt aus den Bytes. 100 MiB, sonst 413. 1.000 Seiten. 120 Sekunden Upload, sonst 408. 120 Sekunden Parsen, sonst 504. 15 laufende Dokument-Uploads je Konto. Passwortgeschützte Dateien ergeben 400. Klartext, csv, json, Quelltext, xlsx, xls, epub und mobi nutzen purpose user_data und werden nicht seitenweise berechnet. Diese Dateien enden bei 32 MiB, der Text bei 8 MiB. AZW3 und DRM-E-Books werden nicht unterstützt.

Parsen kostet 0,225 $ je 1.000 Seiten, einmal, nur bei Erfolg. Spätere Chat-Runden berechnen Input-Tokens, nicht erneut Seiten. OCR hat denselben Seitenpreis auf POST /v1/tools/ocr und geht nicht in die Files-API. Es ist Multipart, file plus purpose, kein JSON-Körper. ASR ist Multipart-Audio, kein JSON. TTS ist JSON, POST /v1/tools/tts:

Der Listenpreis für TTS ist 0,45 $ je 10.000 Zeichen, der veröffentlichte Aktionspreis 0,225 $. Ein chinesisches Zeichen zählt als 2. Jedes andere Zeichen zählt als 1. Stimmen sind stella (Standard) und tide. Es gibt kein Sprachfeld. Der Listenpreis für ASR ist 0,116 $ je Audiostunde, Aktionspreis 0,058 $, abgerechnet je Sekunde, ein Bruchteil wird auf 1 Sekunde aufgerundet. Die Preisseite nennt kein Enddatum für den halben Preis.

{
  "text": "Hello from DeepSeek.",
  "voice_id": "stella",
  "format": "wav",
  "filter_markdown": true
}

safety_check und Ablehnungs-JSON

Für einen Dienst, den die Öffentlichkeit erreicht, setzen Sie safety_check auf {"level":"high"}. low entspricht dem Weglassen. Jedes andere Level ergibt 400. Der Parameter ersetzt nicht Ihre eigene Prüfung, Registrierung oder Kennzeichnung. Input, der durchfällt, ergibt 400 Content Exists Risk. Diese Input-Tokens werden trotzdem berechnet, zum Cache-Treffer-Preis. Nach dem Modell bleibt die Verbindung offen, während die Ausgabe geprüft wird. Bereits gestreamter Text lässt sich nicht zurückholen. Ersetzen Sie, was Sie gezeigt haben. Tokens vor der Ablehnung werden berechnet. Prüftokens stecken in den Output-Tokens und zusätzlich in usage.output_tokens_details.safety_tokens bei Messages und Responses oder in usage.completion_tokens_details.safety_tokens bei Chat. Ein blockiertes Bild kann einen Pfad wie messages.1.content.0 nennen, in stop_details.explanation, einem Refusal-Inhalt oder message.refusal. Eine Anfrage mit Web-Tools und ohne safety_check kann trotzdem mit einer Ablehnung enden.

APIJSON der Ablehnung
Messagesstop_reason refusal, stop_details.type refusal. Ohne Stream fallen Denk- und Antworttext weg, Tool-Blöcke und ein leerer Textblock bleiben
Responsesstatus incomplete, incomplete_details.reason content_filter. output behält nur ausgeführte web_search_call-Einträge
Chatfinish_reason content_filter. content ist leer. annotations entfällt. server_tool_calls bleibt, das Denken jedes Schritts wird geleert

tool_search abrechnen, nicht web_search_requests

Tokens und Tools stehen auf getrennten Zeilen. Flash-Preise gelten je 1.000.000 Tokens. Spitzenzeiten sind 01:00–04:00 und 06:00–10:00 UTC, Montag bis Freitag, ohne chinesische gesetzliche Feiertage. Jede andere Stunde ist Nebenzeit, Wochenenden und chinesische Feiertage den ganzen Tag. Die Nebenzeit ist die Hälfte der Spitze. cache_creation_input_tokens bleibt 0.

FensterCache-Treffer / 1MCache-Fehl / 1MAusgabe / 1M
Nebenzeit$0.003$0.15$0.60
Spitze$0.006$0.30$1.20

Suche und Web-Fetch kosten 0,75 $ je 1.000 erfolgreiche Nutzungen, ob das Modell das Tool rief oder Sie /v1/tools/search oder /v1/tools/fetch riefen. Eine Tool-Suche mit Treffern wird pro Query berechnet, drei Queries zählen als drei. count ändert den Preis der Search-API nicht. HTTP 200 mit leerem results-Array wird nicht berechnet. Fetch nur, wenn Seiteninhalt zurückkommt. Eine Seite, die die Sicherheitsprüfung danach durch url_not_allowed oder unavailable ersetzt, wurde trotzdem geholt und wird berechnet. Dieselbe Seite in der tiefen Denksuche erneut zu öffnen ist kostenlos. find_in_page ist kostenlos.

Search ist auf 100 Anfragen je Sekunde und Konto begrenzt. Fetch auf 25, plus eine Grenze je Domain. Die Grenzen gelten je Konto, nicht je Schlüssel, und getrennt vom Flash-Nebenläufigkeitslimit von 2.500. Im Leitfaden meldet eine Zitatsuche mit zwei Queries web_search_requests 1 und tool_search 2. Speichern Sie tool_search, tool_fetch und tool_image_search. Addieren Sie web_search_requests nicht dazu. Bei Responses und Chat entfällt dieses Trio in server_tool_use, wenn alle drei 0 sind.

Schlägt die Erzeugung fehl, nachdem der HTTP-Status schon 200 ist, ist der Körper ein Fehler plus usage. Messages-Streaming endet mit einem error-Ereignis, danach kommt kein message_delta. Prüfen Sie den Körper. Ein SDK wirft bei Status 200 nicht. Das veröffentlichte Beispiel dieser Suche mit zwei Queries. thinking_tokens und safety_tokens stehen nicht auf diesem Objekt. Sie erscheinen extra, wenn Denken an ist oder safety_check high ist, und stecken schon in 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 vor dem Start prüfen

  1. Der Körper hat deepseek-flash. Messages-Tools haben type und name. Denken ist disabled, wenn Sie die Zitatsuche wollten.
  2. Eine öffentliche App sendet safety_check.level high. response_format und text.format bleiben auf diesen Aufrufen text.
  3. Der Parser ordnet tool_use_id und kind zu und behält signature für die nächste Runde.
  4. Die Rechnung nutzt tool_search, tool_fetch und tool_image_search, plus Cache-Fehl-Input, Cache-Treffer-Input und Output. Sie addiert web_search_requests nicht.
  5. Eine eigene query hat 1 bis 128 Zeichen. count ist 1 bis 50. Leere Treffer sind keine Gebühr.

Prüfen Sie das JSON lokal mit dem JSON-Validator, JSONPath ($.usage.server_tool_use.tool_search) und JSON Diff gegen die vorige Anfrage. Nichts wird hochgeladen.

FAQ

Ändert thinking die Suche?

Ja. thinking.type disabled ist eine Websuche mit Zitaten, kind ist search. enabled ist die tiefe Denksuche: search, open_page und find_in_page, etwa 20 Aufrufe, kind ist deep_search. Denken ist der Standard. Sind Denken und deepseek_web_search beide an, läuft deepseek_read_url in dieser Runde nicht.

Kann tool_choice deepseek_web_search erzwingen?

Nein. Der Name ergibt 400, deepseek_web_search cannot be forced. Das Modell entscheidet. tool_choice none schaltet die deklarierten Web-Tools aus, auch das Lesen von URLs. Bei Responses und Chat gilt required als auto.

Soll die Rechnung web_search_requests nutzen?

Nein. Die Zahl enthält Fehler und ist nur zur Anzeige. Abrechnen Sie tool_search, tool_fetch und tool_image_search. Im Leitfaden meldet ein Suchblock mit zwei Queries web_search_requests 1 und tool_search 2. Eine Suche mit Treffern wird pro Query berechnet. Leere oder fehlgeschlagene Suchen nicht.

Macht POST /v1/tools/search eine Bildsuche?

Nein. Bildsuche läuft nur in deepseek_web_search. kind ist image_search oder deep_image_search, queries ist leer. Jedes Bild zählt als eine Suche, jede vom Modell gewählte Region als eine weitere.

Was sendet ein öffentlicher Dienst für die Sicherheit?

DeepSeek sagt: ein öffentlicher Dienst setzt safety_check mit level high. low entspricht dem Weglassen. Riskanter Input ergibt 400 Content Exists Risk, diese Input-Tokens werden zum Cache-Treffer-Preis berechnet. Eine Ablehnung ist stop_reason refusal, bei Responses incomplete mit content_filter, bei Chat finish_reason content_filter.

Kann ich eine Antwort fortsetzen, die gesucht hat?

Nein. Eine Antwort mit deepseek_web_search oder deepseek_read_url ergibt 400. Senden Sie die vorige Anfrage erneut. In der nächsten Runde geben Sie die Assistant-Blöcke unverändert zurück, einschließlich kind und signature. Ohne gültige Signatur gelingt die Anfrage, die Seite kommt aber nicht in den Kontext zurück.

Kurz

Die Tools vom 13. November 2026 ändern die Anfrage, die Blöcke, die Sie speichern, und eine zweite Zeile auf der Rechnung. Deklarieren Sie deepseek_web_search und deepseek_read_url auf deepseek-flash. Denken aus für die Zitatsuche, an für die tiefe Denksuche. Öffentliche Apps setzen safety_check.level auf high. Rechnen Sie tool_search ab, nicht web_search_requests.