v0.2.0-beta

OpenAPI 3.1.0

LLM Responses Claude görevlerini ayarlama

Felo API Support

MIT

Sunucu

https://openapi.felo.ai

İstemci Kitaplıkları

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO İşlemler

post/v1/beta/dataforseo/ai_optimization/claude/llm_responses/task_post

LLM Responses Claude görevlerini ayarlama

Beklemek yerine bir Claude istemini kuyruğa alır ve bir görev id değeri döndürür. 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. Önce get_dataforseo_ai_claude_llm_responses_models içindeki task_post_supported değerini kontrol edin ve sonucu get_dataforseo_ai_claude_llm_responses_fetch ile alın.

Fiyatlandırma referansı

Ölçümlendirme: Bildirilen yanıt maliyeti.
Referans istek tahmini: USD 0.701.
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.

Gövde

application/json

Tür: array (object | null)[]
- force_web_search
  Tür: boolean | null
  
  AI aracısını web araması kullanmaya zorla
  isteğe bağlı alan
  bu parametreyi etkinleştirmek için web_search de 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: parametre true olarak ayarlansa bile yanıtta web kaynaklarının alıntılanacağı garanti edilmez
- max_output_tokens
  Tür: integer | null
  
  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_search true olarak ayarlanırsa veya istekte akıl yürütme modeli belirtilirse çıktı token sayısı belirtilen max_output_tokens sınırını aşabilir
  Not 2: use_reasoning true olarak ayarlanırsa max_output_tokens için minimum değer 1025 olur
- message_chain
  Tür: array (object | null)[] | null
  
  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?"}]
  
  message
  Tür: string | null
  
  mesaj metni
  
  role
  Tür: string | null
  
  mesajın kaynaklandığı kullanıcının rolü
- model_name
  Tür: string
  
  AI modelinin adı
  zorunlu alan
  model_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ğin claude-opus-4-0 belirtilirse model_name olarak otomatikman claude-opus-4-20250514 ayarlanır;
  mevcut LLM modellerinin listesini ayrı bir istek göndererek şu adresten alabilirsiniz: https://api.dataforseo.com/v3/ai_optimization/claude/llm_responses/models
- pingback_url
  Tür: string | null
  
  tamamlanan görevin bildirim URL'si
  isteğe bağlı alan
  görev tamamlandığında belirttiğiniz URL'ye gönderilen GET isteğiyle sizi bilgilendireceğiz
  ‘$id’ dizesini $id değişkeni, ‘$tag’ dizesini ise URL kodlu $tag değişkeni olarak kullanabilirsiniz. İsteği göndermeden önce gerekli değerleri ayarlayacağız
  örnek:
  http://your-server.com/pingscript?id=$id
  http://your-server.com/pingscript?id=$id&tag=$tag
  Not: pingback_url içindeki özel karakterler URL kodlanır;
  yani, # karakteri %23 olarak kodlanır
  
  daha fazla bilgi için Yardım Merkezimize bakın
- postback_url
  Tür: string | null
  
  görev sonuçlarını göndermek için URL
  isteğe bağlı alan
  görev tamamlandığında sonuçlarını gzip biçiminde sıkıştırarak belirttiğiniz postback_url adresine POST isteğiyle göndereceğiz
  ‘$id’ dizesini $id değişkeni, ‘$tag’ dizesini ise URL kodlu $tag değişkeni olarak kullanabilirsiniz. İsteği göndermeden önce gerekli değerleri ayarlayacağız.
  örnek:
  http://your-server.com/postbackscript?id=$id
  http://your-server.com/postbackscript?id=$id&tag=$tag
  Not: postback_url içindeki özel karakterler URL kodlanır;
  yani, # karakteri %23 olarak kodlanır
  
  daha fazla bilgi için Yardım Merkezimize bakın
- system_message
  Tür: string | null
  
  AI davranışına yönelik talimatlar
  isteğe bağlı alan
  AI'nın rolünü, tonunu veya belirli davranışını tanımlar;
  system_message alanında en fazla 500 karakter belirtebilirsiniz
