Perplexity API
Generate answers and research reports with web citations.
Perplexity Sonar Reasoning Pro
Analizza una domanda che richiede ragionamento supportato da ricerca web e citazioni. model e messages sono obbligatori; per questo endpoint usa il modello sonar-reasoning-pro. Questo contratto pubblico copre risposte JSON non in streaming con stream false. Leggi choices[].message.content, citations e search_results per la risposta e le sue fonti. usage non è un addebito in crediti Felo.
Riferimento prezzi
- Misurazione: costo della risposta riportato.
- Stima di riferimento per richiesta: USD 0.03499.
- Moltiplicatore di riferimento per il cliente: 1.0. Non applicarlo di nuovo a un importo già addebitato al cliente.
Solo metadati di riferimento, non un preventivo dell'account, né un prezzo garantito o un limite di spesa. I crediti delle risorse non sono crediti Felo. Gli addebiti finali seguono le registrazioni di fatturazione Felo.
- Tipo: array object[]messagesobbligatorio
Un elenco di messaggi che compongono la conversazione finora.
- contentTipo: stringobbligatorio
Il contenuto del messaggio.
- roleTipo: string enumobbligatorio
Il ruolo dell'autore del messaggio.
valori- system
- user
- assistant
- Tipo: string enummodelobbligatorio
Il modello Sonar da usare.
valori- sonar
- sonar
-pro - sonar
-reasoning -pro - sonar
-deep -research
- Tipo: numberfrequency
_penalty min:0max:2Penalizza i nuovi token in base alla loro frequenza esistente nel testo finora. Valori positivi riducono la probabilità di ripetere la stessa riga alla lettera.
- Tipo: integermax
_tokens Il numero massimo di token da generare nella risposta.
- Tipo: numberpresence
_penalty min:-2max:2Penalizza i nuovi token in base alla loro presenza nel testo finora. Valori positivi aumentano la probabilità di parlare di nuovi argomenti.
- Tipo: booleanreturn
_citations Se restituire citazioni e risultati di ricerca nella risposta.
- Tipo: string enumsearch
_context Controlla la quantità di contesto di ricerca da usare. Influisce sul costo per richiesta.
valori- low
- medium
- high
- Tipo: array string[]search
_domain _filter Limita la ricerca a domini specifici.
- Tipo: string enumsearch
_recency _filter Filtra i risultati di ricerca per recentezza.
valori- month
- week
- day
- hour
- Tipo: booleanstream
Se trasmettere la risposta in streaming tramite server-sent events.
- Tipo: numbertemperaturemin:0max:2
Temperatura di campionamento tra 0 e 2. Valori più bassi rendono l'output più mirato e deterministico.
- Tipo: integertop
_k min:0max:2048Il numero di token da mantenere per il filtro top-k.
- Tipo: numbertop
_p min:0max:1Parametro di nucleus sampling. Il modello considera i token con massa di probabilità top_p.
- Tipo: object · ResponseD5E2470Dd28B_ChatCompletionResponse200
Risposta riuscita con output AI e citazioni
- Tipo: array object[]choices
- finishTipo: string enum
_reason valori- stop
- length
- indexTipo: integer
Integer numbers.
- messageTipo: object
- contentTipo: string
La risposta generata dall'IA, con riferimenti di citazione inline come [1][2].
- roleTipo: string
- Tipo: array string[]citations
Elenco degli URL di origine a cui si fa riferimento nella risposta.
- Tipo: integercreated
Timestamp Unix di creazione del completamento.
- Tipo: stringid
Identificatore univoco del completamento.
- Tipo: stringmodel
Il modello utilizzato per il completamento.
- Tipo: stringobject
- Tipo: array object[]search
_results Risultati di ricerca dettagliati con titoli, snippet e URL.
- dateTipo: string
- snippetTipo: string
- sourceTipo: string
- titleTipo: string
- urlTipo: string
- Tipo: objectusage
- completionTipo: integer
_tokens Integer numbers.
- promptTipo: integer
_tokens Integer numbers.
- searchTipo: string
_context _size - totalTipo: integer
_tokens Integer numbers.
application/json - 400
Impossibile elaborare la richiesta. Controlla i parametri della richiesta.
- 401
È richiesta una chiave API Felo valida.
- 402
Impossibile procedere con la richiesta perché non è soddisfatto un requisito di fatturazione.
- 403
L'account non è autorizzato a eseguire questa operazione.
- 429
È stato raggiunto un limite di richieste o di spesa.
- 502
Il servizio non è riuscito a completare la richiesta.
- 503
L'API o il servizio di fatturazione è temporaneamente non disponibile.
- 504
Si è verificato un timeout durante l'elaborazione della richiesta.
- default
Risposta di errore; le risposte passthrough upstream possono usare formati del provider
application/json
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
}
}