Perplexity Sonar Deep Research

Felo API Support

MIT

सर्वर

https://openapi.felo.ai

क्लाइंट लाइब्रेरी

Shell Curl

Perplexity API

Generate answers and research reports with web citations.

Perplexity API ऑपरेशन

post/v1/beta/perplexity/sonar-deep-research

Perplexity Sonar Deep Research

कई वेब सर्च और उद्धृत स्रोतों का उपयोग करके शोध रिपोर्ट जनरेट करें। model और messages आवश्यक हैं; इस endpoint के लिए model sonar-deep-research उपयोग करें। यह सार्वजनिक कॉन्ट्रैक्ट stream false के साथ non-streaming JSON responses कवर करता है। शोध में कई मिनट लग सकते हैं और यह gateway या client timeouts से अधिक हो सकता है। रिपोर्ट और उसके स्रोतों के लिए choices[].message.content, citations और search_results पढ़ें। usage Felo क्रेडिट शुल्क नहीं है।

मूल्य संदर्भ

मीटरिंग: रिपोर्ट किया गया response लागत
संदर्भ request अनुमान: USD 0.23932
संदर्भ ग्राहक गुणक: 1.0। निपटाई गई ग्राहक राशि पर इसे दोबारा लागू न करें।

यह केवल संदर्भ मेटाडेटा है — खाते का कोटेशन, गारंटीशुदा मूल्य या खर्च सीमा नहीं। रिसोर्स क्रेडिट Felo क्रेडिट नहीं हैं। अंतिम शुल्क Felo बिलिंग रिकॉर्ड के अनुसार लगते हैं।

बॉडी

आवश्यक

application/json

messages
टाइप: array object[]
आवश्यक

अब तक की बातचीत को बनाने वाले messages की सूची।
- content
  टाइप: string
  आवश्यक
  
  message का कंटेंट।
- role
  टाइप: string enum
  आवश्यक
  
  message लेखक की भूमिका।
  
  मान
  system
  user
  assistant
model
टाइप: string enum
आवश्यक

उपयोग करने के लिए Sonar मॉडल।
मान
- sonar
- sonar-pro
- sonar-reasoning-pro
- sonar-deep-research
frequency_penalty
टाइप: number
न्यूनतम:
0
अधिकतम:
2

अब तक के टेक्स्ट में मौजूद आवृत्ति के आधार पर नए टोकन पर दंड लगाता है। धनात्मक मान उसी पंक्ति को शब्दशः दोहराने की संभावना घटाते हैं।
max_tokens
टाइप: integer

response में जनरेट करने के लिए टोकन की अधिकतम संख्या।
presence_penalty
टाइप: number
न्यूनतम:
-2
अधिकतम:
2

अब तक के टेक्स्ट में टोकन दिखने या न दिखने के आधार पर नए टोकन पर दंड लगाता है। धनात्मक मान नए विषयों पर बात करने की संभावना बढ़ाते हैं।
return_citations
टाइप: boolean

response में उद्धरण और सर्च परिणाम लौटाने हैं या नहीं।
search_context
टाइप: string enum

नियंत्रित करता है कि कितना सर्च कॉन्टेक्स्ट उपयोग होगा। प्रति-request लागत को प्रभावित करता है।
मान
- low
- medium
- high
search_domain_filter
टाइप: array string[]

खोज को विशिष्ट डोमेन तक सीमित करें।
search_recency_filter
टाइप: string enum

सर्च परिणामों को नवीनता के अनुसार फ़िल्टर करें।
मान
- month
- week
- day
- hour
stream
टाइप: boolean

server-sent events का उपयोग करके response स्ट्रीम करना है या नहीं।
temperature
टाइप: number
न्यूनतम:
0
अधिकतम:
2

0 और 2 के बीच सैंपलिंग तापमान। कम मान आउटपुट को अधिक केंद्रित और नियतात्मक बनाते हैं।
top_k
टाइप: integer
न्यूनतम:
0
अधिकतम:
2048

top-k फ़िल्टरिंग के लिए रखने वाले टोकन की संख्या।

top_p
टाइप: number
न्यूनतम:
0
अधिकतम:
1

न्यूक्लियस सैंपलिंग पैरामीटर। मॉडल top_p प्रायिकता द्रव्यमान वाले टोकन पर विचार करता है।

responses

200
टाइप: object · ResponseD5E2470Dd28B_ChatCompletionResponse

AI उत्तर और उद्धरणों के साथ सफल response
choices
टाइप: array object[]
finish_reason
टाइप: string enum
मान
stop
length
index
टाइप: integer

Integer numbers.

message
टाइप: object
content
टाइप: string

AI द्वारा जनरेट किया गया उत्तर, [1][2] जैसे इनलाइन उद्धरण संदर्भों के साथ

role
टाइप: string
citations
टाइप: array string[]

उत्तर में संदर्भित स्रोत URL की सूची

created
टाइप: integer

completion कब बनाया गया, इसका Unix टाइमस्टैम्प

id
टाइप: string

completion का विशिष्ट पहचानकर्ता

model
टाइप: string

completion के लिए उपयोग किया गया मॉडल

object
टाइप: string
search_results
टाइप: array object[]

शीर्षक, स्निपेट और URL के साथ विस्तृत खोज परिणाम

date
टाइप: string
snippet
टाइप: string
source
टाइप: string
title
टाइप: string
url
टाइप: string
usage
टाइप: object
completion_tokens
टाइप: integer

Integer numbers.

prompt_tokens
टाइप: integer

Integer numbers.

search_context_size
टाइप: string
total_tokens
टाइप: integer

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

post/v1/beta/perplexity/sonar-deep-research

curl --request POST https://openapi.felo.ai/v1/beta/perplexity/sonar-deep-research \
  --header "Authorization: Bearer ${FELO_API_KEY:?Set FELO_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data '{"model": "sonar-deep-research", "messages": [{"role": "user", "content": "Research HTTP caching strategies for public APIs, with references to standards."}], "max_tokens": 4096, "stream": false}'

स्कीमा दिखाएँ

{
  "id": "example-sonar-deep-research-completion",
  "model": "sonar-deep-research",
  "object": "chat.completion",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Public API caching combines freshness controls and conditional requests. [1][2]"
      },
      "finish_reason": "stop"
    }
  ],
  "citations": [
    "https://www.rfc-editor.org/rfc/rfc9111.html",
    "https://www.rfc-editor.org/rfc/rfc9110.html"
  ],
  "search_results": [
    {
      "title": "HTTP Caching",
      "url": "https://www.rfc-editor.org/rfc/rfc9111.html"
    },
    {
      "title": "HTTP Semantics",
      "url": "https://www.rfc-editor.org/rfc/rfc9110.html"
    }
  ],
  "usage": {
    "prompt_tokens": 40,
    "completion_tokens": 80,
    "total_tokens": 120
  }
}

AI उत्तर और उद्धरणों के साथ सफल response

Perplexity Sonar Deep Research

प्रमाणीकरणRequired

Perplexity API

Perplexity Sonar Deep Research

मूल्य संदर्भ