Perplexity API
Generate answers and research reports with web citations.
Perplexity Sonar Pro
वेब सर्च और उद्धरणों का उपयोग करके बहु-भाग वाले प्रश्न का उत्तर जनरेट करें। model और messages आवश्यक हैं; इस endpoint के लिए model sonar-pro उपयोग करें। यह सार्वजनिक कॉन्ट्रैक्ट stream false के साथ non-streaming JSON responses कवर करता है। उत्तर और उसके स्रोतों के लिए choices[].message.content, citations और search_results पढ़ें। usage रिसोर्स खपत बताता है, Felo क्रेडिट शुल्क नहीं।
मूल्य संदर्भ
- मीटरिंग: रिपोर्ट किया गया response लागत
- संदर्भ request अनुमान: USD 0.11273
- संदर्भ ग्राहक गुणक: 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-pro \
--header "Authorization: Bearer ${FELO_API_KEY:?Set FELO_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{"model": "sonar-pro", "messages": [{"role": "user", "content": "Compare Cache-Control no-cache and no-store, citing HTTP documentation."}], "max_tokens": 1024, "stream": false}'
{
"id": "example-sonar-pro-completion",
"model": "sonar-pro",
"object": "chat.completion",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "no-cache requires validation before reuse; no-store prohibits storage. [1]"
},
"finish_reason": "stop"
}
],
"citations": [
"https://www.rfc-editor.org/rfc/rfc9111.html"
],
"search_results": [
{
"title": "HTTP Caching",
"url": "https://www.rfc-editor.org/rfc/rfc9111.html"
}
],
"usage": {
"prompt_tokens": 25,
"completion_tokens": 40,
"total_tokens": 65
}
}