v0.2.0-beta

OpenAPI 3.1.0

لائیو Claude LLM Responses

Felo API Support

MIT

سرور

https://openapi.felo.ai

کلائنٹ لائبریریاں

Shell Curl

DataForSEO

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

DataForSEO آپریشنز

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

لائیو Claude LLM Responses

user_prompt کو Claude ماڈل کو بھیجتا ہے اور اس کا جواب ہم وقت واپس کرتا ہے۔ model_name لازماً get_dataforseo_ai_claude_llm_responses_models سے ہونا چاہیے - نام claude-sonnet-5 جیسے ہوتے ہیں، اور بظاہر معقول اندازہ مسترد ہو جاتا ہے۔ model_name، input_tokens، output_tokens، reasoning_tokens، web_search، money_spent، datetime، items اور fan_out_queries واپس کرتا ہے۔ یہ دیکھنے کے لیے جواب پر money_spent پڑھیں کہ کسی پرامپٹ کی واقعی کتنی لاگت آئی۔ DataForSEO کے لفافے میں لپٹا: ڈیٹا tasks[0].result میں، نتیجہ tasks[0].status_code میں - مسترد شدہ درخواست بھی HTTP 200 واپس کرتی ہے۔

قیمت کا حوالہ

میٹرنگ: رپورٹ شدہ جواب کی لاگت۔
حوالہ جاتی درخواست کا تخمینہ: USD 0.0567۔
حوالہ جاتی صارف ملٹی پلائر: 1.0۔ تصفیہ شدہ صارف رقم پر اسے دوبارہ لاگو نہیں کریں۔

صرف حوالہ جاتی میٹا ڈیٹا، نہ کہ اکاؤنٹ کا کوٹ، ضمانت شدہ قیمت یا اخراجات کی حد۔ ریسورس کریڈٹس Felo کریڈٹس نہیں ہیں۔ حتمی چارجز Felo کے بلنگ ریکارڈز کے مطابق ہوں گے۔

باڈی

application/json

قسم: array (object | null)[]
- force_web_search
  قسم: boolean | null
  
  AI ایجنٹ کو ویب تلاش استعمال کرنے پر مجبور کریں
  اختیاری فیلڈ
  اس پیرامیٹر کو فعال کرنے کے لیے web_search بھی فعال ہونا چاہیے؛
  فعال ہونے پر AI ماڈل موجودہ ویب معلومات تک رسائی اور ان کا حوالہ دینے پر مجبور ہوتا ہے؛
  ڈیفالٹ قدر: false؛
  نوٹ: پیرامیٹر true پر سیٹ ہونے کے باوجود اس بات کی کوئی ضمانت نہیں کہ جواب میں ویب ماخذ کا حوالہ دیا جائے گا
- max_output_tokens
  قسم: integer | null
  
  AI جواب میں ٹوکنز کی زیادہ سے زیادہ تعداد
  اختیاری فیلڈ
  کم از کم قدر: 1؛
  زیادہ سے زیادہ قدر: 4096؛
  ڈیفالٹ قدر: 2048؛
  نوٹ: اگر web_search true پر سیٹ ہو یا درخواست میں reasoning ماڈل متعین ہو تو آؤٹ پٹ ٹوکن کی تعداد متعین کردہ max_output_tokens حد سے تجاوز کر سکتی ہے
  نوٹ #2: اگر use_reasoning true پر سیٹ ہو تو max_output_tokens کی کم از کم قدر 1025 ہے
- message_chain
  قسم: array (object | null)[] | null
  
  گفتگو کی تاریخ اختیاری فیلڈ پچھلی گفتگو کی باریوں کی نمائندگی کرنے والے پیغام آبجیکٹس کی صف؛ ہر آبجیکٹ میں شامل ہونا چاہیے: role اسٹرنگ جس میں user یا ai کردار ہو؛ message اسٹرنگ جس میں پیغام کا مواد ہو (زیادہ سے زیادہ 500 حروف)؛ آپ صف میں زیادہ سے زیادہ 10 پیغام آبجیکٹس متعین کر سکتے ہیں؛ نوٹ: Perplexity ماڈلز کے لیے پیغامات کا user اور AI کرداروں کے درمیان سختی سے باری باری آنا ضروری ہے (user → ai)؛ مثال: "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
  قسم: string | null
  
  پیغام کا متن
  
  role
  قسم: string | null
  
  اس صارف کا کردار جس سے پیغام آتا ہے
