著者注:deepseek-flash はすでに組み込みのウェブ検索に対応していますが、思考スイッチのオン・オフで検索方法が変わり、課金はクエリ単位でカウントされ、次のターンには回答本文だけが残ります。本記事では、通常のツール呼び出しと異なる3つのポイントと、モデル自身に検索させるべきでない場面を整理します。
2026-11-13、DeepSeek は公式に、アプリ内の対話機能を API へ開放すると発表しました。今回この機能を備えるのは deepseek-flash のみで、対応バージョンは DeepSeek-V4.1-Flash-1017 です。deepseek_web_search を宣言するだけで、deepseek-flash が自分でウェブにアクセスできるようになります。ツール呼び出しとコンテキストの結合はすべてサーバー側で行われます。
多くの人はこれを「スイッチをひとつオンにすれば、あとは通常の関数呼び出しと同じ」と捉えるでしょう。これは単なるスイッチではありません。思考をオンにするかどうかで検索方法が変わり、レスポンスに表示される回数は課金回数ではなく、次のターンになると、モデルが検索・閲覧・思考した内容はコンテキストに残りません。
本記事の価値:読み終えると、deepseek-flash が思考・課金・次のターンという3点で通常のツール呼び出しとどう異なるかが分かり、モデル自身に検索させるべき場面と、プログラム側で検索させるべき場面を判断できるようになります。

deepseek-flash は検索するが忘れる:3つの核心ポイント
まず結論から。以下の表は、deepseek-flash の内蔵検索と、よく知られている「モデルが呼び出しを発行 → プログラムが実行 → 結果を返す」流れとの3つの違いを示しています。
| 要点 | deepseek-flash の実際の動作 | 通常の関数呼び出しとの違い |
|---|---|---|
| 思考 | 思考オフ時は引用付きのWeb検索または画像検索。思考オン時は、より深く考える検索に変わる | 同じツール定義でも、思考スイッチによって2種類のフローになる |
| 課金 | 内蔵検索はクエリ数で回数を数え、1回の検索に3つのクエリがあれば3回と数える | 「1回呼び出すごとに1回」ではない。usage の回数も課金回数とは一致しない |
| 次のターン | 検索結果、開いたページ、思考は次のターンに引き継がれず、回答本文だけが残る | 通常の関数呼び出しの結果は自分で履歴に書き戻すのが普通なので、保持できる |
deepseek-flash の3つの違いが生まれる理由
3つの違いはすべて、同じ設計に由来します。ツール呼び出しがサーバー側で行われるのです。途中のツール呼び出しメッセージは見えませんし、どの内容を履歴に書き戻すかを決める機会もありません。サーバーが検索、読み取り、コンテキストの結合を代行し、回答が終わると中間過程もまとめて破棄されます。
この接続方法はとても手軽ですが、その代償として制御権が減ります。どのクエリが送信されたか、どのページを開いたか、次のターンで前のターンの原文を参照できるかは、すべてサーバー側が決めます。これを理解すれば、続く3節の内容もすべて筋が通ります。
deepseek-flash の思考スイッチが検索をどう変えるか
公式ドキュメント「Build a Chatbot」が示す対照は明確です。同じ deepseek_web_search を宣言しても、思考スイッチのオン・オフで動作が変わります。

