DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Canlı Claude LLM Yanıtları
Bir Claude modeline user_prompt gönderir ve yanıtını eşzamanlı olarak döndürür. model_name, get_dataforseo_ai_claude_llm_responses_models kaynağından gelmelidir — adlar claude-sonnet-5 gibi görünür ve akla yatkın görünen bir tahmin reddedilir. 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ına sarılıdır: veriler tasks[0].result içinde, 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.0567.
- 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 | null)[]
- forceTür: boolean | null
_web _search AI aracısını web araması kullanmaya zorla
isteğe bağlı alan
bu parametreyi etkinleştirmek içinweb_searchde etkin olmalıdır;
etkinleştirildiğinde AI modeli güncel web bilgilerine erişmeye ve bunları alıntılamaya zorlanır;
varsayılan değer:false;
Not: parametretrueolarak ayarlansa bile yanıtta web kaynaklarının alıntılanacağı garanti edilmez - 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:web_searchtrueolarak ayarlanırsa veya istekte akıl yürütme modeli belirtilirse çıktı token sayısı belirtilenmax_output_tokenssınırını aşabilir
Not 2:use_reasoningtrueolarak ayarlanırsamax_output_tokensiçin minimum değer1025olur - 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;
örneğinclaude-opus-4-0belirtilirsemodel_nameolarak otomatikmanclaude-opus-4-20250514ayarlanır;
mevcut LLM modellerinin listesini ayrı bir istek göndererek şu adresten alabilirsiniz:https://api.dataforseo.com/v3/ai_optimization/claude/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ımlar;system_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
varsayılan değer:0.7Not:
temperatureaynı istektetop_pile birlikte kullanılamaz - 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:nullNot:
top_paynı istektetemperatureile birlikte kullanılamaz - useTür: boolean | null
_reasoning AI modeli için akıl yürütmeyi etkinleştir
isteğe bağlı alan
etkinleştirildiğinde model yanıt üretmeden önce akıl yürütme yaparreasoningdestekleyen modellerin listesi için Models uç noktasına bakın
varsayılan değer:false
Not:trueolarak ayarlanırsamax_output_tokensiçin minimum değer1025olur
Not 2:trueolarak ayarlanırsaforce_web_searchfalseolarak ayarlanmalıdır
Not 3:trueolarak ayarlanırsatemperaturevetop_pkullanılamaz - 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: boolean | null
_search güncel bilgiler için web aramasını etkinleştir
isteğe bağlı alan
etkinleştirildiğinde AI modeli güncel web bilgilerine erişebilir ve bunları alıntılayabilir;
Not:web_searchdestekleyen modellerin listesi için Models uç noktasına bakın;
varsayılan değer:false;
Parametrenin maliyeti Fiyatlandırma sayfasında hesaplanabilir - webTür: string | null
_search _city web araması için kullanılan konumun şehir adı
isteğe bağlı alan - webTür: string | null
_search _country _iso _code web araması için kullanılan konumun ISO ülke kodu
isteğe bağlı alan
olası değerler:'AR','AT','AU','BE','BR','CA','CH','CL','CN','DE','DK','ES','FI','FR','GB','HK','ID','IN','IT','JP','KR','MX','MY','NL','NO','NZ','PH','PL','PT','RU','SA','SE','TR','TW','US','ZA'
- Tür: object | null · Response36Afe1097B20_AiOptimizationClaudeLlmResponsesLiveResponseInfo200
- 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_AiOptimizationClaudeLlmResponsesLiveTaskInfo
- 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: array (string | null)[] | 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- 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 akıl yürütme tokenlarının sayısı
akıl yürütme içeriğini oluşturmak için kullanılan toplam token sayısı - webTür: boolean | null
_search web aramasının kullanılıp kullanılmadığını belirtir
- 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/claude/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,
"model_name": "claude-opus-4-0",
"temperature": 0.3,
"web_search": true,
"web_search_country_iso_code": "FR",
"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": null
}
],
"fan_out_queries": [
null
]
}
]
}
]
}