DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
লাইভ Claude LLM Responses
Claude মডেলে user_prompt পাঠায় এবং সিঙ্ক্রোনাসভাবে এর উত্তর ফেরত দেয়। 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-এর বিলিং রেকর্ড অনুযায়ী হয়।
- টাইপ: array (object | null)[]
- forceটাইপ: boolean | null
_web _search AI এজেন্টকে ওয়েব সার্চ ব্যবহারে বাধ্য করুন
ঐচ্ছিক ফিল্ড
এই প্যারামিটার সক্রিয় করতেweb_search-ও সক্রিয় থাকতে হবে;
সক্রিয় থাকলে AI মডেল বর্তমান ওয়েব তথ্য অ্যাক্সেস ও উদ্ধৃত করতে বাধ্য হয়;
ডিফল্ট মান:false;
নোট: প্যারামিটারtrueসেট করলেও response-এ ওয়েব সোর্স উদ্ধৃত হওয়ার নিশ্চয়তা নেই - maxটাইপ: integer | null
_output _tokens AI response-এ সর্বোচ্চ টোকেন সংখ্যা
ঐচ্ছিক ফিল্ড
সর্বনিম্ন মান:1;
সর্বোচ্চ মান:4096;
ডিফল্ট মান:2048;
নোট:web_searchtrueসেট থাকলে বা রিকোয়েস্টে রিজনিং মডেল নির্দিষ্ট থাকলে আউটপুট টোকেন সংখ্যা নির্দিষ্টmax_output_tokensসীমা ছাড়াতে পারে
নোট 2:use_reasoningtrueসেট থাকলেmax_output_tokens-এর সর্বনিম্ন মান1025 - messageটাইপ: array (object | null)[] | null
_chain কথোপকথনের ইতিহাস ঐচ্ছিক ফিল্ড আগের কথোপকথন টার্নের message অবজেক্টের অ্যারে; প্রতিটি অবজেক্টে থাকতে হবে: role — user বা ai ভূমিকাসহ স্ট্রিং; message — message কনটেন্টসহ স্ট্রিং (সর্বোচ্চ 500 অক্ষর); অ্যারেতে সর্বোচ্চ 10টি message অবজেক্ট নির্দিষ্ট করা যায়; নোট: Perplexity মডেলের জন্য message-গুলো 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
message টেক্সট
- roleটাইপ: string | null
যে ব্যবহারকারী থেকে message আসে তার ভূমিকা
- modelটাইপ: string
_name AI মডেলের নাম
আবশ্যক ফিল্ডmodel_name-এ প্রকৃত মডেল নাম ও সংস্করণ নাম থাকে;
শুধু বেস মডেল নাম দিলে ডিফল্টভাবে তার সর্বশেষ সংস্করণ সেট হবে;
যেমন,claude-opus-4-0নির্দিষ্ট করলেclaude-opus-4-20250514স্বয়ংক্রিয়ভাবেmodel_nameহিসেবে সেট হবে;
আপনিhttps://api.dataforseo.com/v3/ai_optimization/claude/llm_responses/models-এ পৃথক রিকোয়েস্ট পাঠিয়ে উপলব্ধ LLM মডেলের তালিকা পেতে পারেন - systemটাইপ: string | null
_message AI আচরণের জন্য নির্দেশনা
ঐচ্ছিক ফিল্ড
AI-এর ভূমিকা, টোন বা নির্দিষ্ট আচরণ নির্ধারণ করে;
আপনিsystem_messageফিল্ডে সর্বোচ্চ 500 অক্ষর নির্দিষ্ট করতে পারেন - tagটাইপ: string | null
ব্যবহারকারী-নির্ধারিত টাস্ক আইডেন্টিফায়ার
ঐচ্ছিক ফিল্ড
অক্ষরসীমা 255
এই প্যারামিটার দিয়ে টাস্ক শনাক্ত করে ফলাফলের সঙ্গে মিলিয়ে নিতে পারেন
নির্দিষ্টtagমান response-এরdataঅবজেক্টে পাবেন - temperatureটাইপ: number | null
AI response-এর র্যান্ডমনেস
ঐচ্ছিক ফিল্ড
বেশি মান আউটপুট আরও বৈচিত্র্যময় করে;
কম মান আউটপুট আরও কেন্দ্রীভূত করে;
সর্বনিম্ন মান:0
সর্বোচ্চ মান:1
ডিফল্ট মান:0.7নোট: একই রিকোয়েস্টে
temperatureওtop_pএকসঙ্গে ব্যবহার করা যায় না - topটাইপ: number | null
_p AI response-এর বৈচিত্র্য
ঐচ্ছিক ফিল্ড
টোকেন নির্বাচন সীমিত করে response-এর বৈচিত্র্য নিয়ন্ত্রণ করে;
সর্বনিম্ন মান:0
সর্বোচ্চ মান:1
ডিফল্ট মান:nullনোট: একই রিকোয়েস্টে
top_pওtemperatureএকসঙ্গে ব্যবহার করা যায় না - useটাইপ: boolean | null
_reasoning AI মডেলের জন্য রিজনিং সক্রিয় করুন
ঐচ্ছিক ফিল্ড
সক্রিয় থাকলে মডেল response তৈরি করার আগে রিজনিং করবেreasoningসমর্থিত মডেলের তালিকার জন্য Models endpoint দেখুন
ডিফল্ট মান:false
নোট:trueসেট থাকলেmax_output_tokens-এর সর্বনিম্ন মান1025
নোট 2:trueসেট থাকলেforce_web_searchঅবশ্যইfalseসেট করতে হবে
নোট 3:trueসেট থাকলেtemperatureওtop_pব্যবহার করা যায় না - userটাইপ: string
_prompt AI মডেলের জন্য প্রম্পট
আবশ্যক ফিল্ড
যে প্রশ্ন বা কাজ আপনি AI মডেলে পাঠাতে চান;
আপনিuser_promptফিল্ডে সর্বোচ্চ 500 অক্ষর নির্দিষ্ট করতে পারেন - webটাইপ: boolean | null
_search - webটাইপ: string | null
_search _city ওয়েব সার্চে ব্যবহৃত অবস্থানের শহরের নাম
ঐচ্ছিক ফিল্ড - webটাইপ: string | null
_search _country _iso _code ওয়েব সার্চে ব্যবহৃত অবস্থানের 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'
- টাইপ: object | null · Response36Afe1097B20_AiOptimizationClaudeLlmResponsesLiveResponseInfo200
- টাইপ: number | null ফরম্যাট: doublecost
টাস্কের মোট খরচ, USD
- টাইপ: integer | nullstatus
_code সাধারণ স্ট্যাটাস কোড সম্পূর্ণ response কোড তালিকা এখানে দেখতে পাবেন
- টাইপ: string | nullstatus
_message সাধারণ তথ্যমূলক বার্তা সাধারণ তথ্যমূলক বার্তার সম্পূর্ণ তালিকা এখানে দেখতে পাবেন
- টাইপ: array (object | null)[] | nulltasks
টাস্কের অ্যারে
- টাইপ: object | null · Response36Afe1097B20_AiOptimizationClaudeLlmResponsesLiveTaskInfo
- costটাইপ: number | null ফরম্যাট: double
টাস্কের মোট খরচ, USD
- dataটাইপ: object | null
এতে POST রিকোয়েস্টে আপনি যে প্যারামিটারগুলো নির্দিষ্ট করেছিলেন সেগুলোই থাকে
- propertyটাইপ: object | null
Name
- 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টাইপ: array (string | null)[] | null
_out _queries fan-out কোয়েরির অ্যারে
আরও পূর্ণাঙ্গ উত্তর দিতে মূল কোয়েরি থেকে উদ্ভূত সম্পর্কিত সার্চ কোয়েরি রয়েছে - inputটাইপ: integer | null
_tokens ইনপুটে টোকেনের সংখ্যা
প্রসেস করা টোকেনের মোট সংখ্যা - itemsটাইপ: array (object | null)[] | null
রেসপন্স আইটেমের অ্যারে
কাঠামোবদ্ধ AI রেসপন্স ডেটা রয়েছে- typeটাইপ: string | null
এলিমেন্টের ধরন
- modelটাইপ: string | null
_name ব্যবহৃত AI মডেলের নাম
- moneyটাইপ: number | null
_spent - outputটাইপ: integer | null
_tokens আউটপুটে টোকেনের সংখ্যা
AI রেসপন্সে তৈরি করা টোকেনের মোট সংখ্যা - reasoningটাইপ: integer | null
_tokens রিজনিং টোকেনের সংখ্যা
রিজনিং কনটেন্ট তৈরি করতে ব্যবহৃত টোকেনের মোট সংখ্যা - webটাইপ: boolean | null
_search ওয়েব সার্চ ব্যবহার হয়েছে কি না তা নির্দেশ করে
- resultটাইপ: integer | null ফরম্যাট: int64
_count result অ্যারেতে এলিমেন্টের সংখ্যা
- statusটাইপ: integer | null
_code টাস্কের স্ট্যাটাস কোড DataForSEO কর্তৃক তৈরি, যা নিম্নলিখিত পরিসরে হতে পারে: 10000-60000 সম্পূর্ণ response কোড তালিকা এখানে দেখতে পাবেন
- statusটাইপ: string | null
_message টাস্কের তথ্যমূলক বার্তা সাধারণ তথ্যমূলক বার্তার সম্পূর্ণ তালিকা এখানে দেখতে পাবেন
- timeটাইপ: string | null
সম্পাদনের সময়, সেকেন্ড
- টাইপ: integer | null ফরম্যাট: int64tasks
_count tasks অ্যারেতে টাস্কের সংখ্যা
- টাইপ: integer | null ফরম্যাট: int64tasks
_error ত্রুটিসহ ফেরত দেওয়া tasks অ্যারেতে টাস্কের সংখ্যা
- টাইপ: string | nulltime
মোট সম্পাদন সময়, সেকেন্ড
- টাইপ: string | nullversion
API-এর বর্তমান সংস্করণ
application/json - 400
রিকোয়েস্ট প্রক্রিয়া করা যায়নি। রিকোয়েস্ট প্যারামিটার যাচাই করুন।
- 401
একটি বৈধ Felo API key আবশ্যক।
- 402
বিলিং শর্ত পূরণ না হওয়ায় রিকোয়েস্ট এগোতে পারছে না।
- 403
অ্যাকাউন্টটিকে এই অপারেশন করার অনুমতি নেই।
- 429
রিকোয়েস্ট বা ব্যয়ের সীমায় পৌঁছে গেছে।
- 502
পরিষেবা রিকোয়েস্টটি সম্পন্ন করতে পারেনি।
- 503
API বা বিলিং পরিষেবা সাময়িকভাবে অনুপলভ্য।
- 504
রিকোয়েস্ট প্রক্রিয়াকরণের সময় পরিষেবার সময় শেষ হয়ে গেছে।
- default
ত্রুটি রেসপন্স; আপস্ট্রিম passthrough রেসপন্স প্রোভাইডারের ফর্ম্যাট ব্যবহার করতে পারে।
application/json
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
]
}
]
}
]
}