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ähigkeit | JSON, das sie einschaltet | Was zurückkommt |
|---|---|---|
| Websuche | deepseek_web_search, Denken aus | Das Modell sucht, wenn es das für nötig hält, und zitiert |
| Tiefe Denksuche | deepseek_web_search, Denken an | search, open_page, find_in_page, etwa 20 Aufrufe |
| URL lesen | deepseek_read_url | Links nur in der letzten Nutzernachricht, höchstens die ersten 10 verschiedenen URLs |
| Sicherheit | safety_check.level = high | Prüfung von Ein- und Ausgabe. Für einen öffentlichen Dienst verlangt |
| Dateien | Files-API file_id | PDF, 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.action | name | kind | Ergebnis |
|---|---|---|---|
search | deepseek_web_search | deep_search beim Denken, sonst search | web_search_tool_result |
open_page | deepseek_web_search | deep_search | web_fetch_tool_result. data ist leer. Keine signature |
find_in_page | deepseek_web_search | deep_search | Gleiche Form. title ist null. Nicht berechnet |
read_link | deepseek_read_url | read_link | web_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"
}| Feld | Was Sie speichern |
|---|---|
rerank_score | 0 bis 3. 1,5 und darüber gilt im Leitfaden als hochwertig |
authority | 0 bis 4. −1 heißt unbekannt. 3 und darüber ist hoch autoritativ |
snippet / summary | Kurz für die Oberfläche, lang für das Modell |
content | Leer, wenn need_content nicht true ist oder die Seite keinen Inhalt hat |
date | RFC 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.
| API | JSON der Ablehnung |
|---|---|
| Messages | stop_reason refusal, stop_details.type refusal. Ohne Stream fallen Denk- und Antworttext weg, Tool-Blöcke und ein leerer Textblock bleiben |
| Responses | status incomplete, incomplete_details.reason content_filter. output behält nur ausgeführte web_search_call-Einträge |
| Chat | finish_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.
| Fenster | Cache-Treffer / 1M | Cache-Fehl / 1M | Ausgabe / 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
- Der Körper hat
deepseek-flash. Messages-Tools habentypeundname. Denken istdisabled, wenn Sie die Zitatsuche wollten. - Eine öffentliche App sendet
safety_check.levelhigh.response_formatundtext.formatbleiben auf diesen Aufrufentext. - Der Parser ordnet
tool_use_idundkindzu und behältsignaturefür die nächste Runde. - Die Rechnung nutzt
tool_search,tool_fetchundtool_image_search, plus Cache-Fehl-Input, Cache-Treffer-Input und Output. Sie addiertweb_search_requestsnicht. - Eine eigene
queryhat 1 bis 128 Zeichen.countist 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.