| 思考スイッチ | 宣言するツール | 実際の動作 | リンクを別途読むか |
|---|---|---|---|
| オフ | deepseek_web_search |
質問に応じてWebページや画像を検索し、回答に引用を付ける | 該当なし |
| オフ | deepseek_web_search + deepseek_read_url |
引用付きで検索し、ユーザーメッセージ内のリンクは別途取得する | する |
| オン | deepseek_web_search |
深い思考検索。多段推論の中で自ら検索し、自らページを開く | どのページを開くかはモデル自身が決める |
| オン | deepseek_web_search + deepseek_read_url |
引き続き深い思考検索 | 単独ではリンクを読まない |
| 任意 | deepseek_read_url のみ |
ユーザーメッセージ内のリンクを識別して取得する | する |
deepseek-flash の深い思考検索における2つの落とし穴
1つ目の落とし穴はリンクの読み取りです。ユーザーがリンクを貼ったとき、deepseek_read_url を宣言していれば必ずそのページを読むと思うかもしれません。しかし思考がオンの状態で deepseek_web_search も同時に宣言していると、そのラウンドは深い思考検索になり、リンクは単独では読まれません。そのページを開くかどうかは、モデルが推論の中で決めます。製品が「リンクを貼れば原文を読む」と約束しているなら、思考をオフにするか、そのラウンドでは deepseek_read_url だけを宣言してください。
2つ目の落とし穴はパラメータです。deepseek_web_search、deepseek_read_url、safety_check を high に設定する、あるいは title をオンにすると、サーバー側は temperature や top_p といった一連のサンプリングパラメータを無視します。3つのプロトコルで無視されるパラメータのリストは完全には同じではありません。max_tokens(Responses プロトコルでは max_output_tokens)は引き続き有効ですが、これは1ラウンド内の各推論ステップの出力を制限するものであり、ラウンド全体の合計ではありません。そのため、深い思考検索で max_tokens を使って1ラウンドのコスト上限を見積もるのは正確ではありません。
deepseek-flash のウェブ検索の課金はどう計算されるのか
課金の計算はもっとも間違えやすい部分です。ここには2つのカウント単位があるため、以下で分けて説明します。

| シナリオ | カウント単位 | 1回と数える条件 | 課金されない場合 |
|---|---|---|---|
| 組み込みウェブ検索 | query | 結果を返す1回の検索に含まれる query の数だけカウント | 失敗、結果なし |
| 組み込み画像検索 | 画像 + 領域 | 画像1枚で1回、モデルが画像内で枠指定した各領域ごとにさらに1回 | 失敗、結果なし |
| 組み込みリンク読み取り | 取得成功したページ | 取得できた時点で課金。その後セキュリティ審査により url_not_allowed や unavailable に置き換えられたページも含む |
取得できなかったリンク |
| 深い思考の検索における重複アクセス | 実際の取得 | 実際にネットから取得した1回だけ課金 | 同じページを再度開いた場合、ページ内移動、内容が検索結果とともに返却済みの場合 |
| 独立した Search / Fetch インターフェース | 成功したリクエスト | HTTP 200 かつ結果がある場合のみ1回。count はこの価格を変えない |
失敗、空の結果、タイムアウト |
公式の価格表(2026-11-15)では、Search(テキストと画像)と Web fetch はいずれも1000回あたり0.75ドルです。単価は同じですが、組み込みツールの「1回」は1つの query を指し、独立インターフェースの「1回」は1つの成功したリクエストを指すため、両者の回数をそのまま比較することはできません。
deepseek-flash の usage フィールドの読み取りに注意
返される usage には、よく似て見える2つのフィールド群がありますが、意味は異なります。
| フィールド | 意味 | 照合に使えるか |
|---|---|---|
web_search_requests |
表示用の検索結果ブロック数(エラーを含む) | 不可 |
web_fetch_requests |
表示用の取得結果ブロック数(エラーを含む) | 不可 |
tool_search |
課金対象の検索回数 | 可 |
tool_fetch |
課金対象の取得回数 | 可 |
tool_image_search |
課金対象の画像検索回数 | 可 |
web_search_requests で使用量を集計すると、失敗した結果ブロックが含まれるため数字が多めに出る可能性があります。さらに、1回の検索に含まれる query の数も分かりません。照合には tool_* の3つのフィールドを使ってください。
ツール料金はトークン料金とは別に請求されます。公式の deepseek-flash のトークン価格はピーク時とオフピーク時に分かれており、ピーク時は月曜から金曜の UTC 01:00–04:00 と 06:00–10:00(中国の法定祝日を除く)です。それ以外の時間はすべてオフピーク時となり、オフピーク時の価格はピーク時の半額です。
deepseek-flash は次のターンでなぜ「忘れる」のか
公式ドキュメントによると、マルチターンの会話では、前のターンの検索結果・開いたページ・思考の内容は次のターンのコンテキストに引き継がれず、回答の本文だけが残ります。
つまりタイトルの「忘れる」はコンテキストが消えてしまうことを指しており、モデルが検索できなかったという意味ではありません。前のターンで5つのページを読み、3か所の原文を引用していたとしても、次のターンで手元にあるのは自分が書いた回答だけです。ユーザーが「2番目のソースの原文はどう書かれていたの?」と重ねて尋ねると、モデルはもう一度検索し直す(ツール利用料がまた発生する)か、自分の回答をもとに推測するしかありません。