- tag
  Tü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
  belirtilen tag değerini yanıtın data nesnesinde bulacaksınız
- temperature
  Tü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.7
  
  Not: temperature aynı istekte top_p ile birlikte kullanılamaz
- top_p
  Tür: number | null
  
  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: null
  
  Not: top_p aynı istekte temperature ile birlikte kullanılamaz
- use_reasoning
  Tür: boolean | null
  
  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 yapar
  reasoning destekleyen modellerin listesi için Models uç noktasına bakın
  varsayılan değer: false
  Not: true olarak ayarlanırsa max_output_tokens için minimum değer 1025 olur
  Not 2: true olarak ayarlanırsa force_web_search false olarak ayarlanmalıdır
  Not 3: true olarak ayarlanırsa temperature ve top_p kullanılamaz
- user_prompt
  Tür: string
  
  AI modeli için prompt
  zorunlu alan
  AI modeline göndermek istediğiniz soru veya görev;
  user_prompt alanında en fazla 500 karakter belirtebilirsiniz
- web_search
  Tür: boolean | null
  
  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_search destekleyen modellerin listesi için Models uç noktasına bakın;
  varsayılan değer: false;
  Parametrenin maliyeti Fiyatlandırma sayfasında hesaplanabilir
- web_search_city
  Tür: string | null
  
  web araması için kullanılan konumun şehir adı
  isteğe bağlı alan
- web_search_country_iso_code
  Tür: string | null
  
  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'

Yanıtlar

200
Tür: object | null · Response36Afe1097B20_AiOptimizationClaudeLlmResponsesTaskPostResponseInfo
cost
Tür: number | null Biçim: double

toplam görev maliyeti, USD

status_code
Tür: integer | null

genel durum kodu yanıt kodlarının tam listesini burada bulabilirsiniz

status_message
Tür: string | null

genel bilgilendirme mesajı genel bilgilendirme mesajlarının tam listesini burada bulabilirsiniz

tasks
Tür: array (object | null)[] | null

görev dizisi

Tür: object | null · Response36Afe1097B20_AiOptimizationClaudeLlmResponsesTaskPostTaskInfo
cost
Tür: number | null Biçim: double

toplam görev maliyeti, USD

data
Tür: object | null

POST isteğinde belirttiğiniz parametrelerin aynısını içerir

propertyName
Tür: object | null
id
Tür: string | null

görev tanımlayıcısı sistemimizde UUID biçiminde benzersiz görev tanımlayıcısı

path
Tür: array (string | null)[] | null

URL yolu

result
Tür: object | null

sonuç dizisi
bu durumda değer null olur

result_count
Tür: integer | null Biçim: int64

result dizisindeki öğe sayısı

status_code
Tür: integer | null

görevin durum kodu DataForSEO tarafından oluşturulur; şu aralıkta olabilir: 10000-60000 yanıt kodlarının tam listesini burada bulabilirsiniz

status_message
Tür: string | null

görevin bilgilendirme mesajı genel bilgilendirme mesajlarının tam listesini burada bulabilirsiniz

time
Tür: string | null

yürütme süresi, saniye

tasks_count
Tür: integer | null Biçim: int64

tasks dizisindeki görev sayısı

tasks_error
Tür: integer | null Biçim: int64

tasks dizisinde hata ile dönen görev sayısı

time
Tür: string | null

toplam yürütme süresi, saniye

version
Tür: string | null

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

post/v1/beta/dataforseo/ai_optimization/claude/llm_responses/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/claude/llm_responses/task_post \
  --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": 1024,
    "temperature": 0.3,
    "web_search_country_iso_code": "FR",
    "model_name": "claude-sonnet-4-0",
    "web_search": true,
    "user_prompt": "provide information on how relevant the amusement park business is in France now"
  }
]'

Şemayı göster

{
  "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": null
    }
  ]
}

Başarılı işlem

LLM Responses Claude görevlerini ayarlama

Kimlik doğrulamaRequired

DataForSEO

LLM Responses Claude görevlerini ayarlama

Fiyatlandırma referansı