model を deepseek-flash にしても検索はオンになりません。 2026年11月13日、DeepSeek はチャットアプリの裏側のツールを API で開きました。名前 deepseek-flash は DeepSeek-V4.1-Flash-1017 です。旧名 deepseek-v4-flash と deepseek-v4-flash-vision-exp もここへ渡り、Flash の価格で請求されます。コンテキストは 100 万トークン。最大出力は 38.4 万。思考がデフォルトです。
このページは 2026年11月16日時点で、11月13日の変更履歴、ウェブツールのガイド、Search と Fetch のガイド、安全のガイド、価格ページに基づきます。3日前に Gemini 4 Carbon の usage を書きました。リクエストと請求を変える項目は tools、thinking、safety_check、usage.server_tool_use です。
11月13日に開いたもの
同じモデルが3つのエンドポイントでツールを受けます。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。後の2つは 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 | 最後のユーザーメッセージだけ。異なる URL は先頭10件まで |
| 安全 | safety_check.level = high | 入出力を審査。公衆向けサービスでは有効にする |
| ファイル | Files API の file_id | PDF、Office、画像を解析してから会話に入れる |
3つのエンドポイントのリクエスト JSON
Messages はツールを type と name の両方で書きます。Responses と Chat は type だけです。tool_choice でこれらの名前を指定すると 400、deepseek_web_search cannot be forced です。none は宣言したウェブツールを、URL 読み取りも含めて切ります。Responses と Chat の required は auto です。
allowed_domains、blocked_domains、user_location は送れません。同じツールを2回宣言できません。別のサーバーツールも混ぜられません。エラーは、他のツールはまだ deepseek_web_search、deepseek_read_url、safety_check、title と併用できない、と言います。Responses では web_search ツールと、text 以外の text.format が 400 です。Chat では web_search_options と、text 以外の response_format が 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 にあります。message_start の usage は最初の推論ステップだけです。
| 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 は常に空文字です。1ブロックに同じ URL は1回まで。ストリームでは citations_delta です。
Responses は呼び出しを web_search_call に置き、kind と action を付けます。回答は url_citation 注釈付きの output_text です。start_index と end_index は Unicode コードポイントです。Chat は message.server_tool_calls です。各ステップに reasoning_content と calls があります。message.content に引用マーカーはなく、引用は message.annotations です。message.reasoning_content は最後のステップだけです。
これらのツールを使った返答は続行できず、400 で前のリクエストを送り直すよう言われます。次のターンでは kind と signature を含めてそのまま返します。検索スニペットと以前の思考は後の文脈に戻りません。戻るのは回答文だけです。読んだページは signature から復元されます。read_link の data は常に空文字です。signature を落とすとリクエストは成功しますが、ページはありません。失敗コードは 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"
}
]
}
}単体の Search と Fetch の JSON
モデルではなくコードが検索するときは、生の 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 と Markdown の content です。タイトルがなければ空文字です。
{
"url": "https://api-docs.deepseek.com/updates"
}| フィールド | 保存する意味 |
|---|---|
rerank_score | 0から3。ガイドでは1.5以上が高品質 |
authority | 0から4。−1 は不明。3以上は権威が高い |
snippet / summary | 短い方は UI、長い方はモデル向け |
content | need_content が true でないとき、または内容がないときは空 |
date | RFC 3339 の UTC、または null |
file_id、OCR、音声 JSON
ファイル入力は2段階です。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 と、source.type が file の document ブロックが必要です。Responses は input_file と file_id です。解析済み文書を画像ブロックにはできません。バイト列やファイル URL をチャットに直接入れることもできません。1リクエストは文書20件まで、本文は合計8 MiB までです。後のターンでも解析全文が文脈に残ります。長すぎると 400 です。黙って切り詰めません。
上限は、PDF、Word、PowerPoint、一般的な画像で、形式はバイトから判定します。100 MiB を超えると 413。1,000ページ。アップロード 120 秒でなければ 408。解析 120 秒でなければ 504。アカウントあたり進行中の文書アップロードは15件。パスワード付きは 400。プレーンテキスト、csv、json、ソース、xlsx、xls、epub、mobi は purpose を user_data にし、ページ課金はありません。ファイルは 32 MiB、テキストは 8 MiB まで。AZW3 と DRM 付き電子書籍は非対応です。
解析は成功したときだけ、1,000ページあたり 0.225 ドルを1回です。その後の会話は入力トークンで、ページは再請求しません。OCR も同じページ価格で、POST /v1/tools/ocr は Files API に入りません。multipart の file と purpose で、JSON 本文ではありません。ASR は multipart の音声です。TTS は JSON で、POST /v1/tools/tts です。
TTS の定価は1万文字あたり 0.45 ドル、公表されている期間限定価格は 0.225 ドルです。漢字は2文字、それ以外は1文字です。声は stella(既定)と tide。言語フィールドはありません。ASR の定価は音声1時間あたり 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 で、その入力トークンはキャッシュヒット価格で請求されます。モデルが終わったあとも、出力の審査が終わるまで接続は開いたままです。すでに流したテキストは取り戻せません。表示した答えを自分の拒否文に替えてください。拒否より前のトークンは請求されます。審査トークンは出力トークンに含まれ、Messages と Responses では usage.output_tokens_details.safety_tokens、Chat では usage.completion_tokens_details.safety_tokens にも出ます。止めた画像は messages.1.content.0 のようなパスを、stop_details.explanation、refusal の内容、または message.refusal に置くことがあります。ウェブツールを宣言し safety_check がないリクエストも、拒否で終わることがあります。
| API | 拒否の JSON |
|---|---|
| Messages | stop_reason が refusal、stop_details.type が refusal。非ストリームは思考と回答文を外し、ツールブロックと空の text を1つ残す |
| 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 は100万トークンあたりの価格です。ピークは月曜から金曜の UTC 01:00–04:00 と 06:00–10:00 で、中国の祝日を除きます。それ以外はオフピークで、週末と中国の祝日は終日オフピークです。オフピークはピークの半分です。cache_creation_input_tokens は 0 のままです。
| 時間帯 | キャッシュヒット / 100万 | ミス / 100万 | 出力 / 100万 |
|---|---|---|---|
| オフピーク | $0.003 | $0.15 | $0.60 |
| ピーク | $0.006 | $0.30 | $1.20 |
検索とウェブ取得は、成功1,000回あたり 0.75 ドルです。モデルがツールを呼んでも、自分で /v1/tools/search や /v1/tools/fetch を呼んでも同じです。結果が返ったツール検索はクエリごとに請求され、3クエリなら3回です。count は Search API の単価を変えません。HTTP 200 で results が空配列なら請求されません。Fetch はページ内容が返ったときだけです。その後、安全審査が url_not_allowed や unavailable に置き換えても、取得は済んでいるので請求されます。深い思考検索で同じページを再度開くのは無料です。find_in_page も無料です。
Search はアカウントあたり毎秒100、Fetch は25で、ドメインごとの上限もあります。上限はキーではなくアカウントで、Flash の同時実行 2,500 とは別です。ガイドの2クエリの例は web_search_requests 1、tool_search 2 です。保存するのは tool_search、tool_fetch、tool_image_search です。web_search_requests を足しません。Responses と Chat は、この3つがすべて 0 のとき server_tool_use からその組を省きます。
HTTP がすでに 200 のあと生成が失敗すると、本文はエラーと usage です。Messages のストリームは error イベントで終わり、その後に message_delta はありません。本文を見てください。SDK はステータス 200 では例外を出しません。公開されている、その2クエリの例です。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.levelをhighにする。これらの呼び出しでは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 バリデーター、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 は走りません。
tool_choice で deepseek_web_search を強制できますか?
できません。名前を指定すると 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 です。ウェブツールのガイドでは、クエリ2件の検索ブロック1つが web_search_requests 1、tool_search 2 です。結果が返った検索はクエリごとに課金されます。空や失敗は課金されません。
POST /v1/tools/search は画像検索ですか?
違います。画像検索は deepseek_web_search の中だけです。kind は image_search または deep_image_search で、queries は空配列です。画像1枚が検索1回、モデルが選んだ領域もそれぞれ1回です。
公開サービスは安全確認をどう送りますか?
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 を含め、アシスタントのブロックをそのまま返します。有効な signature がなくてもリクエストは成功しますが、ページは文脈に戻りません。
まとめ
11月13日のツールは、リクエストと、保存すべきブロックと、請求のもう1行を変えます。 deepseek-flash に deepseek_web_search と deepseek_read_url を宣言します。引用検索は思考オフ、深い思考検索は思考オンです。公開アプリは safety_check.level を high にします。請求は tool_search で、web_search_requests ではありません。