v0.2.0-beta

OpenAPI 3.1.0

Perplexity Sonar Pro

Felo API Support

MIT

Server

https://openapi.felo.ai

Clientbibliotheken

Shell Curl

Perplexity API

Generate answers and research reports with web citations.

Perplexity API Operaties

post/v1/beta/perplexity/sonar-pro

Perplexity Sonar Pro

Genereert een antwoord op een meerdelige vraag met webzoekopdrachten en bronvermeldingen. model en messages zijn vereist; gebruik voor dit endpoint het model sonar-pro. Dit openbare contract dekt niet-gestreamde JSON-responses met stream false. Lees choices[].message.content, citations en search_results voor het antwoord en de bijbehorende bronnen. usage rapporteert resourceverbruik, geen Felo-kosten.

Prijsreferentie

Metering: Gerapporteerde responskosten.
Referentieschatting per verzoek: USD 0.11273.
Referentieklantvermenigvuldiger: 1.0. Pas deze niet opnieuw toe op een afgerekend klantbedrag.

Alleen referentiemetadata, geen accountofferte, geen gegarandeerde prijs en geen bestedingslimiet. Resourcecredits zijn geen Felo-tegoed. De uiteindelijke kosten volgen de factureringsgegevens van Felo.

Body

verplicht

application/json

messages
Type: array object[]
verplicht

Een lijst met berichten waaruit het gesprek tot nu toe bestaat.
- content
  Type: string
  verplicht
  
  De inhoud van het bericht.
- role
  Type: string enum
  verplicht
  
  De rol van de auteur van het bericht.
  
  waarden
  system
  user
  assistant
model
Type: string enum
verplicht

Het te gebruiken Sonar-model.
waarden
- sonar
- sonar-pro
- sonar-reasoning-pro
- sonar-deep-research
frequency_penalty
Type: number
min.:
0
max.:
2

Bestraft nieuwe tokens op basis van hun bestaande frequentie in de tekst tot nu toe. Positieve waarden verkleinen de kans dat dezelfde regel letterlijk wordt herhaald.
max_tokens
Type: integer

Het maximale aantal tokens dat in de respons wordt gegenereerd.
presence_penalty
Type: number
min.:
-2
max.:
2

Bestraft nieuwe tokens op basis van of ze al in de tekst voorkomen. Positieve waarden vergroten de kans dat er over nieuwe onderwerpen wordt gesproken.
return_citations
Type: boolean

Of citaties en zoekresultaten in de respons worden geretourneerd.
search_context
Type: string enum

Bepaalt hoeveel zoekcontext wordt gebruikt. Beïnvloedt de kosten per verzoek.
waarden
- low
- medium
- high
search_domain_filter
Type: array string[]

De zoekopdracht beperken tot specifieke domeinen.
search_recency_filter
Type: string enum

Zoekresultaten filteren op recentheid.
waarden
- month
- week
- day
- hour
stream
Type: boolean

Of de respons via server-sent events wordt gestreamd.
temperature
Type: number
min.:
0
max.:
2

Samplingtemperatuur tussen 0 en 2. Lagere waarden maken de uitvoer gerichter en deterministischer.
top_k
Type: integer
min.:
0
max.:
2048

Het aantal tokens dat voor top-k-filtering wordt behouden.

top_p
Type: number
min.:
0
max.:
1

Parameter voor nucleus-sampling. Het model beschouwt tokens met een top_p-waarschijnlijkheidsmassa.

Responsen

200
Type: object · ResponseD5E2470Dd28B_ChatCompletionResponse

Succesvolle respons met AI-antwoord en bronvermeldingen
choices
Type: array object[]
finish_reason
Type: string enum
waarden
stop
length
index
Type: integer

Integer numbers.

message
Type: object
content
Type: string

Het door AI gegenereerde antwoord, met inline citatieverwijzingen zoals [1][2].

role
Type: string
citations
Type: array string[]

Lijst van bron-URL's waarnaar in het antwoord wordt verwezen.

created
Type: integer

Unix-tijdstempel waarop de completion is aangemaakt.

id
Type: string

Unieke identificatie van de completion.

model
Type: string

Het model dat voor de completion is gebruikt.

object
Type: string
search_results
Type: array object[]

Gedetailleerde zoekresultaten met titels, snippets en URL's.

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

Integer numbers.

prompt_tokens
Type: integer

Integer numbers.

search_context_size
Type: string
total_tokens
Type: integer

Integer numbers.
application/json
400

Het verzoek kon niet worden verwerkt. Controleer de verzoekparameters.
401

Een geldige Felo-API-sleutel is vereist.
402

Het verzoek kan niet doorgaan omdat niet aan een factureringsvoorwaarde is voldaan.
403

Het account mag deze bewerking niet uitvoeren.
429

Een verzoek- of bestedingslimiet is bereikt.
502

De dienst kon het verzoek niet voltooien.
503

De API of factureringsdienst is tijdelijk niet beschikbaar.
504

Er is een time-out opgetreden bij het verwerken van het verzoek.
default

Foutrespons; upstream-passthrough-responsen kunnen indelingen van de provider gebruiken

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

Schema tonen

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

Succesvolle respons met AI-antwoord en bronvermeldingen

Perplexity Sonar Pro

AuthenticatieRequired

Perplexity API

Perplexity Sonar Pro

Prijsreferentie