Trả lời nhanh: API Tìm kiếm DeepSeek chỉ miễn phí trong ba công cụ lập trình, và chỉ đến 16:00 UTC ngày 31 tháng 10 năm 2026. Các cuộc gọi Tìm kiếm và Tìm nạp mà Claude Code, Codex hoặc DeepSeek Harness thực hiện phía máy chủ sẽ không tốn phí cho đến lúc đó. Sau đó, và với mọi cuộc gọi trực tiếp đến các điểm cuối, bạn phải trả $0.75 cho mỗi 1.000 yêu cầu thành công cho mỗi điểm cuối. Các cuộc gọi thất bại, kết quả trống và hết thời gian chờ sẽ không bao giờ bị tính phí.
DeepSeek đã mở API Tìm kiếm và Tìm nạp cho mọi người vào ngày 17 tháng 10 năm 2026, cùng với bản phát hành DeepSeek-V4.1-Flash-1017. Chúng cung cấp cho tác nhân kết quả web mới cho một truy vấn và bản sao Markdown sạch của bất kỳ trang nào. Hướng dẫn này bao gồm những gì miễn phí, chi phí sau thời gian miễn phí, giới hạn tốc độ, yêu cầu đầu tiên và kiểm tra cả hai điểm cuối với Apidog CLI.
Mọi thông tin dưới đây đều đến từ hướng dẫn Tìm kiếm & Tìm nạp của DeepSeek và trang giá, đọc vào ngày 28 tháng 10 năm 2026.
API Tìm kiếm DeepSeek có miễn phí không?
Có, với hai giới hạn: nơi bạn gọi nó và thời điểm. Tài liệu của DeepSeek nói rằng các cuộc gọi Tìm kiếm và Tìm nạp phía máy chủ được thực hiện thông qua DeepSeek Harness, Claude Code hoặc Codex “hiện được miễn phí.” Tính phí theo yêu cầu cho các cuộc gọi đó bắt đầu từ 00:00 ngày 1 tháng 11 năm 2026 theo UTC+8, tức là 16:00 UTC ngày 31 tháng 10 năm 2026.
| Lộ trình | Chi phí Tìm kiếm và Tìm nạp trước 16:00 UTC ngày 31 tháng 10 | Sau đó |
|---|---|---|
| Claude Code trên khóa API DeepSeek | $0 | $0.75 / 1.000 cuộc gọi thành công |
| Codex trên khóa API DeepSeek | $0 | $0.75 / 1.000 cuộc gọi thành công |
| DeepSeek Harness | $0 | $0.75 / 1.000 cuộc gọi thành công |
Gọi trực tiếp POST đến /v1/tools/search hoặc /v1/tools/fetch |
$0.75 / 1.000 cuộc gọi thành công | $0.75 / 1.000 cuộc gọi thành công |
Hai điều cần lưu ý khiến đây không phải là lộ trình hoàn toàn miễn phí:
- Bạn vẫn cần một khóa API DeepSeek đã nạp tiền. Thời gian miễn phí bao gồm các cuộc gọi tìm kiếm, không bao gồm mô hình. Trang tích hợp Claude Code của DeepSeek nói rằng việc tóm tắt kết quả tìm kiếm sử dụng thêm các yêu cầu LLM và những token đó được tính phí theo giá mô hình thông thường.
- Thời gian miễn phí chỉ bao gồm các cuộc gọi công cụ phía máy chủ. Tài liệu giới hạn nó cho ba công cụ đó. Nếu mã của riêng bạn gọi các điểm cuối, bạn phải trả từ yêu cầu thành công đầu tiên.
Nếu bạn đang tìm một mô hình DeepSeek miễn phí thay vì tìm kiếm miễn phí, hướng dẫn của chúng tôi về liệu DeepSeek có miễn phí không liệt kê mọi lộ trình, và khóa API DeepSeek miễn phí bao gồm chính khóa đó.
API Tìm kiếm và Tìm nạp DeepSeek làm gì
API Tìm kiếm DeepSeek nhận một truy vấn và trả về kết quả web có cấu trúc: tiêu đề, URL, đoạn trích, tóm tắt dài hơn hướng đến mô hình, trường nội dung toàn trang tùy chọn, điểm liên quan và điểm thẩm quyền. API Tìm nạp DeepSeek nhận một URL và trả về tiêu đề của trang đó và nội dung của nó dưới dạng Markdown. Cùng nhau, chúng cung cấp cho tác nhân khả năng tìm kiếm và đọc trong hai cuộc gọi.
Tác nhân nghiên cứu thường tìm kiếm một lần, sau đó tìm nạp hai hoặc ba trang, và mỗi lần là một cuộc gọi tính phí riêng sau thời gian miễn phí. Tìm kiếm hỗ trợ các toán tử: site:, -site:, "phrase", -term, lang:en,ja, after: và before:.
Bạn có thể so sánh điều này với các lựa chọn khác trong tổng hợp của chúng tôi về API tìm kiếm web miễn phí, API tìm kiếm web Claude và API tìm kiếm Perplexity.
Giá API Tìm kiếm DeepSeek sau thời gian miễn phí
Khi thời gian miễn phí kết thúc, cả hai điểm cuối tính phí như sau:
| API Tìm kiếm | API Tìm nạp | |
|---|---|---|
| Giá | $0.75 cho mỗi 1.000 yêu cầu thành công | $0.75 cho mỗi 1.000 yêu cầu thành công |
| Mỗi cuộc gọi | $0.00075 | $0.00075 |
| Tính phí khi | HTTP 200 với mảng results không trống |
HTTP 200 với nội dung trang |
| Không tính phí | Yêu cầu thất bại, kết quả trống, hết thời gian chờ | Yêu cầu thất bại, hết thời gian chờ |
count có làm thay đổi giá không? |
Không | Không áp dụng |
Chi phí được trừ từ số dư DeepSeek của bạn, và trang giá nói rằng số dư được cấp sẽ được sử dụng trước số dư đã nạp khi bạn có cả hai.
Một phép tính nhanh cho một tác nhân nghiên cứu chạy 200 tác vụ mỗi ngày, mỗi tác vụ có một tìm kiếm và ba tìm nạp:
- 200 tìm kiếm x $0.00075 = $0.15
- 600 tìm nạp x $0.00075 = $0.45
- Tổng cộng: $0.60 một ngày, khoảng $18 một tháng, trước khi tính token mô hình
Vì count không làm thay đổi giá, hãy yêu cầu tối đa 50 kết quả trong một cuộc gọi thay vì phân trang. Về phía mô hình, deepseek-flash tốn $0.15 cho mỗi triệu token đầu vào (cache miss, ngoài giờ cao điểm) và $0.60 cho mỗi triệu token đầu ra, tăng gấp đôi vào giờ cao điểm; xem giá DeepSeek V4.1 Flash.
Giới hạn tốc độ API Tìm kiếm DeepSeek
Một số bài viết của bên thứ ba trích dẫn giới hạn 5 QPS. Hướng dẫn của chính DeepSeek đưa ra các con số khác, và đó là những con số bạn nên dựa vào:
- Tìm kiếm: 100 truy vấn mỗi giây
- Tìm nạp: 25 truy vấn mỗi giây, cộng với giới hạn theo miền mà giá trị không được công bố
Giới hạn được tính theo tài khoản, áp dụng cho tất cả các khóa API của bạn và tách biệt với đồng thời của mô hình. Tìm kiếm và Tìm nạp được đo riêng, vì vậy một loạt tìm nạp không ăn vào ngân sách tìm kiếm của bạn. Vượt quá sẽ trả về HTTP 429.
Hãy chú ý giới hạn Tìm nạp theo miền: một tác nhân tìm nạp 20 trang từ một trang tài liệu có thể đạt đến giới hạn này thấp hơn nhiều so với 25 QPS. Hãy giãn cách các tìm nạp cùng miền và thử lại 429 với backoff.
Các điểm cuối và cuộc gọi API Tìm kiếm DeepSeek đầu tiên của bạn
Cả hai điểm cuối đều là POST, sử dụng bearer token và nhận JSON:
- Tìm kiếm:
https://api.deepseek.com/v1/tools/search - Tìm nạp:
https://api.deepseek.com/v1/tools/fetch
Các trường yêu cầu tìm kiếm
| Trường | Loại | Bắt buộc | Mặc định | Ghi chú |
|---|---|---|---|---|
query |
string | Có | không | 1 đến 128 ký tự, cho phép toán tử |
count |
integer | Không | 10 | 1 đến 50 |
ori_question |
string | Không | không | Câu hỏi gốc của người dùng, 1 đến 128 ký tự |
localization |
string | Không | "" |
Địa chỉ IP để bản địa hóa kết quả |
need_content |
boolean | Không | false | Khi false, content vẫn trống |
Một yêu cầu tìm kiếm, lấy từ tài liệu:
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}'
Mỗi mục trong mảng results mang title, url, snippet, summary, content, site_name, site_icon, date (UTC RFC 3339 hoặc null), rerank_score và authority. Lọc hai trong số chúng trước khi tìm nạp:
rerank_scorechạy từ 0 đến 3. DeepSeek coi 1.5 trở lên là chất lượng cao.authoritychạy từ 0 đến 4, với -1 là không xác định. 3 trở lên nghĩa là nguồn có thẩm quyền cao.
Một yêu cầu tìm nạp nhận một trường, url (HTTP hoặc HTTPS, tối đa 8.192 ký tự, không nhúng tên người dùng hoặc mật khẩu):
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"}'
Nó trả về title (có thể trống) và content ở định dạng Markdown.
Các lỗi bạn sẽ gặp
| Mã | Ý nghĩa | Thử lại? |
|---|---|---|
| 400 | Header, body hoặc giá trị trường không hợp lệ | Sửa yêu cầu trước |
| 401 | Thiếu hoặc khóa không hợp lệ | Không |
| 402 | Số dư không đủ | Nạp tiền, sau đó thử lại |
| 403 | Tìm nạp bị chặn bởi chính sách bảo mật | Không |
| 404 | Tìm nạp không thể lấy nội dung hữu ích | Không |
| 408 / 429 / 5xx | Hết thời gian chờ, giới hạn tốc độ, lỗi máy chủ | Có, sau khi chờ |
Phần thân lỗi theo định dạng OpenAI: message, type, param (luôn là null) và code.
Sử dụng Tìm kiếm từ Claude Code hoặc Codex so với gọi trực tiếp
Thời gian miễn phí chỉ áp dụng khi một công cụ lập trình thực hiện cuộc gọi thay bạn, vì vậy thiết lập quyết định hóa đơn.
Claude Code. Trỏ Claude Code đến điểm cuối tương thích Anthropic của DeepSeek và API của DeepSeek chạy công cụ Tìm kiếm Web phía máy chủ. Các biến cốt lõi từ trang của DeepSeek:
export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=<your DeepSeek API key>
export ANTHROPIC_MODEL=deepseek-flash[1m]
Sao chép toàn bộ khối, khối này đặt thêm một vài biến mô hình, từ trang của DeepSeek.
Codex. Tìm kiếm web tích hợp của Codex chỉ hoạt động với deepseek-v4-pro, theo trang tích hợp Codex của DeepSeek. Script thiết lập tắt tìm kiếm web theo mặc định, vì vậy hãy đặt hai dòng này trong ~/.codex/config.toml và khởi động lại:
model = "deepseek-v4-pro"
web_search = "live"
Đánh đổi: deepseek-v4-pro tốn nhiều hơn mỗi token so với deepseek-flash.
Gọi trực tiếp. Tự gọi các điểm cuối khi bạn đang xây dựng tác nhân của riêng mình hoặc muốn kiểm soát count, need_content và các toán tử. Bạn phải trả từ cuộc gọi thành công đầu tiên. Nếu bạn chỉ muốn một tác nhân tra cứu mọi thứ trong khi lập trình, hãy sử dụng Claude Code hoặc Codex trong thời gian miễn phí.
Để tác nhân lập trình của bạn kiểm tra API Tìm kiếm DeepSeek với Apidog CLI
Trước khi bạn đưa Tìm kiếm và Tìm nạp vào sản phẩm, hãy chứng minh xác thực, hình dạng phản hồi và lỗi hoạt động như tài liệu. Tác nhân lập trình của bạn có thể xây dựng và chạy các kiểm tra đó với Apidog CLI, vì vậy các bài kiểm tra nằm trong một dự án mà nhóm của bạn chạy lại trong CI.
Thiết lập một lần:
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
Sau đó đưa cho Claude Code, Codex hoặc bất kỳ tác nhân nào bạn dùng một lời nhắc:
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 auth
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.
Tác nhân đọc lược đồ payload, xác thực JSON của nó và sau đó viết và chạy các bài kiểm tra:
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
Mỗi lần chạy đầy đủ thực hiện hai cuộc gọi tính phí sau thời gian miễn phí (một tìm kiếm, một tìm nạp), vì vậy nó tốn $0.0015. Kiểm tra 401 không tốn gì vì các yêu cầu thất bại không bị tính phí. Dòng apidog run ... -r junit tương tự có thể đưa vào pipeline, như được trình bày trong chạy Apidog CLI trong CI/CD. Nếu Claude Code là tác nhân của bạn, Apidog CLI trong Claude Code hướng dẫn cài đặt skill.
Gói Miễn phí của Apidog hỗ trợ tối đa 4 người dùng, vì vậy một nhóm nhỏ có thể chia sẻ dự án và lịch sử kiểm tra.
Câu hỏi thường gặp
API Tìm kiếm DeepSeek có miễn phí sau ngày 31 tháng 10 không? Không. Từ 16:00 UTC ngày 31 tháng 10 năm 2026, các cuộc gọi Tìm kiếm và Tìm nạp qua Claude Code, Codex và DeepSeek Harness tốn $0.75 cho mỗi 1.000 yêu cầu thành công, giống như gọi trực tiếp.
API Tìm nạp DeepSeek có miễn phí không? Chỉ với các điều khoản tương tự như Tìm kiếm: miễn phí khi Claude Code, Codex hoặc DeepSeek Harness gọi nó phía máy chủ trước thời hạn, sau đó là $0.75 cho mỗi 1.000 yêu cầu thành công.
Tôi có cần khóa API DeepSeek để sử dụng tìm kiếm miễn phí trong Claude Code không? Có. Claude Code phải chạy trên khóa API DeepSeek thông qua https://api.deepseek.com/anthropic, và các token mô hình mà nó sử dụng để tóm tắt kết quả được tính phí bình thường.
Giới hạn tốc độ API Tìm kiếm DeepSeek là gì? Hướng dẫn của DeepSeek liệt kê 100 QPS cho Tìm kiếm và 25 QPS cho Tìm nạp mỗi tài khoản, cộng với giới hạn theo miền chưa được công bố trên Tìm nạp. Vượt quá chúng sẽ trả về HTTP 429.
Tôi có bị tính phí khi tìm kiếm không trả về gì không? Không. Kết quả trống, yêu cầu thất bại và hết thời gian chờ không bị tính phí. Tìm kiếm chỉ tính phí khi HTTP 200 với mảng results không trống.
Yêu cầu nhiều kết quả hơn có tốn nhiều hơn không? Không. Trường count (1 đến 50) không làm thay đổi giá, vì vậy một tìm kiếm 50 kết quả tốn bằng một tìm kiếm 5 kết quả.