v0.2.0-beta

OpenAPI 3.1.0

Perplexity Sonar

Felo API Support

MIT

Serveur

https://openapi.felo.ai

Bibliothèques clientes

Shell Curl

Perplexity API

Generate answers and research reports with web citations.

Perplexity API Opérations

post/v1/beta/perplexity/sonar

Perplexity Sonar

Génère une réponse concise avec des citations web. model et messages sont obligatoires ; utilisez le modèle sonar pour ce point de terminaison. Ce contrat public couvre les réponses JSON sans streaming avec stream false. Lisez la réponse dans choices[].message.content et les sources dans citations et search_results. usage indique une consommation de ressources, pas un débit en crédits Felo.

Référence tarifaire

Mesure : coût de réponse déclaré.
Estimation de référence par requête : USD 0.12783.
Multiplicateur client de référence : 1.0. Ne pas l'appliquer à nouveau à un montant client déjà réglé.

Métadonnées de référence uniquement, et non un devis de compte, un prix garanti ou un plafond de dépenses. Les crédits de ressources ne sont pas des crédits Felo. Les débits définitifs suivent les enregistrements de facturation Felo.

Corps

obligatoire

application/json

messages
Type: array object[]
obligatoire

Une liste de messages composant la conversation jusqu'ici.
- content
  Type: string
  obligatoire
  
  Le contenu du message.
- role
  Type: string enum
  obligatoire
  
  Le rôle de l'auteur du message.
  
  valeurs
  system
  user
  assistant
model
Type: string enum
obligatoire

Le modèle Sonar à utiliser.
valeurs
- sonar
- sonar-pro
- sonar-reasoning-pro
- sonar-deep-research
frequency_penalty
Type: number
min.:
0
max.:
2

Pénalise les nouveaux tokens en fonction de leur fréquence existante dans le texte jusqu'ici. Les valeurs positives réduisent la probabilité de répéter la même ligne mot pour mot.
max_tokens
Type: integer

Nombre maximal de tokens à générer dans la réponse.
presence_penalty
Type: number
min.:
-2
max.:
2

Pénalise les nouveaux tokens selon qu'ils apparaissent ou non dans le texte jusqu'ici. Les valeurs positives augmentent la probabilité d'aborder de nouveaux sujets.
return_citations
Type: boolean

Indique s'il faut renvoyer les citations et les résultats de recherche dans la réponse.
search_context
Type: string enum

Contrôle la quantité de contexte de recherche à utiliser. Affecte le coût par requête.
valeurs
- low
- medium
- high
search_domain_filter
Type: array string[]

Limite la recherche à des domaines spécifiques.
search_recency_filter
Type: string enum

Filtre les résultats de recherche par récence.
valeurs
- month
- week
- day
- hour
stream
Type: boolean

Indique s'il faut diffuser la réponse via des server-sent events.
temperature
Type: number
min.:
0
max.:
2

Température d'échantillonnage entre 0 et 2. Des valeurs plus faibles rendent la sortie plus ciblée et déterministe.
top_k
Type: integer
min.:
0
max.:
2048

Nombre de tokens à conserver pour le filtrage top-k.

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

Paramètre d'échantillonnage par noyau. Le modèle considère les tokens dont la masse de probabilité atteint top_p.

Réponses

200
Type: object · ResponseD5E2470Dd28B_ChatCompletionResponse

Réponse réussie avec réponse IA et citations
choices
Type: array object[]
finish_reason
Type: string enum
valeurs
stop
length
index
Type: integer

Integer numbers.

message
Type: object
content
Type: string

La réponse générée par IA, avec des références de citation en ligne comme [1][2].

role
Type: string
citations
Type: array string[]

Liste des URL sources citées dans la réponse.

created
Type: integer

Horodatage Unix de création de la complétion.

id
Type: string

Identifiant unique de la complétion.

model
Type: string

Le modèle utilisé pour la complétion.

object
Type: string
search_results
Type: array object[]

Résultats de recherche détaillés avec titres, extraits et URL.

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

La requête n'a pas pu être traitée. Vérifiez les paramètres de la requête.
401

Une clé API Felo valide est requise.
402

La requête ne peut pas aboutir car une condition de facturation n'est pas remplie.
403

Le compte n'est pas autorisé à effectuer cette opération.
429

Une limite de requêtes ou de dépenses a été atteinte.
502

Le service n'a pas pu terminer la requête.
503

L'API ou le service de facturation est temporairement indisponible.
504

Le service a expiré lors du traitement de la requête.
default

Réponse d'erreur ; les réponses transmises depuis l'upstream peuvent utiliser les formats du fournisseur

application/json

post/v1/beta/perplexity/sonar

curl --request POST https://openapi.felo.ai/v1/beta/perplexity/sonar \
  --header "Authorization: Bearer ${FELO_API_KEY:?Set FELO_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data '{"model": "sonar", "messages": [{"role": "user", "content": "What is HTTP caching? Cite the relevant documentation."}], "max_tokens": 512, "stream": false}'

Afficher le schéma

{
  "id": "example-sonar-completion",
  "model": "sonar",
  "object": "chat.completion",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "HTTP caching reuses stored responses when permitted by cache rules. [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": 20,
    "completion_tokens": 30,
    "total_tokens": 50
  }
}

Réponse réussie avec réponse IA et citations

Perplexity Sonar

AuthentificationRequired

Perplexity API

Perplexity Sonar

Référence tarifaire