要約： DeepSeek Search API が無料なのは3つのコーディングツール内だけで、しかも2026年10月31日 16:00 UTCまでの期間に限られます。Claude Code、Codex、DeepSeek Harness がサーバーサイドで行う Search および Fetch 呼び出しは、それまで無料です。それ以降は、またエンドポイントへの直接呼び出しについてはすべて、エンドポイントごとに成功したリクエスト1,000件あたり$0.75を支払います。失敗した呼び出し、空の結果、タイムアウトには課金されません。
DeepSeek は2026年10月17日、DeepSeek-V4.1-Flash-1017 のリリースと同時に Search API と Fetch API を誰でも利用できるように公開しました。これらはエージェントに対して、クエリに対する最新のウェブ検索結果と、任意のページのクリーンな Markdown コピーを提供します。このガイドでは、何が無料か、無料期間終了後のコスト、レート制限、最初のリクエスト、そして Apidog CLI を使った両エンドポイントのテストについて説明します。
以下の事実はすべて、2026年10月28日に読んだ DeepSeek の Search & Fetch ガイド および 料金ページ に基づいています。
DeepSeek Search API は無料ですか？
はい、ただし2つの制限があります。どこから呼び出すか、そしていつ呼び出すかです。DeepSeek のドキュメントによると、DeepSeek Harness、Claude Code、Codex を通じて行われるサーバーサイドの Search および Fetch 呼び出しは「現在無料」です。これらの呼び出しに対するリクエスト単位の課金は、UTC+8 の2026年11月1日 00:00、つまり2026年10月31日 16:00 UTCに開始されます。
| 経路 | 10月31日 16:00 UTC 以前の Search および Fetch のコスト | 以降 |
|---|---|---|
| DeepSeek API キーを使った Claude Code | $0 | 成功した呼び出し1,000件あたり $0.75 |
| DeepSeek API キーを使った Codex | $0 | 成功した呼び出し1,000件あたり $0.75 |
| DeepSeek Harness | $0 | 成功した呼び出し1,000件あたり $0.75 |
/v1/tools/search または /v1/tools/fetch への直接 POST
|
成功した呼び出し1,000件あたり $0.75 | 成功した呼び出し1,000件あたり $0.75 |
これが真のゼロドル経路でない理由となる2つの注意点があります。
- それでも資金のある DeepSeek API キーが必要です。 無料期間が対象とするのは検索呼び出しであり、モデルではありません。DeepSeek の Claude Code 統合ページ によると、検索結果の要約には追加の LLM リクエストが使われ、それらのトークンは通常のモデル料金で課金されます。
- 無料期間が対象とするのはサーバーサイドのツール呼び出しのみです。 ドキュメントではこれを3つのツールに限定しています。自分のコードがエンドポイントを呼び出す場合、最初の成功したリクエストから料金が発生します。
無料の検索ではなく無料の DeepSeek モデルを求めている場合は、DeepSeek は無料か のガイドにすべての経路が掲載されており、DeepSeek API キーを無料で ではキー自体について扱っています。
DeepSeek Search API と Fetch API が行うこと
DeepSeek Search API はクエリを受け取り、構造化されたウェブ検索結果を返します。タイトル、URL、スニペット、モデル向けのより長い要約、任意の全文コンテンツフィールド、関連性スコア、権威スコアです。DeepSeek Fetch API は1つの URL を受け取り、そのページのタイトルとコンテンツを Markdown として返します。この2つを組み合わせることで、エージェントは2回の呼び出しで検索と読み取りを行えます。
調査エージェントは通常、1回検索してから2、3ページをフェッチし、それぞれが無料期間終了後は別々の課金対象呼び出しとなります。Search は演算子をサポートしています: site:、-site:、"phrase"、-term、lang:en,ja、after:、before: です。
これは、無料ウェブ検索 API、Claude ウェブ検索 API、Perplexity Search API のまとめで他の選択肢と比較できます。
無料期間終了後の DeepSeek Search API の料金
無料期間が終わると、両エンドポイントは同じ方法で課金されます:
| Search API | Fetch API | |
|---|---|---|
| 料金 | 成功したリクエスト1,000件あたり $0.75 | 成功したリクエスト1,000件あたり $0.75 |
| 呼び出しあたり | $0.00075 | $0.00075 |
| 課金されるタイミング | HTTP 200 で空でない results 配列が返されたとき |
HTTP 200 でページコンテンツが返されたとき |
| 課金されない場合 | 失敗したリクエスト、空の結果、タイムアウト | 失敗したリクエスト、タイムアウト |
count は料金を変えますか？ |
いいえ | 該当なし |
料金は DeepSeek の残高から差し引かれ、料金ページによると、付与残高とチャージ済み残高の両方がある場合は付与残高が先に使われます。
1日に200タスクを実行し、各タスクが1回の検索と3回のフェッチを行う調査エージェントについて、簡単に計算してみましょう:
- 200回の検索 x $0.00075 = $0.15
- 600回のフェッチ x $0.00075 = $0.45
- 合計： 1日あたり$0.60、月あたり約$18（モデルトークンを除く）
count は料金を変えないため、ページングするのではなく1回の呼び出しで最大50件の結果を要求しましょう。モデル側では、deepseek-flash は100万入力トークンあたり$0.15（キャッシュミス、オフピーク時）、100万出力トークンあたり$0.60で、ピーク時には2倍になります。詳しくは DeepSeek V4.1 Flash の料金 をご覧ください。
DeepSeek Search API のレート制限
一部のサードパーティの記事では 5 QPS の制限が引用されています。DeepSeek 自身のガイドには異なる数値が記載されており、計画を立てる際はそちらを基準にすべきです:
- Search: 毎秒100クエリ
- Fetch: 毎秒25クエリ、加えて値が公開されていないドメインごとの制限
制限はアカウント単位で、すべての API キーに適用され、モデルの同時実行数とは別です。Search と Fetch は独立して計測されるため、Fetch のバーストが検索の予算を消費することはありません。超過すると HTTP 429 が返されます。
ドメインごとの Fetch 制限に注意してください。1つのドキュメントサイトから20ページをフェッチするエージェントは、25 QPS をはるかに下回る値でこの制限に達する可能性があります。同一ドメインのフェッチは間隔を空け、429 はバックオフしながらリトライしましょう。
エンドポイントと最初の DeepSeek Search API 呼び出し
両エンドポイントは POST で、ベアラートークンを使用し、JSON を受け取ります:
- Search:
https://api.deepseek.com/v1/tools/search - Fetch:
https://api.deepseek.com/v1/tools/fetch
Search リクエストのフィールド
| フィールド | 型 | 必須 | デフォルト | 備考 |
|---|---|---|---|---|
query |
string | はい | なし | 1〜128文字、演算子使用可 |
count |
integer | いいえ | 10 | 1〜50 |
ori_question |
string | いいえ | なし | ユーザーの元の質問、1〜128文字 |
localization |
string | いいえ | "" |
結果をローカライズするための IP アドレス |
need_content |
boolean | いいえ | false | false の場合、content は空のまま |
ドキュメントから引用した検索リクエスト:
curl https://api.deepseek.com/v1/tools/search \
-H "Authorization: Bearer $DEEPSEEK_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "DeepSeek V4 release", "count": 5, "need_content": true}'
results 配列の各項目には、title、url、snippet、summary、content、site_name、site_icon、date（UTC RFC 3339 または null）、rerank_score、authority が含まれます。フェッチする前に、そのうち2つでフィルタリングしましょう:
-
rerank_scoreは0〜3の範囲です。DeepSeek は1.5以上を高品質として扱います。 -
authorityは0〜4の範囲で、不明の場合は-1です。3以上は非常に権威のある情報源を意味します。
フェッチリクエストは1つのフィールド url を取ります（HTTP または HTTPS、最大8,192文字、ユーザー名やパスワードを埋め込まないこと）:
curl https://api.deepseek.com/v1/tools/fetch \
-H "Authorization: Bearer $DEEPSEEK_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com/article"}'
title（空の場合もあります）と Markdown 形式の content を返します。
発生するエラー
| コード | 意味 | リトライ？ |
|---|---|---|
| 400 | ヘッダー、ボディ、フィールド値が不正 | まずリクエストを修正 |
| 401 | キーが欠落または無効 | いいえ |
| 402 | 残高不足 | チャージ後にリトライ |
| 403 | セキュリティポリシーにより Fetch がブロック | いいえ |
| 404 | Fetch が使用可能なコンテンツを取得できなかった | いいえ |
| 408 / 429 / 5xx | タイムアウト、レート制限、サーバーエラー | はい、待機後に |
エラーボディは OpenAI の形式に従います: message、type、param（常に null）、code です。
Claude Code や Codex から Search を使う場合と直接呼び出す場合の比較
無料期間が適用されるのは、コーディングツールがあなたの代わりに呼び出しを行う場合のみなので、設定が請求額を左右します。
Claude Code。 Claude Code を DeepSeek の Anthropic 互換エンドポイントに向けると、DeepSeek の API がサーバーサイドで Web Search ツールを実行します。DeepSeek のページにある主要な変数：
export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=<your DeepSeek API key>
export ANTHROPIC_MODEL=deepseek-flash[1m]
さらにいくつかのモデル変数を設定するブロック全体は、DeepSeek のページからコピーしてください。
Codex。 Codex の組み込みウェブ検索は、DeepSeek の Codex 統合ページ によると、deepseek-v4-pro でのみ動作します。セットアップスクリプトはデフォルトでウェブ検索をオフにするため、~/.codex/config.toml に次の2行を設定して再起動します:
model = "deepseek-v4-pro"
web_search = "live"
トレードオフ: deepseek-v4-pro は deepseek-flash よりもトークンあたりのコストが高くなります。
直接呼び出し。 独自のエージェントを構築する場合や、count、need_content、演算子を自分で制御したい場合は、エンドポイントを直接呼び出しましょう。最初の成功した呼び出しから課金されます。コーディング中に調べ物をするエージェントが欲しいだけなら、無料期間中は Claude Code や Codex を使ってください。
コーディングエージェントに Apidog CLI で DeepSeek Search API をテストさせる
Search と Fetch を製品に組み込む前に、認証、レスポンスの形式、エラーがドキュメントどおりに動作することを確認しましょう。使用しているコーディングエージェントは Apidog CLI でこれらのチェックを構築・実行できるため、テストはチームが CI で再実行できるプロジェクトに残ります。
一度セットアップします:
npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_APIDOG_TOKEN>
npx -y skills add https://apidog.com # pick your agent when prompted
次に、Claude Code、Codex、または使用しているエージェントに1つのプロンプトを与えます:
In Apidog project <projectId>, add the DeepSeek endpoints POST /v1/tools/search
and POST /v1/tools/fetch with base URL https://api.deepseek.com and Bearer [REDACTED]
from the DEEPSEEK_API_KEY variable. Create test cases that assert: search returns
200 with a results array whose rerank_score values are between 0 and 3; fetch on
https://example.com returns 200 with non-empty content; a bad key returns 401.
Run them against the deepseek environment and summarize any failures.
エージェントは各ペイロードスキーマを読み、その JSON を検証してからテストを作成・実行します:
apidog environment create deepseek --project <projectId> --base-url https://api.deepseek.com
apidog cli-schema get endpoint-create
apidog cli-schema validate endpoint-create --file search-endpoint.json
apidog endpoint create --project <projectId> --file search-endpoint.json
apidog cli-schema get test-case-create
apidog test-case create --project <projectId> --file search-case.json
apidog run --test-case <caseId> --project <projectId> -e <envId> -r cli,json
完全な実行は無料期間終了後に2回の課金対象呼び出し（検索1回、フェッチ1回）を行うため、コストは$0.0015です。401 のチェックは失敗したリクエストには課金されないため無料です。同じ apidog run ... -r junit の行をパイプラインに組み込めます。これは CI/CD で Apidog CLI を実行する で示されています。Claude Code をエージェントとして使っている場合は、Claude Code での Apidog CLI がスキルのインストール手順を説明しています。
Apidog の Free プランは最大4ユーザーまで対応しているため、小規模なチームでもプロジェクトとテスト履歴を共有できます。
FAQ
10月31日以降、DeepSeek Search API は無料ですか？ いいえ。2026年10月31日 16:00 UTC 以降、Claude Code、Codex、DeepSeek Harness を通じた Search および Fetch 呼び出しは、成功したリクエスト1,000件あたり$0.75となり、直接呼び出しと同じです。
DeepSeek Fetch API は無料ですか？ Search と同じ条件でのみ無料です。つまり、締め切り前に Claude Code、Codex、DeepSeek Harness がサーバーサイドで呼び出す場合は無料で、その後は成功したリクエスト1,000件あたり$0.75です。
Claude Code で無料の検索を使うには DeepSeek API キーが必要ですか？ はい。Claude Code は https://api.deepseek.com/anthropic 経由で DeepSeek API キーを使って実行する必要があり、結果の要約に消費するモデルトークンは通常どおり課金されます。
DeepSeek Search API のレート制限は？ DeepSeek のガイドには、アカウントあたり Search が 100 QPS、Fetch が 25 QPS、加えて Fetch には公開されていないドメインごとの制限があると記載されています。超過すると HTTP 429 が返されます。
検索が何も返さない場合に課金されますか？ いいえ。空の結果、失敗したリクエスト、タイムアウトには課金されません。Search は HTTP 200 で空でない results 配列が返された場合にのみ課金されます。
より多くの結果を要求するとコストが高くなりますか？ いいえ。count フィールド（1〜50）は料金を変えないため、50件の結果を返す検索1回のコストは5件の結果を返す検索と同じです。
Top comments (0)