Felo API PlatformFelo API Platform
Wszystkie endpointy Perplexity
v0.2.0-beta
OpenAPI 3.1.0

Perplexity Sonar Reasoning Pro

Serwer:https://openapi.felo.ai
Biblioteki klienckie

Perplexity API

​

Generate answers and research reports with web citations.

Perplexity Sonar Reasoning Pro

​

Analizuje pytanie wymagające rozumowania wspartego wyszukiwaniem w sieci i cytowaniami. Parametry model i messages są wymagane; dla tego endpointu użyj modelu sonar-reasoning-pro. Ten publiczny kontrakt obejmuje nieprzesyłane strumieniowo odpowiedzi JSON z parametrem stream ustawionym na false. Odpowiedź i jej źródła odczytasz z choices[].message.content, citations i search_results. usage nie jest obciążeniem kredytów Felo.

Cennik referencyjny

  • Rozliczanie: koszt odpowiedzi raportowany przez dostawcę.
  • Szacunek referencyjny dla żądania: USD 0.03499.
  • Referencyjny mnożnik klienta: 1.0. Nie stosuj go ponownie do rozliczonej kwoty klienta.

Wyłącznie metadane referencyjne, a nie wycena konta, gwarantowana cena lub limit wydatków. Kredyty zasobów nie są kredytami Felo. Ostateczne obciążenia są zgodne z zapisami rozliczeniowymi Felo.

Treść
wymagane
application/json
  • messages
    Typ: array object[]
    wymagane

    Lista komunikatów składających się na dotychczasową rozmowę.

    • content
      Typ: string
      wymagane

      Treść komunikatu.

    • role
      Typ: string enum
      wymagane

      Rola autora komunikatu.

      wartości
      • system
      • user
      • assistant
  • model
    Typ: string enum
    wymagane

    Model Sonar do użycia.

    wartości
    • sonar
    • sonar-pro
    • sonar-reasoning-pro
    • sonar-deep-research
  • frequency_penalty
    Typ: number
    min.:  
    0
    maks.:  
    2

    Karze nowe tokeny na podstawie ich dotychczasowej częstotliwości w tekście. Wartości dodatnie zmniejszają prawdopodobieństwo dosłownego powtórzenia tej samej linii.

  • max_tokens
    Typ: integer

    Maksymalna liczba tokenów do wygenerowania w odpowiedzi.

  • presence_penalty
    Typ: number
    min.:  
    -2
    maks.:  
    2

    Karze nowe tokeny na podstawie tego, czy występują już w tekście. Wartości dodatnie zwiększają prawdopodobieństwo poruszania nowych tematów.

  • return_citations
    Typ: boolean

    Określa, czy zwracać cytowania i wyniki wyszukiwania w odpowiedzi.

  • search_context
    Typ: string enum

    Kontroluje, ile kontekstu wyszukiwania wykorzystać. Wpływa na koszt żądania.

    wartości
    • low
    • medium
    • high
  • search_domain_filter
    Typ: array string[]

    Ogranicz wyszukiwanie do określonych domen.

  • search_recency_filter
    Typ: string enum

    Filtruj wyniki wyszukiwania według aktualności.

    wartości
    • month
    • week
    • day
    • hour
  • stream
    Typ: boolean

    Określa, czy strumieniować odpowiedź za pomocą zdarzeń wysyłanych przez serwer.

  • temperature
    Typ: number
    min.:  
    0
    maks.:  
    2

    Temperatura próbkowania od 0 do 2. Niższe wartości czynią dane wyjściowe bardziej skupionymi i deterministycznymi.

  • top_k
    Typ: integer
    min.:  
    0
    maks.:  
    2048

    Liczba tokenów zachowywanych do filtrowania top-k.

  • top_p
    Typ: number
    min.:  
    0
    maks.:  
    1

    Parametr próbkowania jądrowego. Model uwzględnia tokeny o masie prawdopodobieństwa top_p.

Odpowiedzi
  • 200
    Typ: object · ResponseD5E2470Dd28B_ChatCompletionResponse

    Pomyślna odpowiedź z odpowiedzią AI i cytowaniami

    • choices
      Typ: array object[]
      • finish_reason
        Typ: string enum
        wartości
        • stop
        • length
      • index
        Typ: integer

        Integer numbers.

      • message
        Typ: object
        • content
          Typ: string

          Odpowiedź wygenerowana przez AI, z wbudowanymi odwołaniami do cytatów, np. [1][2].

        • role
          Typ: string
    • citations
      Typ: array string[]

      Lista adresów URL źródeł przywołanych w odpowiedzi.

    • created
      Typ: integer

      Znacznik czasu Unix utworzenia uzupełnienia.

    • id
      Typ: string

      Unikalny identyfikator uzupełnienia.

    • model
      Typ: string

      Model użyty do uzupełnienia.

    • object
      Typ: string
    • search_results
      Typ: array object[]

      Szczegółowe wyniki wyszukiwania z tytułami, fragmentami i adresami URL.

      • date
        Typ: string
      • snippet
        Typ: string
      • source
        Typ: string
      • title
        Typ: string
      • url
        Typ: string
    • usage
      Typ: object
      • completion_tokens
        Typ: integer

        Integer numbers.

      • prompt_tokens
        Typ: integer

        Integer numbers.

      • search_context_size
        Typ: string
      • total_tokens
        Typ: integer

        Integer numbers.

    application/json
  • 400

    Nie można przetworzyć żądania. Sprawdź parametry żądania.

  • 401

    Wymagany jest prawidłowy klucz API Felo.

  • 402

    Nie można kontynuować żądania, ponieważ nie spełniono wymogu rozliczeniowego.

  • 403

    Konto nie ma uprawnień do wykonania tej operacji.

  • 429

    Osiągnięto limit żądań lub wydatków.

  • 502

    Usługa nie mogła ukończyć żądania.

  • 503

    API lub usługa rozliczeniowa jest tymczasowo niedostępna.

  • 504

    Upłynął limit czasu usługi podczas przetwarzania żądania.

  • default

    Odpowiedź błędu; odpowiedzi przekazywane bezpośrednio od dostawcy upstream mogą używać formatów dostawcy

    application/json
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
  }
}
Perplexity Sonar Reasoning Pro