- model_name
  قسم: string
  
  AI ماڈل کا نام
  درکار فیلڈ
  model_nameاصل ماڈل نام اور ورژن نام پر مشتمل ہوتا ہے؛
  اگر بنیادی ماڈل نام متعین کیا جائے تو ڈیفالٹ طور پر اس کا تازہ ترین ورژن سیٹ ہو جائے گا؛
  مثال کے طور پر اگر claude-opus-4-0 متعین کیا جائے تو claude-opus-4-20250514 خود بخود model_name کے طور پر سیٹ ہو جائے گا؛
  آپ دستیاب LLM ماڈلز کی فہرست https://api.dataforseo.com/v3/ai_optimization/claude/llm_responses/models پر الگ درخواست بھیج کر حاصل کر سکتے ہیں
- system_message
  قسم: string | null
  
  AI رویے کے لیے ہدایات
  اختیاری فیلڈ
  AI کا کردار، لہجہ یا مخصوص رویہ متعین کرتا ہے؛
  آپ system_message فیلڈ میں زیادہ سے زیادہ 500 حروف متعین کر سکتے ہیں
- tag
  قسم: string | null
  
  صارف کے متعین کردہ ٹاسک کا شناخت کنندہ
  اختیاری فیلڈ
  حروف کی حد 255 ہے
  آپ اس پیرامیٹر سے ٹاسک کی شناخت کر سکتے ہیں اور اسے نتیجے سے ملا سکتے ہیں
  آپ جواب کے data آبجیکٹ میں متعین کردہ tag قدر دیکھیں گے
- temperature
  قسم: number | null
  
  AI جواب کی تصادفی پن
  اختیاری فیلڈ
  زیادہ قدریں آؤٹ پٹ کو زیادہ متنوع بناتی ہیں؛
  کم قدریں آؤٹ پٹ کو زیادہ مرکوز بناتی ہیں؛
  کم از کم قدر: 0
  زیادہ سے زیادہ قدر: 1
  ڈیفالٹ قدر: 0.7
  
  نوٹ: temperature کو ایک ہی درخواست میں top_p کے ساتھ استعمال نہیں کیا جا سکتا
- top_p
  قسم: number | null
  
  AI جواب کی تنوع
  اختیاری فیلڈ
  ٹوکن کے انتخاب کو محدود کر کے جواب کی تنوع کو کنٹرول کرتا ہے؛
  کم از کم قدر: 0
  زیادہ سے زیادہ قدر: 1
  ڈیفالٹ قدر: null
  
  نوٹ: top_p کو ایک ہی درخواست میں temperature کے ساتھ استعمال نہیں کیا جا سکتا
- use_reasoning
  قسم: boolean | null
  
  AI ماڈل کے لیے reasoning فعال کریں
  اختیاری فیلڈ
  فعال ہونے پر ماڈل جواب بنانے سے پہلے reasoning کرے گا
  reasoning معاون کرنے والے ماڈلز کی فہرست کے لیے Models endpoint دیکھیں
  ڈیفالٹ قدر: false
  نوٹ: اگر true پر سیٹ ہو تو max_output_tokens کی کم از کم قدر 1025 ہے
  نوٹ #2: اگر true پر سیٹ ہو تو force_web_search کو false پر سیٹ کرنا ہوگا
  نوٹ #3: اگر true پر سیٹ ہو تو temperature اور top_p استعمال نہیں کیے جا سکتے
- user_prompt
  قسم: string
  
  AI ماڈل کے لیے پرامپٹ
  درکار فیلڈ
  وہ سوال یا کام جو آپ AI ماڈل کو بھیجنا چاہتے ہیں؛
  آپ user_prompt فیلڈ میں زیادہ سے زیادہ 500 حروف متعین کر سکتے ہیں
- web_search
  قسم: boolean | null
  
  موجودہ معلومات کے لیے ویب تلاش فعال کریں
  اختیاری فیلڈ
  فعال ہونے پر AI ماڈل موجودہ ویب معلومات تک رسائی اور ان کا حوالہ دے سکتا ہے؛
  نوٹ: web_search معاون کرنے والے ماڈلز کی فہرست کے لیے Models endpoint دیکھیں؛
  ڈیفالٹ قدر: false؛
  اس پیرامیٹر کی لاگت Pricing صفحے پر شمار کی جا سکتی ہے
- web_search_city
  قسم: string | null
  
  ویب تلاش کے لیے استعمال ہونے والے مقام کے شہر کا نام
  اختیاری فیلڈ
- web_search_country_iso_code
  قسم: string | null
  
  ویب تلاش کے لیے استعمال ہونے والے مقام کا ISO ملکی کوڈ
  اختیاری فیلڈ
  ممکنہ اقدار: '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'

جوابات

200
قسم: object | null · Response36Afe1097B20_AiOptimizationClaudeLlmResponsesLiveResponseInfo
cost
قسم: number | null فارمیٹ: double

ٹاسکس کی کل لاگت، USD

status_code
قسم: integer | null

عمومی اسٹیٹس کوڈ رسپانس کوڈز کی مکمل فہرست یہاں مل سکتی ہے

