v0.2.0-beta

OpenAPI 3.1.0

„LLM Responses ChatGPT“ 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/chat_gpt/llm_responses/task_post

„LLM Responses ChatGPT“ Görevlerini Ayarlama

Yanıtı beklemek yerine bir ChatGPT istemini kuyruğa alır ve bir görev id değeri döndürür. Canlı uç noktaya göre system_message ve message_chain ekler, böylece çok turlu bir konuşma tek görevde gönderilebilir. 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. ⚠️ Her model kuyruklamayı desteklemez — get_dataforseo_ai_chat_gpt_llm_responses_models içindeki task_post_supported alanını kontrol edin. get_dataforseo_ai_chat_gpt_llm_responses_fetch ile getirin.

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

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
  Not 2: akıl yürütme modellerinde desteklenmez
- max_output_tokens
  Tür: integer | null
  
  AI yanıtındaki maksimum token sayısı
  isteğe bağlı alan
  akıl yürütme modelleri için minimum değer (ör. Models uç noktasında reasoning değeri true): 1024;
  akıl yürütme kullanmayan modeller için minimum değer: 16;
  maksimum değer: 4096;
  varsayılan değer: 2048
- 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 gpt-4.1 belirtilirse model_name olarak otomatikman gpt-4.1-2025-04-14 ayarlanır;
  mevcut LLM modellerinin listesini ayrı bir istek göndererek şu adresten alabilirsiniz: https://api.dataforseo.com/v3/ai_optimization/chat_gpt/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 dizisinde 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: 2
  varsayılan değer: 0.94
  Not: akıl yürütme modellerinde desteklenmez
- 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: 0.92
  
  Not: top_p aynı istekte temperature ile birlikte 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
  
  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;
  varsayılan değer: false;
  Not: web_search destekleyen modellerin listesi için Models uç noktasına bakın;
- web_search_city
  Tür: string | null
  
  konumun şehir adı
  isteğe bağlı alan
  Not: o3-mini, o1-pro, o1 modellerinde desteklenmez
- web_search_country_iso_code
  Tür: string | null
  
  konumun ISO ülke kodu
  isteğe bağlı alan
  bu parametreyi etkinleştirmek için web_search de etkin olmalıdır;
  etkinleştirildiğinde AI modeli web'de belirttiğiniz ülkeden arama yapar;
  Not: o3-mini, o1-pro, o1 modellerinde desteklenmez

Yanıtlar

200
Tür: object | null · Response36Afe1097B20_AiOptimizationChatGptLlmResponsesTaskPostResponseInfo
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_AiOptimizationChatGptLlmResponsesTaskPostTaskInfo
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/chat_gpt/llm_responses/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/chat_gpt/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?"
      }
    ],
    "model_name": "gpt-4.1-mini",
    "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 ChatGPT“ Görevlerini Ayarlama

Kimlik doğrulamaRequired

DataForSEO

„LLM Responses ChatGPT“ Görevlerini Ayarlama

Fiyatlandırma referansı