DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Canlı Perplexity LLM Responses
Bir Perplexity modeline user_prompt gönderir ve yanıtını eşzamanlı olarak döndürür. model_name get_dataforseo_ai_perplexity_llm_responses_models içinden gelmelidir — sonar, sonar-pro ve sonar-reasoning-pro. web_search_country_iso_code aramayı kapsamlandırır; diğer üç sağlayıcı bunu sunmaz. model_name, input_tokens, output_tokens, reasoning_tokens, web_search, money_spent, datetime, items ve fan_out_queries döndürür. Bir istemin gerçekte ne kadara mal olduğunu görmek için yanıttaki money_spent değerini okuyun. DataForSEO zarfı içinde: veriler tasks[0].result, sonuç tasks[0].status_code içinde — reddedilen bir istek yine de HTTP 200 döndürür.
Fiyatlandırma referansı
- Ölçümlendirme: Bildirilen yanıt maliyeti.
- Referans istek tahmini: USD 0.0163.
- Referans müşteri çarpanı: 1.0. Kesinleşmiş müşteri tutarına yeniden uygulamayın.
Yalnızca referans üst verisi; 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 | null)[]
- maxTür: integer | null
_output _tokens AI yanıtındaki maksimum token sayısı
isteğe bağlı alan
minimum değer:1
maksimum değer:4096;
varsayılan değer:2048;
Not: istekte akıl yürütme modeli belirtilirse çıktı token sayısı belirtilenmax_output_tokenssınırını aşabilir - messageTür: array (object | null)[] | null
_chain konuşma geçmişi isteğe bağlı alan önceki konuşma turlarını temsil eden mesaj nesneleri dizisi; her nesne şunları içermelidir: user veya ai rolünü içeren role dizesi; mesaj içeriğini içeren message dizesi (maks. 500 karakter); dizide en fazla 10 mesaj nesnesi belirtebilirsiniz; Not: Perplexity modellerinde mesajlar user ve AI rolleri arasında kesinlikle sırayla değişmelidir (user → ai); örnek: "message_chain": [{"role":"user","message":"Hello, what’s up?"},{"role":"ai","message":"Hello! I’m doing well, thank you. How can I assist you today?"}]
- messageTür: string | null
mesaj metni
- roleTür: string | null
mesajın kaynaklandığı kullanıcının rolü
- modelTür: string
_name AI modelinin adı
zorunlu alanmodel_namegerçek model adı ve sürüm adından oluşur;
temel model adı belirtilirse varsayılan olarak en son sürümü ayarlanır;
mevcut LLM modellerinin listesini şu uç noktaya ayrı bir istek yaparak alabilirsiniz:https://api.dataforseo.com/v3/ai_optimization/perplexity/llm_responses/models - systemTür: string | null
_message AI davranışına yönelik talimatlar
isteğe bağlı alan
AI'nın rolünü, tonunu veya belirli davranışını tanımlarsystem_messagealanında en fazla 500 karakter belirtebilirsiniz - tagTür: string | null
kullanıcı tanımlı görev tanımlayıcısı
isteğe bağlı alan
karakter sınırı 255
bu parametreyi görevi tanımlamak ve sonuçla eşleştirmek için kullanabilirsiniz
belirtilentagdeğerini yanıtındatanesnesinde bulacaksınız - temperatureTür: number | null
AI yanıtının rastgeleliği
isteğe bağlı alan
yüksek değerler çıktıyı daha çeşitli hale getirir
düşük değerler çıktıyı daha odaklı hale getirir
minimum değer:0
maksimum değer:1.9
varsayılan değer:0.77 - topTür: number | null
_p AI yanıtının çeşitliliği
isteğe bağlı alan
token seçimini sınırlayarak yanıtın çeşitliliğini kontrol eder
minimum değer:0
maksimum değer:1
varsayılan değer:0.9 - userTür: string
_prompt AI modeli için prompt
zorunlu alan
AI modeline göndermek istediğiniz soru veya görev;user_promptalanında en fazla 500 karakter belirtebilirsiniz - webTür: string | null
_search _country _iso _code web araması yerelleştirmesi için ülke kodu
isteğe bağlı alan
yerelleştirilmiş web araması sonuçları almak için ülke ISO kodunu belirtin
Not: yalnızca Perplexity Sonar modellerinde kullanılabilir
örnek:US
- Tür: object | null · Response36Afe1097B20_AiOptimizationPerplexityLlmResponsesLiveResponseInfo200
- Tür: number | null Biçim: doublecost
toplam görev maliyeti, USD
- Tür: integer | nullstatus
_code genel durum kodu yanıt kodlarının tam listesini burada bulabilirsiniz
- Tür: string | nullstatus
_message genel bilgilendirme mesajı genel bilgilendirme mesajlarının tam listesini burada bulabilirsiniz
- Tür: array (object | null)[] | nulltasks
görev dizisi
- Tür: object | null · Response36Afe1097B20_AiOptimizationPerplexityLlmResponsesLiveTaskInfo
- costTür: number | null Biçim: double
toplam görev maliyeti, USD
- dataTür: object | null
POST isteğinde belirttiğiniz parametrelerin aynısını içerir
- propertyTür: object | null
Name
- idTür: string | null
görev tanımlayıcısı sistemimizde UUID biçiminde benzersiz görev tanımlayıcısı
- pathTür: array (string | null)[] | null
URL yolu
- resultTür: array (object | null)[] | null
sonuç dizisi
- datetimeTür: string | null
sonucun alındığı tarih ve saat
UTC biçiminde: “yyyy-mm-dd hh-mm-ss +00:00”
örnek:2019-11-15 12:57:46 +00:00 - fanTür: object | null
_out _queries fan-out sorguları dizisi
daha kapsamlı bir yanıt sağlamak için ana sorgudan türetilen ilgili arama sorgularını içerir - inputTür: integer | null
_tokens girişteki token sayısı
işlenen toplam token sayısı - itemsTür: array (object | null)[] | null
yanıt öğeleri dizisi
yapılandırılmış AI yanıt verilerini içerir- Tür: object | null · Response36Afe1097B20_MessageAiOptimizationLlmResponseElementItem
- Tür: object · Response36Afe1097B20_MessageAiOptimizationLlmResponseElementItem
- typeAyırt ediciTür: string | null
öğe türü
- sectionsTür: array (object | null)[] | null
akıl yürütme zinciri bölümleri
LLM tarafından oluşturulan akıl yürütme zinciri bölümlerini içeren nesne dizisi- annotationsTür: array (object | null)[] | null
yanıtı oluşturmak için kullanılan referanslar dizisi
nulldeğerini alır; bunun istisnasıweb_searchparametresinintrueolarak ayarlanmasıdır
Not: AI web bilgilerini almaya çalışacağı ancak ilgili sonuçlar bulamayabileceği içinannotations,web_searchtrueolsa bile boş dönebilir- directTür: string | null
_url alıntılanan kaynağa doğrudan URL
urlalanındaki Vertex AI yönlendirmesinin gittiği orijinal kaynak URL'sini içerir - endTür: integer | null
_index açıklama indekslemesinin sonu
- startTür: integer | null
_index açıklama indekslemesinin başlangıcı
- textTür: string | null
akıl yürütme zinciri bölümünün metni
modelin düşünme sürecini özetleyen akıl yürütme zinciri bölümünün metni - titleTür: string | null
alıntılanan kaynağın alan adı veya başlığı
- urlTür: string | null
alıntılanan kaynağa yönlendirme URL'si
orijinal kaynağa giden bir Vertex AI yönlendirmesi içerir
- textTür: string | null
akıl yürütme zinciri bölümünün metni
modelin düşünme sürecini özetleyen akıl yürütme zinciri bölümünün metni - typeTür: string | null
öğe türü
- modelTür: string | null
_name kullanılan AI modelinin adı
- moneyTür: number | null
_spent - outputTür: integer | null
_tokens çıktıdaki token sayısı
AI yanıtında oluşturulan toplam token sayısı - reasoningTür: integer | null
_tokens Integer numbers.
- webTür: boolean | null
_search web aramasının kullanılıp kullanılmadığını belirtir
Not: web araması Perplexity Sonar modellerinde varsayılan olarak etkindir
- resultTür: integer | null Biçim: int64
_count result dizisindeki öğe sayısı
- statusTür: integer | null
_code görevin durum kodu DataForSEO tarafından oluşturulur; şu aralıkta olabilir: 10000-60000 yanıt kodlarının tam listesini burada bulabilirsiniz
- statusTür: string | null
_message görevin bilgilendirme mesajı genel bilgilendirme mesajlarının tam listesini burada bulabilirsiniz
- timeTür: string | null
yürütme süresi, saniye
- Tür: integer | null Biçim: int64tasks
_count tasks dizisindeki görev sayısı
- Tür: integer | null Biçim: int64tasks
_error tasks dizisinde hata ile dönen görev sayısı
- Tür: string | nulltime
toplam yürütme süresi, saniye
- Tür: string | nullversion
API'nin geçerli sürümü
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 https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/perplexity/llm_responses/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"system_message": "communicate as if we are in a business meeting",
"message_chain": [
{
"role": "user",
"message": "Hello, what’s up?"
},
{
"role": "ai",
"message": "Hello! I’m doing well, thank you. How can I assist you today? Are there any specific topics or projects you’d like to discuss in our meeting?"
}
],
"max_output_tokens": 200,
"temperature": 0.3,
"top_p": 0.5,
"web_search_country_iso_code": "FR",
"model_name": "sonar",
"user_prompt": "provide information on how relevant the amusement park business is in France now"
}
]'
{
"version": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"tasks_count": null,
"tasks_error": null,
"tasks": [
{
"id": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"result_count": null,
"path": [
null
],
"data": null,
"result": [
{
"model_name": null,
"input_tokens": null,
"output_tokens": null,
"reasoning_tokens": null,
"web_search": null,
"money_spent": null,
"datetime": null,
"items": [
{
"type": "[Max Depth Exceeded]",
"sections": "[Max Depth Exceeded]"
}
],
"fan_out_queries": null
}
]
}
]
}