मुख्य सामग्री पर जाएं
phaseo:web_search जोड़ें, ताकि मॉडल को नवीनतम या स्रोत-आधारित जानकारी चाहिए तो वह वेब खोज सके। मॉडल query लिखता है और एक अनुरोध में कई बार खोज सकता है; Phaseo URL, शीर्षक, स्निपेट, हाइलाइट और वैकल्पिक रूप से पेज टेक्स्ट लौटाता है, और मॉडल स्रोत-आधारित उत्तर लिखता है।
यही टूल एंट्री /v1/responses और /v1/messages पर tools में भी काम करती है।

पैरामीटर

मॉडल क्या भेजता है

हर कॉल में एक query होती है। मॉडल max_results, engine, search_context_size, डोमेन सूचियां, include_text, include_highlights, max_characters और ये स्थानीयकरण संकेत भी भेज सकता है: मॉडल जो मान भेजता है, वे उस कॉल के लिए टूल के डिफ़ॉल्ट की जगह लेते हैं। max_results फिर भी max_total_results में बचे हिस्से तक सीमित रहता है; वह खत्म होने पर आगे की कॉल max_total_results_reached लौटाती हैं।

इंजन चुनें

अगर कोई प्रबंधित इंजन सक्षम नहीं है, तो कॉल मॉडल को search_not_configured लौटाती है। /v1/chat/completions या /v1/responses पर engine: "native" के साथ अनुरोध सिर्फ़ उन प्रदाताओं को जाता है जो खुद वेब खोज चलाते हैं। अगर कोई भी प्रदाता मॉडल को सर्व नहीं करता, तो Phaseo अपना डिफ़ॉल्ट इंजन चलाता है और उसका बिल प्रबंधित खोज के रूप में बनाता है। इन एंडपॉइंट पर जो प्रदाता खुद वेब खोज चलाते हैं, वे हैं OpenAI, /v1/responses पर Azure OpenAI डिप्लॉयमेंट, xAI, और deepseek/deepseek-v4.1-flash-1017 पर DeepSeek। DeepSeek खुद खोज तभी चलाता है जब वेब खोज अनुरोध का एकमात्र टूल हो, उसमें कोई डोमेन सूची या उपयोगकर्ता की लोकेशन न हो, JSON आउटपुट न माँगा गया हो और tool_choice कोई टूल ज़बरदस्ती न चुनता हो। उसका API डोमेन सूचियों, लोकेशन और JSON आउटपुट को अस्वीकार करता है, अनुरोध में दूसरे टूल होने पर अपनी वेब खोज बंद कर देता है, और खोज को ज़बरदस्ती नहीं चला सकता। उस मॉडल के बाकी अनुरोध इसके बजाय Phaseo की खोज इस्तेमाल करते हैं, जो आपके अपने टूल के साथ काम करती है। reasoning चालू होने पर DeepSeek ज़्यादा गहरी खोज चलाता है, जो कई चरणों में पेज खोलकर पढ़ती है। OpenAI का अपना { "type": "web_search" } टूल भेजना engine: "native" की तरह ही काम करता है। native सिर्फ़ टूल परिभाषा में सेट करें: अगर मॉडल किसी कॉल में native मांगता है, तो कॉल unsupported_search_engine लौटाती है, क्योंकि प्रदाता का टूल अनुरोध भेजने से पहले चुनना होता है।

डोमेन से फ़िल्टर करें

जब उत्तर स्रोतों के एक तय सेट से ही आना चाहिए, तब allowed_domains उपयोग करें, और खुली खोज से कुछ खास साइटें हटाने के लिए excluded_domains।
इंजन सूचियों को अलग-अलग तरह से संभालते हैं:
  • Perplexity दोनों में से एक ही सूची लेता है, दोनों नहीं, और अधिकतम 20 डोमेन। बाहर रखे गए डोमेन उसके deny-list फ़ॉर्मेट में भेजे जाते हैं।
  • Firecrawl दोनों में से एक ही सूची लेता है, दोनों नहीं।
  • TinyFish दोनों लेता है और उन्हें query में site: और -site: ऑपरेटर में बदल देता है।
  • DeepSeek दोनों लेता है और उन्हें site: और -site: ऑपरेटर में बदल देता है। इसकी queries 128 अक्षरों तक सीमित हैं, इसलिए ऑपरेटर के लिए जगह बनाने हेतु query छोटी कर दी जाती है। अगर अकेली डोमेन सूचियाँ ही सीमा पार कर दें, तो कॉल search_query_too_long लौटाती है।

टूल क्या लौटाता है

एक JSON परिणाम, जिसमें इंजन, query और एक results ऐरे होता है। हर परिणाम में title, url, snippet या highlights होते हैं, और text तब, जब पेज टेक्स्ट मांगा गया हो और इंजन उसे देता हो।

उपयोग और मूल्य

हर खोज usage.server_tool_use में जुड़ती है:
Phaseo हर managed search के लिए $0.007 लेता है, और पहले 10 के बाद हर result के लिए $0.001, जब तक मॉडल का price card server_tool_web_search_requests और server_tool_web_search_extra_results के लिए अपनी कीमतें तय न करे। असफल searches का शुल्क नहीं लगता, और TinyFish Search अपने प्रकाशित प्लान पर मुफ़्त है, इसलिए engine: "tinyfish" कोई search शुल्क नहीं जोड़ता। सशुल्क engines पर searches के लिए क्रेडिट चाहिए, भले ही मॉडल मुफ़्त हो। Native search का बिल native_web_search_requests से प्रदाता की प्रकाशित कीमत पर बनता है: उदाहरण के लिए OpenAI और Anthropic पर $10 प्रति 1,000 searches, और DeepSeek पर $0.75 प्रति 1,000, जहाँ सिर्फ़ वे searches गिनी जाती हैं जो results लौटाती हैं। DeepSeek हर page fetch का भी, यानी जब वह अपने link-reading टूल से कोई URL पढ़ता है, $0.75 प्रति 1,000 के हिसाब से बिल बनाता है, native_web_fetch_requests के रूप में। reasoning चालू होने पर DeepSeek का एक जवाब दर्जन भर या उससे ज़्यादा खोजें चला सकता है, और वह जो नतीजे पढ़ता है वे इनपुट टोकन में जुड़ते हैं।
अंतिम संशोधन 16 नवंबर 2026