DeepSeek API वेब सर्च: URL पढ़ना, कीमतें और 400 त्रुटियाँ
Chat Completions, Messages और Responses में deepseek-flash का सर्वर-साइड वेब सर्च और URL रीडिंग सेट करें। thinking मोड चुनें, कई संदेशों में signature सुरक्षित रखें, सर्च और फ़ेच के शुल्क को टोकन लागत के साथ जोड़ें और आम 400 त्रुटियाँ ठीक करें। साथ ही समझें कि कब बिल्ट-इन टूल के बजाय अलग Search, Fetch, OCR, ASR और TTS API इस्तेमाल करने चाहिए।
विषय-सूची

अगर आपका चैटबॉट इंटरनेट से जानकारी लेकर स्रोतों के लिंक देना चाहता है, तो deepseek-flash में deepseek_web_search जोड़ें और thinking बंद रखें। कई चरणों में रिसर्च करने के लिए thinking चालू करें। उपयोगकर्ता के दिए हुए लिंक पढ़ने के लिए deepseek_read_url इस्तेमाल करें। शुरुआत DeepSeek के आधिकारिक API से करें, क्योंकि दूसरे संगत API गेटवे नए सर्वर टूल के सभी फ़ील्ड और परिणाम सुरक्षित रखें, यह ज़रूरी नहीं है।
DeepSeek ने ये सुविधाएँ 13 नवंबर 2026 को जारी की थीं। वेब सर्च, URL रीडिंग, फ़ाइल प्रोसेसिंग और वॉइस सेवाओं का शुल्क मॉडल के सामान्य टोकन शुल्क के अतिरिक्त लगता है।
इस गाइड में तीनों समर्थित API के अनुरोध, काम करने वाले कोड उदाहरण, शुल्क की गणना, आम त्रुटियाँ और अलग टूल API चुनने के नियम दिए गए हैं।
13 नवंबर के DeepSeek API अपडेट में क्या बदला?
DeepSeek ने अपने चैट ऐप की कई सुविधाएँ सीधे डेवलपर्स के API के लिए उपलब्ध कराईं।
13 नवंबर की आधिकारिक रिलीज़ जानकारी के अनुसार DeepSeek V4.1 Flash, जिसका मॉडल ID deepseek-flash है, अब इन सुविधाओं का समर्थन करता है:
- स्रोतों के संदर्भ के साथ वेब और इमेज सर्च।
- कई तर्क चरणों में सर्च, पेज खोलना और पेज के अंदर टेक्स्ट खोजना।
- उपयोगकर्ता के संदेश में मौजूद URL पढ़ना।
- PDF, Office दस्तावेज़ और इमेज से टेक्स्ट निकालना या उनका विस्तृत लेआउट समझना।
- मॉडल के इनपुट और आउटपुट की सुरक्षा जाँच।
ये सुविधाएँ Messages, Responses और Chat Completions API में उपलब्ध हैं। सर्च और पेज फ़ेच करने का काम DeepSeek के सर्वर पर होता है। सेवा अपने आप परिणाम मॉडल के संदर्भ में जोड़ती है।
इसलिए बिल्ट-इन टूल का इस्तेमाल करते समय आपके ऐप को अलग से सर्च या वेब पेज डाउनलोड करने का कोड नहीं चलाना पड़ता।
DeepSeek ने Search, Fetch, OCR, ASR और TTS के स्वतंत्र API भी उपलब्ध कराए हैं। इनसे आपका अपना कोड सीधे खोज परिणाम, निकाला गया टेक्स्ट, ट्रांसक्रिप्ट या ऑडियो प्राप्त करता है।
सही सर्च मोड कैसे चुनें?
thinking की सेटिंग तय करती है कि deepseek_web_search कैसे काम करेगा।
| मोड | टूल घोषणा | Thinking | काम करने का तरीका |
|---|---|---|---|
| सामान्य वेब सर्च | deepseek_web_search | बंद | ज़रूरत पड़ने पर सर्च करके स्रोतों के साथ उत्तर देता है |
| गहन सर्च | deepseek_web_search | चालू | कई चरणों में सर्च करता है, पेज खोलता है और टेक्स्ट ढूँढ़ता है |
| URL रीडिंग | deepseek_read_url | बंद, या वेब सर्च के बिना चालू | उपयोगकर्ता के आखिरी संदेश में मौजूद URL पढ़ता है |
| सर्च और URL रीडिंग | दोनों टूल | बंद | मॉडल खुद सर्च या दिए गए URL पढ़ने का विकल्प चुनता है |
गहन सर्च के दौरान मॉडल उत्तर देने से पहले लगभग 20 टूल कॉल तक कर सकता है। यह दस्तावेज़ में बताया गया अनुमानित अधिकतम स्तर है। हर अनुरोध में इतने कॉल होना तय नहीं है।
दोनों टूल साथ घोषित करने पर एक नियम लागू होता है। अगर thinking चालू है और deepseek_web_search घोषित है, तो उस अनुरोध में गहन सर्च चलता है। deepseek_read_url का अलग URL-पढ़ने वाला व्यवहार नहीं चलता।
अगर आपके ऐप को उपयोगकर्ता के खास लिंक पढ़ने हैं, तो केवल deepseek_read_url घोषित करें।
टूल घोषित करने का अर्थ यह नहीं कि मॉडल उसे ज़रूर चलाएगा। सर्च या फ़ेच का फ़ैसला मॉडल करता है।
मॉडल की क्षमता और कोडिंग से जुड़ी लागत समझने के लिए DeepSeek V4.1 Flash की कोडिंग और प्राइसिंग गाइड पढ़ें।
Chat Completions में deepseek_web_search कैसे चालू करें?
POST https://api.deepseek.com/chat/completions पर अनुरोध भेजें। मॉडल deepseek-flash रखें और tools में सर्च टूल घोषित करें।
आपको सक्रिय DeepSeek API कुंजी, Bash शेल, cURL और jq चाहिए।
नीचे दिया गया Bash उदाहरण सामान्य वेब सर्च और मॉडल की कंटेंट सुरक्षा जाँच चालू करता है। पहली कमांड कुंजी को बिना स्क्रीन पर दिखाए पढ़ती है। संकेत मिलने पर DeepSeek से बनाई गई अपनी API कुंजी पेस्ट करें।
read -rs DEEPSEEK_API_KEY && export DEEPSEEK_API_KEY
curl -sS https://api.deepseek.com/chat/completions \
-H "Authorization: Bearer ${DEEPSEEK_API_KEY}" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-flash",
"thinking": {"type": "disabled"},
"tools": [
{"type": "deepseek_web_search"}
],
"safety_check": {"level": "high"},
"messages": [
{
"role": "user",
"content": "What did DeepSeek announce on November 13, 2026? Cite the official sources."
}
]
}' | jq '{
error: .error,
answer: .choices[0].message.content,
citations: .choices[0].message.annotations,
tool_calls: .choices[0].message.server_tool_calls,
finish_reason: .choices[0].finish_reason,
usage: .usage
}'
सफल सर्च वाले उत्तर में ये फ़ील्ड मिल सकते हैं:
choices[0].message.content: उत्तर का टेक्स्ट।choices[0].message.annotations: स्रोतों के URL और उत्तर में उनके स्थान।choices[0].message.server_tool_calls: सर्वर पर किए गए सर्च चरण।usage.server_tool_use: सर्च और फ़ेच के उपयोग की गिनती।
पूरा उत्तर मिलने पर choices[0].finish_reason = "stop" होता है। length का अर्थ है कि उत्तर लंबाई सीमा पर कट गया। content_filter का अर्थ सुरक्षा जाँच द्वारा उत्तर रोका जाना है।
अगर server_tool_calls नहीं दिखता, तो यह अपने आप विफलता का प्रमाण नहीं है। संभव है मॉडल ने सर्च ज़रूरी न समझा हो। ताज़ा जानकारी वाला प्रश्न पूछकर फिर जाँच करें।
गहन सर्च कैसे चालू करें?
सर्च टूल वही रखें और thinking सेटिंग बदलें:
{
"thinking": {"type": "enabled"},
"tools": [
{"type": "deepseek_web_search"}
]
}
यह मोड तब उपयोगी है जब प्रश्न का उत्तर देने के लिए कई स्रोत खोजना और उनकी तुलना करना ज़रूरी हो।
गहन सर्च पेज खोल सकता है और उनके भीतर टेक्स्ट भी खोज सकता है। इस कारण सामान्य सर्च की तुलना में ज़्यादा इनफ़रेंस टोकन और भुगतान योग्य फ़ेच लग सकते हैं।
वास्तव में कितने चरण चलेंगे, यह मॉडल तय करता है।
बिना वेब सर्च के URL कैसे पढ़ें?
सिर्फ deepseek_read_url घोषित करें और URL उपयोगकर्ता के आखिरी संदेश में रखें:
{
"thinking": {"type": "disabled"},
"tools": [
{"type": "deepseek_read_url"}
],
"messages": [
{
"role": "user",
"content": "Summarize https://api-docs.deepseek.com/updates/ and identify the November 13 changes."
}
]
}
इसके लिए पहले वाले Chat Completions उदाहरण का endpoint, मॉडल, प्रमाणीकरण और सुरक्षा सेटिंग इस्तेमाल करें।
URL रीडिंग की कुछ निश्चित सीमाएँ हैं:
- केवल उपयोगकर्ता का सबसे हाल का संदेश URL के लिए जाँचा जाता है।
- एक ही URL दोहराने पर उसे एक बार गिना जाता है।
- पहले 10 अलग URL तक ही विचार किया जाता है।
- मॉडल स्वयं तय करता है कि इनमें से कौन-से URL पढ़ने हैं।
- कई लंबे पेज एक साथ पढ़ने पर उनके कुछ हिस्से कट सकते हैं।
विस्तृत नियम आधिकारिक Web Tools गाइड में दिए गए हैं।
अगर URL केवल पिछले संदेश में था, तो यह उम्मीद न करें कि अगले अनुरोध में वह दोबारा अपने आप पढ़ा जाएगा।
Messages और Responses में वही टूल कैसे घोषित करें?
तीनों API इन सर्वर टूल का समर्थन करते हैं, लेकिन अनुरोध और परिणाम का फ़ॉर्मैट अलग है।
| API | Endpoint | दस्तावेज़ में दिया गया टूल घोषणा फ़ॉर्मैट | Thinking नियंत्रण |
|---|---|---|---|
| Chat Completions | /chat/completions | {"type":"deepseek_web_search"} | thinking.type |
| Messages | /anthropic/v1/messages | {"type":"deepseek_web_search","name":"deepseek_web_search"} | thinking.type |
| Responses | /responses | {"type":"deepseek_web_search"} | reasoning.effort |
तीनों endpoint के लिए होस्ट https://api.deepseek.com है।
DeepSeek के Messages उदाहरण में टूल घोषणा के भीतर type और name दोनों शामिल हैं। केवल इस उदाहरण से यह साबित नहीं होता कि हर वैध अनुरोध के लिए name अनिवार्य है।
Messages में x-api-key हेडर इस्तेमाल होता है। Chat Completions और Responses में Authorization: Bearer इस्तेमाल होता है।
प्रोटोकॉल बदलने से पहले Messages, Chat Completions और Responses की संगतता संबंधी गाइड देखें। समान मॉडल ID होने से टूल और इतिहास का फ़ॉर्मैट समान नहीं हो जाता।
Messages API का उदाहरण
यह Bash अनुरोध Anthropic-संगत Messages फ़ॉर्मैट में दिया हुआ URL पढ़ता है।
curl -sS https://api.deepseek.com/anthropic/v1/messages \
-H "x-api-key: ${DEEPSEEK_API_KEY}" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-flash",
"thinking": {"type": "disabled"},
"tools": [
{
"type": "deepseek_read_url",
"name": "deepseek_read_url"
}
],
"safety_check": {"level": "high"},
"messages": [
{
"role": "user",
"content": "Summarize https://api-docs.deepseek.com/updates/"
}
]
}' | jq '{
content: .content,
stop_reason: .stop_reason,
usage: .usage
}'
उत्तर content ब्लॉक में मिलता है। सर्वर टूल कॉल server_tool_use ब्लॉक में और उसके बाद परिणाम अलग ब्लॉक में आता है।
स्रोतों के संदर्भ टेक्स्ट ब्लॉक से जुड़े होते हैं। पूरा उत्तर मिलने पर stop_reason = "end_turn" होता है।
स्ट्रीमिंग का इस्तेमाल करने पर अंतिम message_delta इवेंट से कुल उपयोग निकालें। शुरुआती message_start का usage केवल पहले इनफ़रेंस चरण को दर्शाता है।
Responses API का उदाहरण
Responses API में thinking.type के बजाय reasoning.effort सेट किया जाता है।
none से thinking बंद होता है। low, high और max अनुरोध किए गए स्तर पर thinking चालू करते हैं।
curl -sS https://api.deepseek.com/responses \
-H "Authorization: Bearer ${DEEPSEEK_API_KEY}" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-flash",
"reasoning": {"effort": "high"},
"tools": [
{"type": "deepseek_web_search"}
],
"safety_check": {"level": "high"},
"input": "Research the November 13, 2026 DeepSeek API update and compare the official documentation."
}' | jq '{
status: .status,
output: .output,
usage: .usage
}'
Responses में सर्च गतिविधि web_search_call प्रकार के output आइटम में आती है। अंतिम उत्तर message आइटम होता है और output_text की annotations में स्रोत मिलते हैं।
पूरा उत्तर status = "completed" दिखाता है। आउटपुट सीमा या कंटेंट सुरक्षा जाँच के कारण incomplete हो सकता है। जनरेशन विफल होने पर failed मिल सकता है।
दोबारा प्रयास करने से पहले incomplete_details.reason या error.code देखें।
तीनों API के परिणाम को एक ही फ़ॉर्मैट में पढ़ने की कोशिश न करें। विशेष रूप से टूल इतिहास सुरक्षित रखते समय यह अंतर महत्त्वपूर्ण है।
कई संदेशों में signature सुरक्षित रखना क्यों ज़रूरी है?
जब deepseek_read_url किसी पेज को सफलतापूर्वक पढ़ता है, तो उसकी सामग्री एन्क्रिप्टेड signature में आती है।
फ़ेच परिणाम में पूरा पेज सामान्य टेक्स्ट के रूप में नहीं लौटता। url, title, data और published_at मुख्यतः दिखाने के लिए होते हैं।
बाद के संदेशों में DeepSeek उसी signature की मदद से पहले पढ़े गए पेज को संदर्भ में दोबारा जोड़ सकता है।
पुराने assistant उत्तर बिना बदले वापस भेजें। इनमें kind, signature और सर्वर टूल कॉल की पूरी संरचना शामिल होनी चाहिए।
नीचे का Python उदाहरण Chat Completions का उपयोग करता है। यह पहले assistant का पूरा संदेश सुरक्षित रखकर अगला सवाल भेजता है।
इसे चलाने से पहले requests इंस्टॉल करें और DEEPSEEK_API_KEY को वातावरण में export करें।
import os
import requests
endpoint = "https://api.deepseek.com/chat/completions"
headers = {
"Authorization": f"Bearer {os.environ['DEEPSEEK_API_KEY']}",
"Content-Type": "application/json",
}
tools = [{"type": "deepseek_read_url"}]
messages = [
{
"role": "user",
"content": (
"Read https://api-docs.deepseek.com/updates/ "
"and summarize the November 13, 2026 entry."
),
}
]
def complete_turn(history):
response = requests.post(
endpoint,
headers=headers,
json={
"model": "deepseek-flash",
"thinking": {"type": "disabled"},
"tools": tools,
"safety_check": {"level": "high"},
"messages": history,
},
timeout=180,
)
response.raise_for_status()
data = response.json()
if data.get("error"):
raise RuntimeError(data["error"])
choice = data["choices"][0]
if choice["finish_reason"] != "stop":
raise RuntimeError(
f"Incomplete response: {choice['finish_reason']}"
)
return choice["message"]
first_reply = complete_turn(messages)
# Preserve the complete assistant object, including server_tool_calls.
messages.append(first_reply)
messages.append(
{
"role": "user",
"content": "Which developer features does that entry list?",
}
)
second_reply = complete_turn(messages)
print(second_reply["content"])
यह उदाहरण दस्तावेज़ में दिए गए संवाद फ़ॉर्मैट को समझाता है। इसे वास्तविक API पर चलाकर प्राप्त परिणाम नहीं बताया जा रहा है।
first_reply["server_tool_calls"] देखें कि मॉडल ने URL पढ़ा या नहीं। अगर read_link कॉल नहीं है, तो पहले उत्तर से सुरक्षित रखने के लिए कोई पढ़े हुए पेज की signature नहीं मिली।
दूसरे प्रोटोकॉल में संबंधित संरचना सुरक्षित रखें:
| API | अगले अनुरोध में क्या वापस भेजें |
|---|---|
| Messages | पिछले assistant के content ब्लॉक, जिनमें kind और signature हों |
| Responses | पिछले output आइटम, जिनमें web_search_call, kind और signature हों |
| Chat Completions | पूरा assistant संदेश, जिसमें server_tool_calls शामिल हो |
अगर आपका फ़्रेमवर्क signature हटा देता है, तब भी अगला अनुरोध सफल हो सकता है। लेकिन पहले पढ़ा गया पेज संदर्भ में वापस नहीं जोड़ा जाएगा।
पिछले गहन सर्च के परिणाम, खोले गए पेज और तर्क चरण अगले संदेश में पूर्ण सामग्री के रूप में अपने आप उपलब्ध नहीं रहते। आम तौर पर उस चरण के उत्तर का टेक्स्ट ही मिलता है। URL रीडिंग की वैध signature इस नियम का दस्तावेज़ित अपवाद है।
इसलिए जब पेज का संदर्भ बनाए रखना ज़रूरी हो, तो assistant इतिहास को केवल role और content तक सीमित न करें।
अलग Search, Fetch, OCR, ASR और TTS API कब इस्तेमाल करें?
अगर आपका ऐप खुद डेटा प्राप्त करने और प्रोसेस करने के चरण नियंत्रित करना चाहता है, तो स्वतंत्र API चुनें।
इनके परिणाम सीधे आपके कोड में आते हैं। इसलिए आप उन्हें जाँच सकते हैं, फ़िल्टर कर सकते हैं, संग्रहीत कर सकते हैं और फिर मॉडल को भेज सकते हैं।
अलग API के endpoint और इनपुट
| API | https://api.deepseek.com पर Endpoint | आवश्यक इनपुट | परिणाम |
|---|---|---|---|
| Search | POST /v1/tools/search | JSON में query | संरचित results |
| Fetch | POST /v1/tools/fetch | JSON में url | पेज का title और Markdown content |
| OCR | POST /v1/tools/ocr | Multipart file, purpose | pages[].text और page_count |
| ASR | POST /v1/tools/asr | Multipart ऑडियो file | text ट्रांसक्रिप्ट और duration_ms |
| TTS | POST /v1/tools/tts | JSON में text | WAV या PCM ऑडियो |
सभी पाँच API Bearer प्रमाणीकरण का उपयोग करते हैं।
नीचे Bash में स्वतंत्र टूल अनुरोध दिए हैं। सभी पहले export की गई DEEPSEEK_API_KEY का इस्तेमाल करते हैं।
# Search for pages and return structured results.
curl -sS https://api.deepseek.com/v1/tools/search \
-H "Authorization: Bearer ${DEEPSEEK_API_KEY}" \
-H "Content-Type: application/json" \
-d '{"query":"DeepSeek API release","count":5,"need_content":true}' \
| jq '.results[] | {title, url, summary, content}'
# Fetch one page as Markdown.
curl -sS https://api.deepseek.com/v1/tools/fetch \
-H "Authorization: Bearer ${DEEPSEEK_API_KEY}" \
-H "Content-Type: application/json" \
-d '{"url":"https://api-docs.deepseek.com/updates/"}' \
| jq '{title, content}'
# Extract text from a local PDF.
curl -sS https://api.deepseek.com/v1/tools/ocr \
-H "Authorization: Bearer ${DEEPSEEK_API_KEY}" \
-F purpose="text_recognition" \
-F file="@document.pdf" \
| jq '{page_count, pages}'
# Transcribe a local audio file.
curl -sS https://api.deepseek.com/v1/tools/asr \
-H "Authorization: Bearer ${DEEPSEEK_API_KEY}" \
-F file="@speech.wav" \
| jq '{text, duration_ms}'
# Generate a WAV file.
curl -sS https://api.deepseek.com/v1/tools/tts \
-H "Authorization: Bearer ${DEEPSEEK_API_KEY}" \
-H "Content-Type: application/json" \
-d '{"text":"Hello from DeepSeek.","voice_id":"stella"}' \
--output speech.wav
OCR और ASR उदाहरणों के लिए लोकल फ़ाइलें मौजूद होनी चाहिए। TTS कमांड वर्तमान डायरेक्टरी में speech.wav बनाता है।
14 नवंबर 2026 तक दस्तावेज़ित मुख्य सीमाएँ:
- Search:
queryकी लंबाई 1–128 Unicode अक्षर।countसे 1–50 परिणाम माँगे जा सकते हैं। खाते की सीमा 100 QPS है। - Fetch: हर अनुरोध में एक HTTP या HTTPS URL। लक्ष्य साइट की पहुँच संबंधी शर्तें लागू हैं। खाते की सीमा 25 QPS है और डोमेन के लिए अलग QPS सीमा भी है।
- OCR: फ़ाइल अधिकतम 100 MiB और 1,000 पेज। एक खाते में एक साथ अधिकतम 15 पहचान कार्य चल सकते हैं।
- ASR: हर अनुरोध में अधिकतम 120 सेकंड और 8 MiB ऑडियो। 16-bit PCM WAV और Ogg Opus समर्थित हैं।
- TTS: प्रति अनुरोध अधिकतम 10,000 बिल योग्य अक्षर। पूरा ऑडियो बनाने के अलावा WebSocket स्ट्रीमिंग भी उपलब्ध है।
अलग Search API में site:, lang: और after: जैसे ऑपरेटर हैं। 14 नवंबर 2026 तक इसका दस्तावेज़ित इंटरफ़ेस इमेज सर्च नहीं करता। इमेज सर्च के लिए बिल्ट-इन वेब टूल का इस्तेमाल करें।
विस्तृत इनपुट नियमों के लिए Search और Fetch, OCR, ASR और TTS गाइड देखें।
फ़ाइल इनपुट और अलग OCR में क्या अंतर है?
अगर मॉडल को दस्तावेज़ पर सवालों के जवाब देने हैं, तो फ़ाइल इनपुट इस्तेमाल करें। अगर आपके ऐप को सिर्फ निकाला गया टेक्स्ट चाहिए, तो अलग OCR API बेहतर शुरुआती विकल्प है।
फ़ाइल को मॉडल के लिए उपलब्ध कराने के चरण:
multipart/form-dataमेंPOST https://api.deepseek.com/filesपर दस्तावेज़ अपलोड करें।purposeफ़ॉर्म फ़ील्ड कोfileसे पहले भेजें। उल्टा क्रम400लौटा सकता है।purposeमेंtext_recognitionयाrich_layout_recognitionचुनें।- प्रोसेसिंग सफल होने पर
file_idप्राप्त करें और उसे बाद केdeepseek-flashअनुरोध में दें।
लोकल PDF अपलोड करने का Bash उदाहरण:
curl -sS https://api.deepseek.com/files \
-H "Authorization: Bearer ${DEEPSEEK_API_KEY}" \
-F purpose="text_recognition" \
-F file="@report.pdf" \
| jq '{id, filename, purpose}'
-F से multipart फ़ॉर्म बनता है। फ़ील्ड का क्रम purpose और फिर file रखें। multipart के Content-Type boundary को खुद न बदलें; cURL इसे तय करता है।
अपलोड के जवाब में id मिलता है। बातचीत के दौरान यही मान file_id के रूप में दें। पेज प्रोसेसिंग अपलोड के समय ही होती है, इसलिए अलग polling की ज़रूरत नहीं है।
text_recognition सिर्फ टेक्स्ट निकालता है। चार्ट, फ़ोटो और चित्र मॉडल को नहीं दिए जाते। rich_layout_recognition दस्तावेज़ में मिली आकृतियाँ भी उनके मूल स्थान से संबंधित संदर्भ में देता है।
Chat Completions के उपयोगकर्ता संदेश में फ़ाइल संदर्भ ऐसा दिखता है:
{
"role": "user",
"content": [
{"type": "file", "file_id": "file-api-xxxxxxxxxxxxxxxx"},
{"type": "text", "text": "Summarize the key points of this document."}
]
}
यहाँ उदाहरण ID के बजाय अपलोड से लौटी वास्तविक file_id दें।
एक अनुरोध में अधिकतम 20 दस्तावेज़ संदर्भित किए जा सकते हैं। उनके निकाले गए टेक्स्ट का कुल आकार अधिकतम 8 MiB है।
फ़ाइल सफलतापूर्वक अपलोड होकर प्रोसेस होने पर पार्सिंग का शुल्क एक बार लगता है। बाद के मॉडल अनुरोधों में दस्तावेज़ का टेक्स्ट इनपुट टोकन के रूप में शुल्क लेता है।
सभी नियम फ़ाइल पार्सिंग गाइड में देखें।
DeepSeek वेब सर्च, OCR और वॉइस API की लागत कितनी है?
14 नवंबर 2026 तक DeepSeek मॉडल टोकन और टूल उपयोग के लिए अलग-अलग शुल्क लेता है।
आधिकारिक प्राइसिंग पेज पर अमेरिकी डॉलर में ये दरें दी गई हैं:
| सुविधा | शुल्क की इकाई | कीमत |
|---|---|---|
| टेक्स्ट वेब सर्च | 1,000 बिल योग्य सर्च | $0.75 |
| इमेज सर्च | 1,000 बिल योग्य सर्च | $0.75 |
| वेब फ़ेच या URL रीडिंग | 1,000 बिल योग्य फ़ेच | $0.75 |
| फ़ाइल पार्सिंग या OCR | 1,000 सफलतापूर्वक प्रोसेस हुए पेज | $0.225 |
| ASR | 1 घंटा ऑडियो | $0.058 प्रचार दर; $0.116 सामान्य दर |
| TTS | 10,000 बिल योग्य अक्षर | $0.225 प्रचार दर; $0.45 सामान्य दर |
ASR और TTS की छूट सीमित समय के लिए बताई गई है। समीक्षा किए गए दस्तावेज़ों में इसकी समाप्ति तिथि नहीं दी गई है।
TTS में एक चीनी अक्षर को दो बिल योग्य अक्षर माना जाता है। स्पेस सहित बाकी अक्षरों को एक माना जाता है।
ASR में ऑडियो अवधि सेकंड तक गिनी जाती है और सेकंड का आंशिक भाग अगले पूरे सेकंड तक बढ़ाया जाता है।
कौन-से usage फ़ील्ड वास्तव में बिल योग्य हैं?
बिल्ट-इन वेब टूल के लिए इन काउंटरों का उपयोग करें:
usage.server_tool_use.tool_search: बिल योग्य टेक्स्ट सर्च।usage.server_tool_use.tool_image_search: बिल योग्य इमेज सर्च।usage.server_tool_use.tool_fetch: बिल योग्य पेज फ़ेच।
web_search_requests और web_fetch_requests को सीधे बिल बनाने के लिए इस्तेमाल न करें।
ये परिणाम ब्लॉक की संख्या दिखाते हैं, जिनमें विफलता वाले ब्लॉक भी शामिल हैं। ये प्रदर्शन के लिए हैं, बिल योग्य गिनती के लिए नहीं।
एक वेब सर्च कॉल कई क्वेरी चला सकता है। यदि उसमें तीन सफल क्वेरी हैं, तो tool_search में तीन जुड़ सकते हैं।
असफल या बिना परिणाम वाला सर्च बिल नहीं होता।
इमेज सर्च में प्रत्येक इमेज एक सर्च गिनी जाती है। इमेज के भीतर मॉडल द्वारा चुने गए हर क्षेत्र के लिए एक अतिरिक्त सर्च गिना जाता है। असफल या खाली परिणाम वाले सर्च का शुल्क नहीं लगता।
URL रीडिंग का शुल्क सफलतापूर्वक डाउनलोड हुए पेज पर लगता है। अगर सुरक्षा जाँच बाद में पेज के परिणाम को त्रुटि में बदल देती है, तो पहले हो चुके डाउनलोड का शुल्क फिर भी लग सकता है।
गहन सर्च में पहले से उपलब्ध पेज को दोबारा खोलने या उसमें टेक्स्ट खोजने पर नया फ़ेच शुल्क नहीं लगता।
स्वतंत्र Search और Fetch API का नियम अलग है: प्रत्येक सफल API अनुरोध बिल योग्य है। सर्च परिणामों की संख्या से स्वतंत्र Search अनुरोध का शुल्क नहीं बढ़ता।
100 अनुरोधों की उदाहरण लागत कैसे निकालें?
मान लें कि बिना thinking वाले 100 DeepSeek Flash अनुरोधों में यह उपयोग हुआ:
| उपयोग | अनुमानित मात्रा |
|---|---|
| बिल योग्य टेक्स्ट सर्च | 200 |
| बिल योग्य फ़ेच किए गए पेज | 100 |
| बिना कैश वाले इनपुट टोकन | 200,000 |
| कैश से पढ़े गए इनपुट टोकन | 0 |
| आउटपुट टोकन, सुरक्षा समीक्षा सहित | 50,000 |
| इमेज सर्च | 0 |
deepseek-flash की आधिकारिक ऑफ़-पीक दर बिना कैश वाले प्रति मिलियन इनपुट टोकन पर $0.15 और आउटपुट टोकन पर $0.60 है।
इन मान्यताओं पर गणना:
Text searches = 200 / 1,000 × $0.75 = $0.150
Page fetches = 100 / 1,000 × $0.75 = $0.075
Input tokens = 200,000 / 1,000,000 × $0.15 = $0.030
Output tokens = 50,000 / 1,000,000 × $0.60 = $0.030
Estimated total = $0.285 for 100 requests
इस तरह 100 अनुरोधों की अनुमानित लागत $0.285 है। ये माने गए उपयोग पर आधारित आँकड़े हैं, किसी वास्तविक बिल या परीक्षण के परिणाम नहीं।
DeepSeek के प्रकाशित समय-सारणी के अनुसार सोमवार से शुक्रवार 01:00–04:00 और 06:00–10:00 UTC पीक समय है। चीनी सार्वजनिक छुट्टियाँ इस नियम से बाहर हैं।
पीक समय में Flash की इनपुट दर $0.30 प्रति मिलियन बिना कैश वाले टोकन और आउटपुट दर $1.20 प्रति मिलियन टोकन है।
इन्हीं मान्यताओं पर पीक समय की अनुमानित लागत $0.345 होगी।
असली बिल मॉडल के चरण, thinking टोकन, कैश उपयोग, इमेज सर्च, फ़ेच, सुरक्षा समीक्षा और लागू दरों पर निर्भर करेगा।
Thinking टोकन output_tokens के अंदर शामिल होते हैं। उनका शुल्क दोबारा न जोड़ें।
विफल अनुरोध पर भी शुल्क लग सकता है?
हाँ, अगर विफलता से पहले कुछ काम हो चुका है।
जनरेशन शुरू होने के बाद हुई त्रुटि में HTTP स्टेटस 200 रह सकता है, जबकि उत्तर के अंदर error मौजूद हो।
उस समय तक चले मॉडल चरण, सर्च और पेज फ़ेच के सामान्य शुल्क लगते हैं।
स्ट्रीमिंग में केवल शुरू का HTTP स्टेटस न देखें। अंतिम इवेंट और कुल usage जाँचें।
बिना स्ट्रीमिंग वाले Chat Completions में HTTP 200 मिलने पर भी error फ़ील्ड देखें।
Responses में status जाँचें, जिसमें failed और incomplete भी संभव हैं।
DeepSeek वेब टूल की आम 400 त्रुटियाँ कैसे ठीक करें?
अक्सर अनुरोध तब अस्वीकार होता है जब डेवलपर सर्वर टूल को सामान्य फ़ंक्शन की तरह जबरन चलाना चाहता है, उसे दो बार घोषित करता है या असमर्थित विकल्प जोड़ देता है।
आधिकारिक Web Tools त्रुटि संदर्भ में ये संदेश दर्ज हैं।
| दिखने वाली त्रुटि | कारण | समाधान |
|---|---|---|
tool_choice: deepseek_web_search cannot be forced | tool_choice से सर्वर टूल को जबरन चुना गया | जबरन चुनाव हटाएँ; मॉडल को निर्णय लेने दें |
tools: deepseek_web_search can only be declared once | टूल दो बार घोषित हुआ | एक ही घोषणा रखें |
tools: allowed_domains is not supported by deepseek_web_search | असमर्थित डोमेन या स्थान विकल्प | allowed_domains, blocked_domains और user_location हटाएँ |
tools: other tools cannot be used together with deepseek_web_search, deepseek_read_url, safety_check or title yet | दूसरा असंगत सर्वर टूल घोषित हुआ | विरोध करने वाला सर्वर टूल हटाएँ |
safety_check: level must be low or high | सुरक्षा स्तर अमान्य है | low या high उपयोग करें |
messages: the last assistant message used deepseek_web_search or deepseek_read_url and cannot be continued; resend the previous request | वेब टूल वाले अधूरे उत्तर को जारी रखने की कोशिश | पिछले मूल अनुरोध को फिर भेजें |
मूल त्रुटि संदेशों में फ़ील्ड नामों के आसपास बैकटिक होते हैं। तालिका में उन्हें पढ़ने में आसानी के लिए नहीं दिखाया गया है।
क्या tool_choice से वेब सर्च ज़बरदस्ती चला सकते हैं?
नहीं। tool_choice में deepseek_web_search या deepseek_read_url को अनिवार्य टूल के रूप में नहीं चुन सकते।
tool_choice को none करने से URL रीडिंग सहित सभी टूल बंद हो जाते हैं।
Chat Completions और Responses में वेब टूल के साथ tool_choice: "required" को auto की तरह माना जाता है। इससे भी सर्च चलने की गारंटी नहीं मिलती।
अगर ऐप को हर बार कोई निश्चित क्वेरी चलानी ही है, तो अलग Search API का उपयोग करें।
क्या ये वेब टूल सामान्य function calls के साथ काम करते हैं?
दस्तावेज़ में दी गई त्रुटि असंगत सर्वर टूल घोषणाओं से संबंधित है।
उससे यह साबित नहीं होता कि सभी सामान्य फ़ंक्शन टूल भी प्रतिबंधित हैं। लेकिन हर एजेंट फ़्रेमवर्क के साथ उनका मिलकर काम करना भी सत्यापित नहीं है।
Responses में इन टूल को web_search के साथ नहीं जोड़ सकते। इसी तरह custom, namespace और tool_search जैसे कुछ टूल प्रकार समर्थित नहीं हैं।
Claude Code, OpenCode या अपने कोडिंग एजेंट में इसे जोड़ने से पहले पूरा अनुरोध और टूल के लौटे परिणाम जाँचें।
केवल बिना वेब टूल वाला OpenAI-संगत अनुरोध सफल होने से इस नए संयोजन की संगतता साबित नहीं होती।
वेब टूल वाला उत्तर जारी करने पर 400 क्यों आता है?
बातचीत का नया संदेश भेजना और उसी अधूरे उत्तर की जनरेशन जारी करना अलग काम हैं।
नए संदेश में आप पिछला पूरा assistant उत्तर और उपयोगकर्ता का अगला प्रश्न भेजते हैं।
Continuation का अर्थ उसी अधूरे assistant उत्तर को आगे बढ़ाना है।
DeepSeek उन उत्तरों को जारी करने की अनुमति नहीं देता जिनमें deepseek_web_search या deepseek_read_url चला था।
अगर ऐसा उत्तर कट गया, तो उचित आउटपुट सीमा के साथ पिछला मूल अनुरोध फिर भेजें। ध्यान रखें कि इससे सर्च और फ़ेच फिर चल सकते हैं और नया शुल्क लग सकता है।
अन्य अनुमत Chat Completions continuation में अंतिम assistant संदेश पर prefix: true और beta endpoint इस्तेमाल होता है। इससे वेब टूल वाले उत्तर का प्रतिबंध नहीं हटता।
URL रीडिंग में url_not_accessible, url_not_allowed और unavailable का क्या अर्थ है?
फ़ेच विफल होने पर web_fetch_tool_result_error लौटता है। उसमें signature नहीं होती।
कौन-सी समस्या आई, यह error_code बताता है।
| Error code | अर्थ | अगला कदम |
|---|---|---|
url_not_accessible | लिंक पढ़ा नहीं जा सका | URL, पेज की उपलब्धता, प्रमाणीकरण और साइट प्रतिबंध जाँचें |
url_not_allowed | लिंक पढ़ने की अनुमति नहीं या सुरक्षा समीक्षा ने पेज रोका | प्रतिबंध न तोड़ें; स्वीकार्य स्रोत माँगें |
unavailable | सेवा उपलब्ध नहीं, गहन सर्च में पेज नहीं खुला या कॉल पूरा नहीं हुआ | उत्तर की स्थिति जाँचें और ज़रूरत पर सीमित पुनः प्रयास करें |
ये तीनों कारण एक जैसे नहीं हैं।
url_not_allowed हमेशा नेटवर्क समस्या नहीं है। यह कंटेंट सुरक्षा समीक्षा से भी आ सकता है।
unavailable का अर्थ यह भी नहीं कि ऑपरेशन निःशुल्क होगा। संभव है कि त्रुटि से पहले पेज डाउनलोड हो चुका हो।
स्ट्रीमिंग में टूल कॉल और नतीजों को उनकी ID से मिलाएँ। कई पेज पढ़े जाने पर परिणाम उसी क्रम में तुरंत नहीं भी आ सकते।
उत्तर पूरा हुआ या नहीं, यह भी देखें:
- Messages में
end_turnका अर्थ उत्तर पूरा हो गया। max_tokensका अर्थ आउटपुट या उपलब्ध संदर्भ सीमा समाप्त हो गई।refusalका अर्थ सुरक्षा समीक्षा ने उत्तर रोका।
Chat Completions में संबंधित मान stop, length और content_filter हैं।
सार्वजनिक उपयोग वाले ऐप में सुरक्षा जाँच चालू रखें:
{
"safety_check": {"level": "high"}
}
DeepSeek सार्वजनिक सेवा देने वाले ऐप से सुरक्षा जाँच चालू रखने को कहता है। यह इनपुट और आउटपुट की बुनियादी समीक्षा करता है। लेकिन इससे आपके ऐप की अपनी कंटेंट मॉडरेशन, लागू पंजीकरण या AI सामग्री लेबलिंग संबंधी जिम्मेदारियाँ समाप्त नहीं होतीं।
सुरक्षा समीक्षा द्वारा रोके गए उत्तर में पहले खर्च हुए टोकन का शुल्क लग सकता है।
अधिक जानकारी Model Content Safety गाइड में है।
बिल्ट-इन DeepSeek टूल चुनें या अपना सर्च API?
जब मॉडल खुद बातचीत के दौरान रिसर्च चलाए, तो बिल्ट-इन टूल से शुरुआत करें। अगर आपको सर्च के चरण और मूल परिणाम अपने कोड में नियंत्रित करने हैं, तो स्वतंत्र API बेहतर है।
| ऐप की ज़रूरत | पहले क्या चुनें | कारण |
|---|---|---|
| स्रोतों सहित चैटबॉट का उत्तर | बिना thinking वाला deepseek_web_search | कम अलग सर्च कोड लिखना पड़ेगा |
| कई स्रोतों पर रिसर्च | thinking सहित deepseek_web_search | मॉडल कई बार खोज और पेज जाँच सकता है |
| उपयोगकर्ता के लिंक का सारांश | deepseek_read_url | URL पढ़ता है और signature से पेज संदर्भ बनाए रखता है |
| किसी साइट पर खोज या संरचित परिणाम | स्वतंत्र Search | क्वेरी और परिणाम को ऐप नियंत्रित करता है |
| तय URL से Markdown निकालना | स्वतंत्र Fetch | पेज का टेक्स्ट सीधे कोड में आता है |
| बहुत से दस्तावेज़ों से टेक्स्ट निकालना | स्वतंत्र OCR | पेज के अनुसार टेक्स्ट मिलता है |
| अपलोड किए दस्तावेज़ से प्रश्न करना | File Parsing और deepseek-flash | दस्तावेज़ मॉडल संदर्भ में जुड़ता है |
| वॉइस इनपुट या पढ़कर सुनाना | ASR और TTS | ऑडियो के लिए अलग API मिलते हैं |
मौजूदा कोडिंग एजेंट में बाहरी सर्च इंटीग्रेशन रखना कभी-कभी बेहतर विकल्प है। इससे एजेंट के पहले से मौजूद टूल नियंत्रण और रिट्रीवल व्यवहार को बदलना नहीं पड़ता।
Parallel Search MCP को एजेंट में जोड़ने की गाइड एक वैकल्पिक तरीका दिखाती है। निर्णय लेने से पहले समान काम पर शुल्क, टूल संगतता और पेज से प्राप्त सामग्री की तुलना करें।
BetterToken और दूसरे संगत गेटवे के बारे में क्या जानें?
14 नवंबर 2026 तक BetterToken के मॉडल कैटलॉग में deepseek-flash सूचीबद्ध था। एक्सेस का रास्ता तय करने से पहले मौजूदा मॉडल कीमतें देखें।
लेकिन मॉडल की सूची में मौजूदगी, DeepSeek के नए सर्वर टूल के समर्थन का प्रमाण नहीं है।
BetterToken के माध्यम से टूल घोषणाओं को आगे भेजना, signature सुरक्षित रखना, usage.server_tool_use लौटाना और टूल शुल्क सही दर्ज होना सत्यापित नहीं किया गया है।
इसलिए इस गाइड के कोड उदाहरण DeepSeek के आधिकारिक endpoint का उपयोग करते हैं।
किसी अन्य संगत गेटवे पर जाने से पहले एक सर्च अनुरोध, एक URL रीडिंग अनुरोध और signature सुरक्षित रखने वाला दूसरा संदेश जाँचें। इसके बाद usage तथा वास्तव में कटे शुल्क का मिलान करें।
नए ऐप के लिए सबसे पहले thinking बंद करके सामान्य सर्च चलाएँ। स्रोतों और बिल योग्य उपयोग की जाँच करें। कई सर्च चरणों की ज़रूरत होने पर गहन सर्च चालू करें। जिन कार्यों का नियंत्रण कोड के पास होना चाहिए, उनके लिए स्वतंत्र Search और Fetch चुनें।