v0.2.0-beta

OpenAPI 3.1.0

Perplexity Sonar Pro

Felo API Support

MIT

Serwer

https://openapi.felo.ai

Biblioteki klienckie

Shell Curl

Perplexity API

Generate answers and research reports with web citations.

Perplexity API Operacje

post/v1/beta/perplexity/sonar-pro

Perplexity Sonar Pro

Generuje odpowiedź na pytanie złożone z wielu części z użyciem wyszukiwania w sieci i cytowań. Parametry model i messages są wymagane; dla tego endpointu użyj modelu sonar-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 raportuje zużycie zasobów, a nie obciążenie kredytów Felo.

Cennik referencyjny

Rozliczanie: koszt odpowiedzi raportowany przez dostawcę.
Szacunek referencyjny dla żądania: USD 0.11273.
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

post/v1/beta/perplexity/sonar-pro

curl --request POST https://openapi.felo.ai/v1/beta/perplexity/sonar-pro \
  --header "Authorization: Bearer ${FELO_API_KEY:?Set FELO_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data '{"model": "sonar-pro", "messages": [{"role": "user", "content": "Compare Cache-Control no-cache and no-store, citing HTTP documentation."}], "max_tokens": 1024, "stream": false}'

Pokaż schemat

{
  "id": "example-sonar-pro-completion",
  "model": "sonar-pro",
  "object": "chat.completion",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "no-cache requires validation before reuse; no-store prohibits storage. [1]"
      },
      "finish_reason": "stop"
    }
  ],
  "citations": [
    "https://www.rfc-editor.org/rfc/rfc9111.html"
  ],
  "search_results": [
    {
      "title": "HTTP Caching",
      "url": "https://www.rfc-editor.org/rfc/rfc9111.html"
    }
  ],
  "usage": {
    "prompt_tokens": 25,
    "completion_tokens": 40,
    "total_tokens": 65
  }
}

Pomyślna odpowiedź z odpowiedzią AI i cytowaniami

Perplexity Sonar Pro

UwierzytelnianieRequired

Perplexity API

Perplexity Sonar Pro

Cennik referencyjny