데이터 API / Perplexity / Sonar Reasoning Pro
Perplexity Sonar Reasoning Pro
Analyze a question requiring reasoning supported by web search and citations. model and messages are required; use model sonar-reasoning-pro for this endpoint. This public contract covers non-streaming JSON responses with stream false. Read choices[].message.content, citations and search_results for the answer and its sources. usage is not a Felo credit charge.
파라미터
경로, 쿼리, 헤더 파라미터가 없습니다.
요청 본문
modelstring필수허용 값: sonar · sonar-pro · sonar-reasoning-pro · sonar-deep-research
The Sonar model to use.
messagesobject[]필수A list of messages comprising the conversation so far.
rolestring필수허용 값: system · user · assistant
The role of the message author.
contentstring필수The content of the message.
max_tokensinteger선택The maximum number of tokens to generate in the response.
temperaturenumber선택Sampling temperature between 0 and 2. Lower values make output more focused and deterministic.
top_pnumber선택Nucleus sampling parameter. The model considers tokens with top_p probability mass.
top_kinteger선택The number of tokens to keep for top-k filtering.
streamboolean선택허용 값: false
Only non-streaming JSON responses are covered by this public contract. Set false.
search_contextstring선택허용 값: low · medium · high
Controls how much search context to use. Affects per-request cost.
frequency_penaltynumber선택Penalizes new tokens based on their existing frequency in the text so far. Positive values decrease the likelihood of repeating the same line verbatim.
presence_penaltynumber선택Penalizes new tokens based on whether they appear in the text so far. Positive values increase the likelihood of talking about new topics.
return_citationsboolean선택Whether to return citations and search results in the response.
search_recency_filterstring선택허용 값: month · week · day · hour
Filter search results by recency.
search_domain_filterstring[]선택Limit search to specific domains.
요청 예시
curl -X POST "https://openapi.felo.ai/v1/beta/perplexity/sonar-reasoning-pro" \
-H "Authorization: Bearer $FELO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "<string>",
"messages": [
{}
],
"max_tokens": 0,
"temperature": 0,
"top_p": 0,
"top_k": 0,
"stream": false,
"search_context": "<string>"
}'응답
응답 예시
{
"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
}
}응답 필드
idstring선택Unique identifier for the completion.
modelstring선택The model used for the completion.
objectstring선택createdinteger선택Unix timestamp of when the completion was created.
choicesobject[]선택indexinteger선택messageobject선택rolestring선택contentstring선택The AI-generated answer, with inline citation references like [1][2].
finish_reasonstring선택허용 값: stop · length
citationsstring[]선택List of source URLs referenced in the answer.
search_resultsobject[]선택Detailed search results with titles, snippets, and URLs.
titlestring선택urlstring선택snippetstring선택datestring선택sourcestring선택usageobject선택prompt_tokensinteger선택completion_tokensinteger선택total_tokensinteger선택search_context_sizestring선택