Perplexity API
Generate answers and research reports with web citations.
Perplexity Sonar Reasoning Pro
वेब सर्च और उद्धरणों से समर्थित तर्क आवश्यक प्रश्न का विश्लेषण करें। model और messages आवश्यक हैं; इस endpoint के लिए model sonar-reasoning-pro उपयोग करें। यह सार्वजनिक कॉन्ट्रैक्ट stream false के साथ non-streaming JSON responses कवर करता है। उत्तर और उसके स्रोतों के लिए choices[].message.content, citations और search_results पढ़ें। usage Felo क्रेडिट शुल्क नहीं है।
मूल्य संदर्भ
- मीटरिंग: रिपोर्ट किया गया response लागत
- संदर्भ request अनुमान: USD 0.03499
- संदर्भ ग्राहक गुणक: 1.0। निपटाई गई ग्राहक राशि पर इसे दोबारा लागू न करें।
यह केवल संदर्भ मेटाडेटा है — खाते का कोटेशन, गारंटीशुदा मूल्य या खर्च सीमा नहीं। रिसोर्स क्रेडिट Felo क्रेडिट नहीं हैं। अंतिम शुल्क Felo बिलिंग रिकॉर्ड के अनुसार लगते हैं।
- टाइप: array object[]messagesआवश्यक
अब तक की बातचीत को बनाने वाले messages की सूची।
- contentटाइप: stringआवश्यक
message का कंटेंट।
- roleटाइप: string enumआवश्यक
message लेखक की भूमिका।
मान- system
- user
- assistant
- टाइप: string enummodelआवश्यक
उपयोग करने के लिए Sonar मॉडल।
मान- sonar
- sonar
-pro - sonar
-reasoning -pro - sonar
-deep -research
- टाइप: numberfrequency
_penalty न्यूनतम:0अधिकतम:2अब तक के टेक्स्ट में मौजूद आवृत्ति के आधार पर नए टोकन पर दंड लगाता है। धनात्मक मान उसी पंक्ति को शब्दशः दोहराने की संभावना घटाते हैं।
- टाइप: integermax
_tokens response में जनरेट करने के लिए टोकन की अधिकतम संख्या।
- टाइप: numberpresence
_penalty न्यूनतम:-2अधिकतम:2अब तक के टेक्स्ट में टोकन दिखने या न दिखने के आधार पर नए टोकन पर दंड लगाता है। धनात्मक मान नए विषयों पर बात करने की संभावना बढ़ाते हैं।
- टाइप: booleanreturn
_citations response में उद्धरण और सर्च परिणाम लौटाने हैं या नहीं।
- टाइप: string enumsearch
_context नियंत्रित करता है कि कितना सर्च कॉन्टेक्स्ट उपयोग होगा। प्रति-request लागत को प्रभावित करता है।
मान- low
- medium
- high
- टाइप: array string[]search
_domain _filter खोज को विशिष्ट डोमेन तक सीमित करें।
- टाइप: string enumsearch
_recency _filter सर्च परिणामों को नवीनता के अनुसार फ़िल्टर करें।
मान- month
- week
- day
- hour
- टाइप: booleanstream
server-sent events का उपयोग करके response स्ट्रीम करना है या नहीं।
- टाइप: numbertemperatureन्यूनतम:0अधिकतम:2
0 और 2 के बीच सैंपलिंग तापमान। कम मान आउटपुट को अधिक केंद्रित और नियतात्मक बनाते हैं।
- टाइप: integertop
_k न्यूनतम:0अधिकतम:2048top-k फ़िल्टरिंग के लिए रखने वाले टोकन की संख्या।
- टाइप: numbertop
_p न्यूनतम:0अधिकतम:1न्यूक्लियस सैंपलिंग पैरामीटर। मॉडल top_p प्रायिकता द्रव्यमान वाले टोकन पर विचार करता है।
- टाइप: object · ResponseD5E2470Dd28B_ChatCompletionResponse200
AI उत्तर और उद्धरणों के साथ सफल response
- टाइप: array object[]choices
- finishटाइप: string enum
_reason मान- stop
- length
- indexटाइप: integer
Integer numbers.
- messageटाइप: object
- contentटाइप: string
AI द्वारा जनरेट किया गया उत्तर, [1][2] जैसे इनलाइन उद्धरण संदर्भों के साथ
- roleटाइप: string
- टाइप: array string[]citations
उत्तर में संदर्भित स्रोत URL की सूची
- टाइप: integercreated
completion कब बनाया गया, इसका Unix टाइमस्टैम्प
- टाइप: stringid
completion का विशिष्ट पहचानकर्ता
- टाइप: stringmodel
completion के लिए उपयोग किया गया मॉडल
- टाइप: stringobject
- टाइप: array object[]search
_results शीर्षक, स्निपेट और URL के साथ विस्तृत खोज परिणाम
- dateटाइप: string
- snippetटाइप: string
- sourceटाइप: string
- titleटाइप: string
- urlटाइप: string
- टाइप: objectusage
- completionटाइप: integer
_tokens Integer numbers.
- promptटाइप: integer
_tokens Integer numbers.
- searchटाइप: string
_context _size - totalटाइप: integer
_tokens Integer numbers.
application/json - 400
request संसाधित नहीं किया जा सका। request पैरामीटर जाँचें।
- 401
एक वैध Felo API key आवश्यक है।
- 402
request आगे नहीं बढ़ सकता क्योंकि बिलिंग आवश्यकता पूरी नहीं हुई है।
- 403
खाते को यह ऑपरेशन करने की अनुमति नहीं है।
- 429
request या खर्च की सीमा तक पहुँच गए हैं।
- 502
सेवा request पूरा नहीं कर सकी।
- 503
API या बिलिंग सेवा अस्थायी रूप से उपलब्ध नहीं है।
- 504
request संसाधित करते समय सेवा का समय समाप्त हो गया।
- default
त्रुटि response; upstream passthrough response प्रोवाइडर फ़ॉर्मेट का उपयोग कर सकते हैं।
application/json
curl --request POST https://openapi.felo.ai/v1/beta/perplexity/sonar-reasoning-pro \
--header "Authorization: Bearer ${FELO_API_KEY:?Set FELO_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{"model": "sonar-reasoning-pro", "messages": [{"role": "user", "content": "Explain when conditional HTTP requests save bandwidth, citing the standards."}], "max_tokens": 2048, "stream": false}'
{
"id": "example-sonar-reasoning-pro-completion",
"model": "sonar-reasoning-pro",
"object": "chat.completion",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "A successful cache validation can avoid transferring an unchanged body. [1]"
},
"finish_reason": "stop"
}
],
"citations": [
"https://www.rfc-editor.org/rfc/rfc9110.html"
],
"search_results": [
{
"title": "HTTP Semantics",
"url": "https://www.rfc-editor.org/rfc/rfc9110.html"
}
],
"usage": {
"prompt_tokens": 30,
"completion_tokens": 50,
"total_tokens": 80
}
}