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
  }
}