status_message
قسم: string | null

عمومی معلوماتی پیغام عمومی معلوماتی پیغامات کی مکمل فہرست یہاں مل سکتی ہے

tasks
قسم: array (object | null)[] | null

ٹاسکس کی صف

قسم: object | null · Response36Afe1097B20_AiOptimizationClaudeLlmResponsesLiveTaskInfo
cost
قسم: number | null فارمیٹ: double

ٹاسکس کی کل لاگت، USD

data
قسم: object | null

وہی پیرامیٹرز رکھتا ہے جو آپ نے POST درخواست میں متعین کیے۔

propertyName
قسم: object | null
id
قسم: string | null

ٹاسک شناخت کنندہ ہمارے نظام میں UUID فارمیٹ کا منفرد ٹاسک شناخت کنندہ

path
قسم: array (string | null)[] | null

URL پاتھ

result
قسم: array (object | null)[] | null

نتائج کی صف

datetime
قسم: string | null

وہ تاریخ اور وقت جب نتیجہ موصول ہوا
UTC فارمیٹ میں: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:
2019-11-15 12:57:46 +00:00

fan_out_queries
قسم: array (string | null)[] | null

فین آؤٹ کوئریز کی صف
مرکزی کوئری سے اخذ کردہ متعلقہ تلاش کی کوئریز رکھتا ہے تاکہ زیادہ جامع جواب فراہم ہو

input_tokens
قسم: integer | null

ان پٹ میں ٹوکنز کی تعداد
کارروائی شدہ ٹوکنز کی کل تعداد

items
قسم: array (object | null)[] | null

جوابی آئٹمز کی صف
ساختیافتہ AI جواب کا ڈیٹا رکھتا ہے

type
قسم: string | null

عنصر کی قسم

model_name
قسم: string | null

استعمال شدہ AI ماڈل کا نام

money_spent
قسم: number | null

AI ٹوکنز کی لاگت، USD
وہ قیمت جو تھرڈ پارٹی AI ماڈل پرووائیڈر اپنی قیمت کے مطابق وصول کرتا ہے

output_tokens
قسم: integer | null

آؤٹ پٹ میں ٹوکنز کی تعداد
AI جواب میں تیار کردہ ٹوکنز کی کل تعداد

reasoning_tokens
قسم: integer | null

reasoning ٹوکنز کی تعداد
reasoning مواد تیار کرنے کے لیے استعمال شدہ ٹوکنز کی کل تعداد

web_search
قسم: boolean | null

ظاہر کرتا ہے کہ ویب تلاش استعمال ہوئی یا نہیں

result_count
قسم: integer | null فارمیٹ: int64

result صف میں عناصر کی تعداد

status_code
قسم: integer | null

ٹاسک کا اسٹیٹس کوڈ DataForSEO کی جانب سے تیار کردہ، درج ذیل حد میں ہو سکتا ہے: 10000-60000 رسپانس کوڈز کی مکمل فہرست یہاں مل سکتی ہے

status_message
قسم: string | null

ٹاسک کا معلوماتی پیغام عمومی معلوماتی پیغامات کی مکمل فہرست یہاں مل سکتی ہے

time
قسم: string | null

عمل درآمد کا وقت، سیکنڈز

tasks_count
قسم: integer | null فارمیٹ: int64

tasks صف میں ٹاسکس کی تعداد

tasks_error
قسم: integer | null فارمیٹ: int64

خرابی کے ساتھ واپس ہونے والے tasks صف میں ٹاسکس کی تعداد

time
قسم: string | null

کل عمل درآمد کا وقت، سیکنڈ

version
قسم: string | null

API کا موجودہ ورژن
application/json
400

درخواست پر کارروائی نہیں ہو سکی۔ درخواست کے پیرامیٹرز چیک کریں۔
401

درست Felo API کلید درکار ہے۔
402

درخواست آگے نہیں بڑھ سکتی کیونکہ بلنگ کی شرط پوری نہیں ہوئی۔
403

اکاؤنٹ کو یہ آپریشن کرنے کی اجازت نہیں۔
429

درخواست یا اخراجات کی حد پوری ہو گئی ہے۔
502

سروس درخواست مکمل نہیں کر سکی۔
503

API یا بلنگ سروس عارضی طور پر دستیاب نہیں۔
504

درخواست پر کارروائی کے دوران سروس کا وقت ختم ہو گیا۔
default

خرابی کا جواب؛ اپ اسٹریم پاس تھرو جوابات پرووائیڈر کی شکلیں استعمال کر سکتے ہیں

application/json

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

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

کامیاب آپریشن

لائیو Claude LLM Responses

توثیقRequired

DataForSEO

لائیو Claude LLM Responses

قیمت کا حوالہ