11月13日に DeepSeek がアプリのツールを API で開いたあと、deepseek-flash の JSON で deepseek_web_search、deepseek_read_url、safety_check をどう置き、tool_search をトークンと分けて請求するか

モデル名だけでは検索はオンになりません。tools、thinking、safety_check が JSON を決めます。請求回数は tool_search です。

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_idPDF、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.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 は常に空文字です。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_score0から3。ガイドでは1.5以上が高品質
authority0から4。−1 は不明。3以上は権威が高い
snippet / summary短い方は UI、長い方はモデル向け
contentneed_content が true でないとき、または内容がないときは空
dateRFC 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
Messagesstop_reason が refusal、stop_details.type が refusal。非ストリームは思考と回答文を外し、ツールブロックと空の text を1つ残す
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 は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

  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 バリデーター、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 ではありません。