v0.2.0-beta

OpenAPI 3.1.0

Canlı Gemini LLM Responses

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/gemini/llm_responses/live

Canlı Gemini LLM Responses

Bir Gemini modeline user_prompt gönderir ve yanıtını eşzamanlı olarak döndürür. model_name get_dataforseo_ai_gemini_llm_responses_models içinden gelmelidir. Claude ve ChatGPT canlı uç noktalarından farklı olarak burada system_message kabul edilir. 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.0707.
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)[]
- 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 1024 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 gemini-1.5-pro belirtilirse model_name olarak otomatikman gemini-1.5-pro-002 ayarlanır;
  mevcut LLM modellerinin listesini ayrı bir istek göndererek şu adresten alabilirsiniz: https://api.dataforseo.com/v3/ai_optimization/gemini/llm_responses/models
- 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: 2
  varsayılan değer: 1.3
- 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.9
- 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 1024 olur
  Not 2: Gemini Pro modellerinde use_reasoning otomatik olarak true değerine ayarlanır
- 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

Yanıtlar

200
Tür: object | null · Response36Afe1097B20_AiOptimizationGeminiLlmResponsesLiveResponseInfo
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_AiOptimizationGeminiLlmResponsesLiveTaskInfo
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: array (object | null)[] | null

sonuç dizisi

datetime
Tü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

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

fan-out sorguları dizisi
daha kapsamlı bir yanıt sağlamak için ana sorgudan türetilen ilgili arama sorgularını içerir

input_tokens
Tür: integer | null

girişteki token sayısı
işlenen toplam token sayısı

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

yanıt öğeleri dizisi
yapılandırılmış AI yanıt verilerini içerir

type
Tür: string | null

öğe türü

model_name
Tür: string | null

kullanılan AI modelinin adı

money_spent
Tür: number | null

AI token maliyeti, USD
üçüncü taraf AI model sağlayıcısının fiyatlandırmasına göre aldığı ücret

output_tokens
Tür: integer | null

çıktıdaki token sayısı
AI yanıtında oluşturulan toplam token sayısı

reasoning_tokens
Tür: integer | null

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ı

web_search
Tür: boolean | null

web aramasının kullanılıp kullanılmadığını belirtir

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/gemini/llm_responses/live

curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/gemini/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,
    "model_name": "gemini-2.5-flash",
    "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": [
        {
          "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
          ]
        }
      ]
    }
  ]
}

Başarılı işlem

Canlı Gemini LLM Responses

Kimlik doğrulamaRequired

DataForSEO

Canlı Gemini LLM Responses

Fiyatlandırma referansı