v0.2.0-beta

OpenAPI 3.1.0

Perplexity Sonar

Felo API Support

MIT

Sunucu

https://openapi.felo.ai

İstemci Kitaplıkları

Shell Curl

Perplexity API

Generate answers and research reports with web citations.

Perplexity API İşlemler

post/v1/beta/perplexity/sonar

Perplexity Sonar

Web alıntılarıyla kısa bir yanıt üretir. model ve messages zorunludur; bu uç nokta için sonar modelini kullanın. Bu genel sözleşme, stream false ile akışsız JSON yanıtlarını kapsar. Yanıtı choices[].message.content, kaynakları citations ve search_results üzerinden okuyun. usage, Felo kredi ücretini değil kaynak tüketimini bildirir.

Fiyatlandırma referansı

Ölçümlendirme: bildirilen yanıt maliyeti.
Referans istek tahmini: USD 0.12783.
Referans müşteri çarpanı: 1.0. Kesinleşmiş müşteri tutarına yeniden uygulamayın.

Yalnızca referans üst verisidir; hesap teklifi, garantili fiyat veya harcama üst sınırı değildir. Kaynak kredileri Felo kredisi değildir. Nihai ücretler Felo faturalandırma kayıtlarını izler.

Gövde

gerekli

application/json

messages
Tür: array object[]
gerekli

Şimdiye kadarki konuşmayı oluşturan iletiler listesi.
- content
  Tür: string
  gerekli
  
  İletinin içeriği.
- role
  Tür: string enum
  gerekli
  
  İleti yazarının rolü.
  
  değerler
  system
  user
  assistant
model
Tür: string enum
gerekli

Kullanılacak Sonar modeli.
değerler
- sonar
- sonar-pro
- sonar-reasoning-pro
- sonar-deep-research
frequency_penalty
Tür: number
min:
0
maks:
2

Yeni tokenları metindeki mevcut sıklıklarına göre cezalandırır. Pozitif değerler aynı satırın birebir tekrarlanma olasılığını azaltır.
max_tokens
Tür: integer

Yanıtta oluşturulacak maksimum token sayısı.
presence_penalty
Tür: number
min:
-2
maks:
2

Yeni tokenları metinde hâlihazırda bulunup bulunmadıklarına göre cezalandırır. Pozitif değerler yeni konulardan söz etme olasılığını artırır.
return_citations
Tür: boolean

Yanıtta alıntıların ve arama sonuçlarının döndürülüp döndürülmeyeceği.
search_context
Tür: string enum

Ne kadar arama bağlamı kullanılacağını denetler. İstek başına maliyeti etkiler.
değerler
- low
- medium
- high
search_domain_filter
Tür: array string[]

Aramayı belirli alan adlarıyla sınırlayın.
search_recency_filter
Tür: string enum

Arama sonuçlarını güncelliğe göre filtreleyin.
değerler
- month
- week
- day
- hour
stream
Tür: boolean

Yanıtın sunucu tarafından gönderilen olaylarla akış halinde iletileceğini belirtir.
temperature
Tür: number
min:
0
maks:
2

0 ile 2 arasında örnekleme sıcaklığı. Düşük değerler çıktıyı daha odaklı ve belirleyici yapar.
top_k
Tür: integer
min:
0
maks:
2048

Top-k filtrelemesi için tutulacak token sayısı.

top_p
Tür: number
min:
0
maks:
1

Çekirdek örnekleme parametresi. Model, top_p olasılık kütlesine sahip tokenları dikkate alır.

Yanıtlar

200
Tür: object · ResponseD5E2470Dd28B_ChatCompletionResponse

AI yanıtı ve alıntılar içeren başarılı yanıt
choices
Tür: array object[]
finish_reason
Tür: string enum
değerler
stop
length
index
Tür: integer

Integer numbers.

message
Tür: object
content
Tür: string

AI tarafından oluşturulan yanıt; [1][2] gibi satır içi atıf referansları içerir.

role
Tür: string
citations
Tür: array string[]

Yanıtta başvurulan kaynak URL'lerinin listesi.

created
Tür: integer

Tamamlamanın oluşturulduğu Unix zaman damgası.

id
Tür: string

Tamamlama için benzersiz tanımlayıcı.

model
Tür: string

Tamamlama için kullanılan model.

object
Tür: string
search_results
Tür: array object[]

Başlıklar, snippet'ler ve URL'ler içeren ayrıntılı arama sonuçları.

date
Tür: string
snippet
Tür: string
source
Tür: string
title
Tür: string
url
Tür: string
usage
Tür: object
completion_tokens
Tür: integer

Integer numbers.

prompt_tokens
Tür: integer

Integer numbers.

search_context_size
Tür: string
total_tokens
Tür: integer

Integer numbers.
application/json
400

İstek işlenemedi. İstek parametrelerini kontrol edin.
401

Geçerli bir Felo API anahtarı gerekir.
402

Faturalandırma koşulu karşılanmadığı için istek devam edemiyor.
403

Hesabın bu işlemi gerçekleştirme izni yok.
429

İstek veya harcama sınırına ulaşıldı.
502

Hizmet isteği tamamlayamadı.
503

API veya faturalandırma hizmeti geçici olarak kullanılamıyor.
504

İstek işlenirken hizmet zaman aşımına uğradı.
default

Hata yanıtı; upstream sağlayıcıdan doğrudan aktarılan yanıtlar sağlayıcı biçimlerini kullanabilir

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

Şemayı göster

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

AI yanıtı ve alıntılar içeren başarılı yanıt

Perplexity Sonar

Kimlik doğrulamaRequired

Perplexity API

Perplexity Sonar

Fiyatlandırma referansı