Perplexity Sonar Deep Research

Параметры

Параметров пути, запроса и заголовков нет.

Тело запроса

• 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-deep-research" \
  -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-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
  }
}