v0.2.0-beta

OpenAPI 3.1.0

Perplexity Sonar Pro

Felo API Support

MIT

Server

https://openapi.felo.ai

Librerie client

Shell Curl

Perplexity API

Generate answers and research reports with web citations.

Perplexity API Operazioni

post/v1/beta/perplexity/sonar-pro

Perplexity Sonar Pro

Genera una risposta a una domanda in più parti con ricerca web e citazioni. model e messages sono obbligatori; per questo endpoint usa il modello sonar-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 riporta il consumo di risorse, non un addebito Felo.

Riferimento prezzi

Misurazione: costo della risposta riportato.
Stima di riferimento per richiesta: USD 0.11273.
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.

Corpo

obbligatorio

application/json

messages
Tipo: array object[]
obbligatorio

Un elenco di messaggi che compongono la conversazione finora.
- content
  Tipo: string
  obbligatorio
  
  Il contenuto del messaggio.
- role
  Tipo: string enum
  obbligatorio
  
  Il ruolo dell'autore del messaggio.
  
  valori
  system
  user
  assistant
model
Tipo: string enum
obbligatorio

Il modello Sonar da usare.
valori
- sonar
- sonar-pro
- sonar-reasoning-pro
- sonar-deep-research
frequency_penalty
Tipo: number
min:
0
max:
2

Penalizza i nuovi token in base alla loro frequenza esistente nel testo finora. Valori positivi riducono la probabilità di ripetere la stessa riga alla lettera.
max_tokens
Tipo: integer

Il numero massimo di token da generare nella risposta.
presence_penalty
Tipo: number
min:
-2
max:
2

Penalizza i nuovi token in base alla loro presenza nel testo finora. Valori positivi aumentano la probabilità di parlare di nuovi argomenti.
return_citations
Tipo: boolean

Se restituire citazioni e risultati di ricerca nella risposta.
search_context
Tipo: string enum

Controlla la quantità di contesto di ricerca da usare. Influisce sul costo per richiesta.
valori
- low
- medium
- high
search_domain_filter
Tipo: array string[]

Limita la ricerca a domini specifici.
search_recency_filter
Tipo: string enum

Filtra i risultati di ricerca per recentezza.
valori
- month
- week
- day
- hour
stream
Tipo: boolean

Se trasmettere la risposta in streaming tramite server-sent events.
temperature
Tipo: number
min:
0
max:
2

Temperatura di campionamento tra 0 e 2. Valori più bassi rendono l'output più mirato e deterministico.
top_k
Tipo: integer
min:
0
max:
2048

Il numero di token da mantenere per il filtro top-k.

top_p
Tipo: number
min:
0
max:
1

Parametro di nucleus sampling. Il modello considera i token con massa di probabilità top_p.

Risposte

200
Tipo: object · ResponseD5E2470Dd28B_ChatCompletionResponse

Risposta riuscita con output AI e citazioni
choices
Tipo: array object[]
finish_reason
Tipo: string enum
valori
stop
length
index
Tipo: integer

Integer numbers.

message
Tipo: object
content
Tipo: string

La risposta generata dall'IA, con riferimenti di citazione inline come [1][2].

role
Tipo: string
citations
Tipo: array string[]

Elenco degli URL di origine a cui si fa riferimento nella risposta.

created
Tipo: integer

Timestamp Unix di creazione del completamento.

id
Tipo: string

Identificatore univoco del completamento.

model
Tipo: string

Il modello utilizzato per il completamento.

object
Tipo: string
search_results
Tipo: array object[]

Risultati di ricerca dettagliati con titoli, snippet e URL.

date
Tipo: string
snippet
Tipo: string
source
Tipo: string
title
Tipo: string
url
Tipo: string
usage
Tipo: object
completion_tokens
Tipo: integer

Integer numbers.

prompt_tokens
Tipo: integer

Integer numbers.

search_context_size
Tipo: string
total_tokens
Tipo: integer

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

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

Mostra schema

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

Risposta riuscita con output AI e citazioni

Perplexity Sonar Pro

AutenticazioneRequired

Perplexity API

Perplexity Sonar Pro

Riferimento prezzi