deepseek-flash に自分で検索させるべきでないケース
次のようなケースでは、何を検索するかをモデルに任せるより、プログラム側で決めたほうが適しています。
- ターンをまたいで原文を引用する必要がある:法令の条文、契約書、長文ドキュメントのQ&Aなど、次のターンでも原文に基づいて回答する場合。
- 請求額を予測できるようにしたい:深い思考を伴う検索では、いくつのクエリを投げるか、何ページ開くかを事前にコントロールできません。
- 情報源を限定したい:特定のサイトだけを許可する、あるいは特定のサイトを必ず除外する場合。
- リンクを貼ったときは必ず原文を読ませたい:思考をオンにすると、リンクが個別に読み込まれないことがあります。
- APIキーが DeepSeek 公式サイトのものではない:利用しているプラットフォームが組み込みツールに接続済みとは限りません。次の節で詳しく説明します。
deepseek-flash クイックスタート:Webページをコンテキストに残すには
Webページをコンテキスト内に残したい場合、ポイントは「検索」と「回答」を分離することです。プログラムが検索・取得APIを呼び出し、本文を自分で messages に組み込んでから deepseek-flash に回答させます。こうすればWebページの原文は自分で保存した履歴の中に残り、次のターンでも失われません。
APIYI apiyi.com では、すでに2つの独立したエンドポイント deepseek-search と deepseek-fetch が利用できます(2026-10-21 公開)。これらは対話モデルではなく、トークンを消費しません。成功したリクエスト回数に応じて課金され、課金ルールは公式サイトの独立エンドポイントと同じです。手順は次のとおりです。
- APIYI コンソールで新しいAPIキーを作成し、グループは
defaultまたはsvipを選択します。ClaudeCode グループを使うと 503 が返り、エラーメッセージはno available channels for model deepseek-searchです。 - 検索:
POSTで/v1/tools/searchに送信します。ベースURLはhttps://api.apiyi.comで、リクエストボディにmodelフィールドは不要です。 queryは必須で、1〜128文字。site:、-site:、引用符、lang:、after:、before:をサポートしますcountは 1〜50、デフォルトは 10 で、料金には影響しませんneed_contentはデフォルトfalse。true に設定すると本文も一緒に返しますlocalizationにはユーザーの IP を指定します。zh-CNのような言語コードを指定すると 400 が返ります- フェッチ:読みたいリンクを選択し、
POSTで/v1/tools/fetchに送信します。urlはドメインを含む http または https アドレスである必要があり、最大 8192 文字です。ユーザー名とパスワードを含めてはいけません。 - 回答:抜き出した本文を1つのメッセージとして messages に入れ、
deepseek-flashを呼び出します。OpenAI 互換のbase_urlはhttps://api.apiyi.com/v1に設定します。 - 保持:このWebページ本文を自分の会話履歴に書き込み、次のターンでも引き続き含めます。または、トークンを抑えるために要約だけを残します。
上流のレート制限はドキュメントによると、Search は 100 QPS、Fetch は 25 QPS で、同一ドメインには別途制限があります。ドキュメントの再テストでは、次の2点も指摘されています。文字化けしたキーワードでも数件の結果が返り、通常どおり課金される可能性がある点。一部のサイトでは存在しないページに対してトップページを返し(ソフト404)、Fetch はこれを成功リクエストとして課金する点です。フェッチする前に、リンクを自分で一度フィルタリングしておくのがおすすめです。
🎯 技術アドバイス:ターンをまたいで原文を引用する必要がある場面では、まず APIYI apiyi.com で新規ユーザー向けの無料テスト枠を利用し、「search → fetch → deepseek-flash」の一連の流れを動作確認することをおすすめします。本文の抜き出し長さと課金回数が想定どおりであることを確認してから本番リリースしてください。
deepseek-flash のキーを公式サイト以外で使う際の注意点
まず明確にしておきたい点があります。2026-11-15 時点では、APIYI のモデル一覧表にもリアルタイム情報にも、deepseek-flash が deepseek_web_search をサポートしているとは記載されていません。リアルタイム情報で最新の DeepSeek 関連項目は 2026-11-11 のエコノミー版リリースで、11 月 13 日時点ではこの App API はまだ登場していません。そのため APIYI 上で deepseek-flash を呼び出す場合、deepseek_web_search を宣言すればモデル自身が検索できると考えることはできません。現時点での位置づけは「回答モデル」です。
下表は 2026-11-15 の価格データです。token 価格の単位は USD / 100万 token、従量課金モデルの単位は USD / 回です:
| モデル | APIYI apiyi.com 表示価格 | 公式サイト比較 | 備考 |
|---|---|---|---|
deepseek-flash |
入力 0.3、出力 1.2、キャッシュ読み込み 0.006 | ピーク時は同じく 0.3 / 1.2 / 0.006、オフピーク時は半額 | 一覧表にはオフピーク半額の記載なし |
deepseek-search |
0.0009 / 回(つまり 0.90 / 1000 回) | 0.75 / 1000 回 | グループは default、svip のみ |
deepseek-fetch |
0.0009 / 回(つまり 0.90 / 1000 回) | 0.75 / 1000 回 | グループは default、svip のみ |
機能ページに書かれた 0.90 USD / 1000 回と、一覧表の 0.0009 USD / 回は同じ表示価格です。APIYI のドキュメントによると、チャージ時のボーナスを加味した場合、大口チャージ顧客の実質支払額は約 0.75 USD / 1000 回で公式サイトと同等、一般ユーザーの実質支払額は約 0.82 USD / 1000 回になります。この2つはボーナス換算後の数字であり、一覧表の表示価格ではありません。価格は税込みで、請求書の発行も可能です。
また、OCR、ASR、TTS は APIYI ではまだ提供していません。このモデルはできるだけ早く提供開始する予定です。モデル名と価格はプラットフォームのモデル一覧を基準にしてください。
💡 選択のヒント:業務で公式サイト組み込み検索の「モデルが自ら多段階検索する」機能が必要なら、現時点では公式サイトのキーを使う必要があります。原文を保持できること、請求が予測可能であることを重視するなら、APIYI apiyi.com の独立したインターフェースと deepseek-flash の回答を組み合わせれば、プロセス全体を自分でコントロールできます。
よくある質問(FAQ)
Q1: deepseek-flash の組み込み検索とは何ですか?
deepseek-flash(V4.1-Flash-1017)が提供するサーバーサイドツール `deepseek_web_search` のことで、Messages、Responses、Chat Completions の3つのプロトコルすべてで利用できます。ツール呼び出しとコンテキストの結合はサーバー側で行なわれ、ツール料金はトークン料金とは別に課金されます。
Q2: deepseek-flash 自身が検索する場合と、プログラムから Search / Fetch を呼び出す場合の違いは何ですか?
組み込み検索はクエリごとに課金され、途中結果は次のラウンドには残りません。独立したAPIは成功したリクエストごとに課金され、`count` は料金に影響しません。返却される本文を保持するかどうかはご自身で決められます。前者は導入が手軽で、後者は制御しやすいという特徴があります。
Q3: deepseek-flash のこのネット連携機能はいつリリースされたのですか?
DeepSeek 公式により 2026-11-13(北京時間 22:24)にリリースされ、ニュースページと更新ログは同日です。APIYI 上の `deepseek-search` と `deepseek-fetch` は 2026-10-21 に公開されたもので、今回のリリースとは別のものです。
Q4: エコノミー版や V4 Pro は自分で検索できますか?
公式の説明によると、この対話機能は deepseek-flash でのみ提供されており、deepseek-v4-pro やエコノミー版の ID には適用できません。APIYI のエコノミー版 `deepseek-v4-1-flash-economy-261017` は V4.1-Flash-1017 と同じ重みを読み込みますが、動作速度はより遅くなります。ドキュメントに記載された推定値は、最初のトークンまで約 2 秒、1 トークンあたり約 15 ミリ秒です。これは検索APIではありません。
Q5: APIYI で deepseek-flash に Web ページに基づいて回答させるにはどうすればよいですか?
`default` または `svip` のトークンを使って `/v1/tools/search` と `/v1/tools/fetch` を呼び出し、本文を messages に組み込んでから `deepseek-flash` を呼び出します。具体的なパラメータは APIYI apiyi.com ドキュメントセンターの DeepSeek Search / Fetch ページをご参照ください。
Q6: 外部にサービスを提供する際、セキュリティ設定で注意すべき点は何ですか?
公式の要件では、外部にサービスを提供する際は必ず `safety_check` を有効化し(ドキュメントの例では level は high)、コンテンツセーフティ審査、大規模言語モデルの登録、AI 表示を自身で完了させる必要があります。有効化すると `temperature` などのサンプリングパラメータは無視され、モデルが拒否した場合の `stop_reason` は `refusal` になります。モデルの安全性は出力トークンに応じて課金され、単価は別途記載されません。
Q7: どのクエリでも検索結果が得られなかった場合、料金は発生しますか?
組み込み検索が失敗した場合や結果がなかった場合は課金されません。独立したAPIは HTTP 200 かつ結果がある場合にのみ課金され、400 や取得失敗の 404 では課金されません。ただしドキュメントの再テストによると、文字化けしたキーワードやソフト 404 では依然として課金される可能性があります。
deepseek-flash は検索もするが忘れる 主なポイント
- 思考が検索方法を変える:思考オフは引用付きの検索、思考オンは多段階の深い思考検索です。
- リンクが必ずしも読まれるわけではない:思考オンで
deepseek_web_searchを宣言している場合、リンクは個別には読まれません。 - 課金は query ごとにカウント:1回の検索に3つの query があれば3回とカウントされ、失敗や空の結果は課金されません。
- 照合は tool フィールドで:
web_search_requestsは表示専用で、課金回数はtool_searchなどのフィールドで確認します。 - 次のラウンドには回答だけが残る:ウェブページ、ページ、思考はすべて破棄され、「忘れる」とはコンテキストのことです。
- ウェブページを保持したいなら自分で検索する:APIYI apiyi.com で
deepseek-searchにdeepseek-fetchを加えて使い、それを deepseek-flash に渡します。
まとめ
deepseek-flash は検索もするが忘れるので、3つの点に注意が必要です:
- 思考:同じ
deepseek_web_searchの宣言でも、思考のオン/オフによって2つの異なるフローを通り、リンクを読む動作もそれに伴って変わります。 - 課金:組み込みツールは query、画像、選択領域ごとにカウントし、独立したインターフェースは成功したリクエストでカウントします。2つの単位を混ぜて計算しないでください。
- 次のラウンド:回答本文のみが保持されるので、ラウンドをまたいで原文を引用する必要がある場合は、プログラム自身が検索して内容を保存すべきです。
APIYI のキーをお持ちの場合、現時点のドキュメントには deepseek-flash が組み込み検索に接続済みであるとは書かれていません。まず APIYI apiyi.com の無料枠で、独立したインターフェースに deepseek-flash を組み合わせた構成を一度試してから、公式サイトの組み込み検索が必要かどうかを判断するとよいでしょう。
📚 参考資料
- DeepSeek ニュースページ(2026-11-13):App機能をAPIに開放する公告
- リンク:
api-docs.deepseek.com/zh-cn/news/news261113 -
説明:
deepseek-flashのみがこの機能セットを備えていることを確認 -
DeepSeek Build a Chatbot ガイド:思考スイッチとツール組み合わせの挙動対照
- リンク:
api-docs.deepseek.com/guides/build_a_chatbot -
説明:深い思考の検索、リンク読み取り、マルチターン文脈のルール
-
DeepSeek Web Tools ガイド:組み込みツールの Usage and Billing
- リンク:
api-docs.deepseek.com/guides/web_tools -
説明:queryごとの回数課金、
usageフィールドの意味 -
DeepSeek 料金ページ:トークン価格、ピーク時とオフピーク時、ツール単価
- リンク:
api-docs.deepseek.com/quick_start/pricing -
説明:2026-11-15 時点のデータ
-
APIYI DeepSeek Search / Fetch ドキュメント:独立インターフェースのパラメータと課金
- リンク:
docs.apiyi.com/api-capabilities/deepseek-search-fetch/overview -
説明:グループ要件、パラメータ制限、ドキュメント再検証の説明
-
APIYI モデル一覧表:リアルタイムのモデルと価格
- リンク:
docs.apiyi.com/models - 説明:モデルと価格はこちらを基準とする
作者: APIYI 技術チーム
技術交流: APIYI apiyi.com のトップページからお気軽にお問い合わせください。その他の資料は docs.apiyi.com のドキュメントセンターでご覧いただけます。
