Perplexity API
Generate answers and research reports with web citations.
Perplexity Sonar Reasoning Pro
Web araması ve alıntılarla desteklenen akıl yürütme gerektiren bir soruyu analiz eder. model ve messages zorunludur; bu uç nokta için sonar-reasoning-pro modelini kullanın. Bu genel sözleşme, stream false ile akışsız JSON yanıtlarını kapsar. Yanıtı ve kaynaklarını choices[].message.content, citations ve search_results üzerinden okuyun. usage bir Felo kredi ücreti değildir.
Fiyatlandırma referansı
- Ölçümlendirme: bildirilen yanıt maliyeti.
- Referans istek tahmini: USD 0.03499.
- 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.
- Tür: array object[]messagesgerekli
Şimdiye kadarki konuşmayı oluşturan iletiler listesi.
- contentTür: stringgerekli
İletinin içeriği.
- roleTür: string enumgerekli
İleti yazarının rolü.
değerler- system
- user
- assistant
- Tür: string enummodelgerekli
Kullanılacak Sonar modeli.
değerler- sonar
- sonar
-pro - sonar
-reasoning -pro - sonar
-deep -research
- Tür: numberfrequency
_penalty min:0maks:2Yeni 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.
- Tür: integermax
_tokens Yanıtta oluşturulacak maksimum token sayısı.
- Tür: numberpresence
_penalty min:-2maks:2Yeni 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.
- Tür: booleanreturn
_citations Yanıtta alıntıların ve arama sonuçlarının döndürülüp döndürülmeyeceği.
- Tür: string enumsearch
_context Ne kadar arama bağlamı kullanılacağını denetler. İstek başına maliyeti etkiler.
değerler- low
- medium
- high
- Tür: array string[]search
_domain _filter Aramayı belirli alan adlarıyla sınırlayın.
- Tür: string enumsearch
_recency _filter Arama sonuçlarını güncelliğe göre filtreleyin.
değerler- month
- week
- day
- hour
- Tür: booleanstream
Yanıtın sunucu tarafından gönderilen olaylarla akış halinde iletileceğini belirtir.
- Tür: numbertemperaturemin:0maks:2
0 ile 2 arasında örnekleme sıcaklığı. Düşük değerler çıktıyı daha odaklı ve belirleyici yapar.
- Tür: integertop
_k min:0maks:2048Top-k filtrelemesi için tutulacak token sayısı.
- Tür: numbertop
_p min:0maks:1Çekirdek örnekleme parametresi. Model, top_p olasılık kütlesine sahip tokenları dikkate alır.
- Tür: object · ResponseD5E2470Dd28B_ChatCompletionResponse200
AI yanıtı ve alıntılar içeren başarılı yanıt
- Tür: array object[]choices
- finishTür: string enum
_reason değerler- stop
- length
- indexTür: integer
Integer numbers.
- messageTür: object
- contentTür: string
AI tarafından oluşturulan yanıt; [1][2] gibi satır içi atıf referansları içerir.
- roleTür: string
- Tür: array string[]citations
Yanıtta başvurulan kaynak URL'lerinin listesi.
- Tür: integercreated
Tamamlamanın oluşturulduğu Unix zaman damgası.
- Tür: stringid
Tamamlama için benzersiz tanımlayıcı.
- Tür: stringmodel
Tamamlama için kullanılan model.
- Tür: stringobject
- Tür: array object[]search
_results Başlıklar, snippet'ler ve URL'ler içeren ayrıntılı arama sonuçları.
- dateTür: string
- snippetTür: string
- sourceTür: string
- titleTür: string
- urlTür: string
- Tür: objectusage
- completionTür: integer
_tokens Integer numbers.
- promptTür: integer
_tokens Integer numbers.
- searchTür: string
_context _size - totalTür: integer
_tokens 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
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
}
}