Felo API PlatformFelo API Platform
v0.1.0-beta
OpenAPI 3.1.0

Perplexity Sonar Reasoning Pro

Felo API Support
MIT
服务器:https://openapi.felo.ai
客户端库
Shell Curl

Perplexity API

​

Generate answers and research reports with web citations.

Perplexity API 操作

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.

请求体·ChatCompletionRequest
必填
application/json
  • messages
    类型: array object[]
    必填

    A list of messages comprising the conversation so far.

    • content
      类型: string
      必填

      The content of the message.

    • role
      类型: string 枚举
      必填

      The role of the message author.

      值
      • system
      • user
      • assistant
  • model
    类型: string 枚举
    必填

    The Sonar model to use.

    值
    • sonar
    • sonar-pro
    • sonar-reasoning-pro
    • sonar-deep-research
  • frequency_penalty
    类型: number
    最小值:  
    0
    最大值:  
    2

    Penalizes new tokens based on their existing frequency in the text so far. Positive values decrease the likelihood of repeating the same line verbatim.

  • max_tokens
    类型: integer

    The maximum number of tokens to generate in the response.

  • presence_penalty
    类型: number
    最小值:  
    -2
    最大值:  
    2

    Penalizes new tokens based on whether they appear in the text so far. Positive values increase the likelihood of talking about new topics.

  • return_citations
    类型: boolean

    Whether to return citations and search results in the response.

  • search_context
    类型: string 枚举

    Controls how much search context to use. Affects per-request cost.

    值
    • low
    • medium
    • high
  • search_domain_filter
    类型: array string[]

    Limit search to specific domains.

  • search_recency_filter
    类型: string 枚举

    Filter search results by recency.

    值
    • month
    • week
    • day
    • hour
  • stream
    类型: boolean 枚举
    常量:  
    false

    Only non-streaming JSON responses are covered by this public contract. Set false.

    值
    • false
  • temperature
    类型: number
    最小值:  
    0
    最大值:  
    2

    Sampling temperature between 0 and 2. Lower values make output more focused and deterministic.

  • top_k
    类型: integer
    最小值:  
    0
    最大值:  
    2048

    The number of tokens to keep for top-k filtering.

  • top_p
    类型: number
    最小值:  
    0
    最大值:  
    1

    Nucleus sampling parameter. The model considers tokens with top_p probability mass.

响应
  • 200
    类型: object · ChatCompletionResponse

    Successful response with AI answer and citations

    • choices
      类型: array object[]
      • finish_reason
        类型: string 枚举
        值
        • stop
        • length
      • index
        类型: integer

        Integer numbers.

      • message
        类型: object
        • content
          类型: string

          The AI-generated answer, with inline citation references like [1][2].

        • role
          类型: string
    • citations
      类型: array string[]

      List of source URLs referenced in the answer.

    • created
      类型: integer

      Unix timestamp of when the completion was created.

    • id
      类型: string

      Unique identifier for the completion.

    • model
      类型: string

      The model used for the completion.

    • object
      类型: string
    • search_results
      类型: array object[]

      Detailed search results with titles, snippets, and URLs.

      • 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

    The request could not be processed. Check the request parameters.

  • 401

    A valid Felo API key is required.

  • 402

    The request cannot proceed because a billing requirement is not met.

  • 403

    The account is not permitted to perform this operation.

  • 429

    A request or spending limit has been reached.

  • 502

    The service could not complete the request.

  • 503

    The API or billing service is temporarily unavailable.

  • 504

    The service timed out while processing the request.

  • default

    The operation failed. Keep the response request ID when contacting Felo support.

Request Example for post/v1/beta/perplexity/sonar-reasoning-pro
curl --request POST https://openapi.felo.ai/v1/beta/perplexity/sonar-reasoning-pro \
  --header "Authorization: Bearer ${FELO_API_KEY:?Set FELO_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data '{"model": "sonar-reasoning-pro", "messages": [{"role": "user", "content": "Explain when conditional HTTP requests save bandwidth, citing the standards."}], "max_tokens": 2048, "stream": false}'

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

Successful response with AI answer and citations

Perplexity Sonar Reasoning Pro