Felo API PlatformFelo API Platform
تمام DataForSEO endpoints
v0.2.0-beta
OpenAPI 3.1.0

LLM Responses Claude ٹاسکس سیٹ کریں

Felo API Support
MIT
سرور:https://openapi.felo.ai
کلائنٹ لائبریریاں
Shell Curl

DataForSEO

​

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

DataForSEO آپریشنز

LLM Responses Claude ٹاسکس سیٹ کریں

​

جواب کا انتظار کرنے کے بجائے Claude پرامپٹ کو قطار میں ڈالتا ہے اور ٹاسک id واپس کرتا ہے۔ DataForSEO کے لفافے میں لپٹا: ڈیٹا tasks[0].result میں، نتیجہ tasks[0].status_code میں - مسترد شدہ درخواست بھی HTTP 200 واپس کرتی ہے۔ پہلے get_dataforseo_ai_claude_llm_responses_models میں task_post_supported دیکھیں، اور get_dataforseo_ai_claude_llm_responses_fetch سے حاصل کریں۔

قیمت کا حوالہ

  • میٹرنگ: رپورٹ شدہ جواب کی لاگت۔
  • حوالہ جاتی درخواست کا تخمینہ: USD 0.701۔
  • حوالہ جاتی صارف ملٹی پلائر: 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 پر الگ درخواست بھیج کر حاصل کر سکتے ہیں

    • pingback_url
      قسم: string | null

      مکمل شدہ ٹاسک کا نوٹیفکیشن URL
      اختیاری فیلڈ
      ٹاسک مکمل ہونے پر ہم آپ کو آپ کے متعین کردہ URL پر GET درخواست بھیج کر مطلع کریں گے
      آپ ‘$id’ اسٹرنگ کو $id متغیر کے طور پر اور ‘$tag’ کو urlencoded $tag متغیر کے طور پر استعمال کر سکتے ہیں۔ ہم درخواست بھیجنے سے پہلے ضروری اقدار سیٹ کر دیں گے
      مثال:
      http://your-server.com/pingscript?id=$id
      http://your-server.com/pingscript?id=$id&tag=$tag
      نوٹ: pingback_url میں خصوصی حرف urlencoded ہو جائے گا؛
      یعنی، # حرف %23 میں انکوڈ ہو جائے گا

      ہمارے Help Center پر مزید جانیں

    • postback_url
      قسم: string | null

      ٹاسک کے نتائج بھیجنے کے لیے URL
      اختیاری فیلڈ
      ٹاسک مکمل ہونے کے بعد ہم اس کے نتائج کو gzip فارمیٹ میں کمپریس کر کے آپ کے متعین کردہ postback_url پر POST درخواست کے ذریعے بھیجیں گے
      آپ ‘$id’ اسٹرنگ کو $id متغیر کے طور پر اور ‘$tag’ کو urlencoded $tag متغیر کے طور پر استعمال کر سکتے ہیں۔ ہم درخواست بھیجنے سے پہلے ضروری اقدار سیٹ کر دیں گے۔
      مثال:
      http://your-server.com/postbackscript?id=$id
      http://your-server.com/postbackscript?id=$id&tag=$tag
      نوٹ: postback_url میں خصوصی حرف urlencoded ہو جائے گا؛
      یعنی، # حرف %23 میں انکوڈ ہو جائے گا

      ہمارے Help Center پر مزید جانیں

    • 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_AiOptimizationClaudeLlmResponsesTaskPostResponseInfo
    • cost
      قسم: number | null فارمیٹ: double

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

    • status_code
      قسم: integer | null

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

    • status_message
      قسم: string | null

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

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

      ٹاسکس کی صف

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

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

        • data
          قسم: object | null

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

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

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

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

          URL پاتھ

        • result
          قسم: object | null

          نتائج کی صف
          اس صورت میں قدر 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
Request Example for 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"
  }
]'

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

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

Setting LLM Responses Claude Tasks