DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
লাইভ Perplexity LLM Responses
একটি Perplexity মডেলে user_prompt পাঠায় এবং সিঙ্ক্রোনাসভাবে তার উত্তর ফেরত দেয়। model_name অবশ্যই get_dataforseo_ai_perplexity_llm_responses_models থেকে আসতে হবে — sonar, sonar-pro ও sonar-reasoning-pro। web_search_country_iso_code সার্চের পরিধি ঠিক করে, যা অন্য তিনটি ভেন্ডর দেয় না। model_name, input_tokens, output_tokens, reasoning_tokens, web_search, money_spent, datetime, items ও fan_out_queries ফেরত দেয়। একটি প্রম্পটে আসলে কত খরচ হয়েছে দেখতে রেসপন্সের money_spent পড়ুন। DataForSEO-এর envelope-এ মোড়ানো: ডেটা tasks[0].result-এ, ফলাফল tasks[0].status_code-এ — প্রত্যাখ্যাত রিকোয়েস্টও HTTP 200-ই ফেরত দেয়।
মূল্য রেফারেন্স
- মিটারিং: রিপোর্ট করা response খরচ।
- রেফারেন্স request অনুমান: USD 0.0163
- রেফারেন্স গ্রাহক গুণক: 1.0। নিষ্পত্তিকৃত গ্রাহক অঙ্কের উপর এটি পুনরায় প্রয়োগ করবেন না।
কেবল রেফারেন্স মেটাডেটা, অ্যাকাউন্টের কোটেশন, নিশ্চিত মূল্য বা ব্যয়সীমা নয়। রিসোর্স ক্রেডিট Felo ক্রেডিট নয়। চূড়ান্ত চার্জ Felo-এর বিলিং রেকর্ড অনুযায়ী হয়।
- টাইপ: array (object | null)[]
- maxটাইপ: integer | null
_output _tokens AI রেসপন্সে সর্বোচ্চ টোকেন সংখ্যা
ঐচ্ছিক ফিল্ড
সর্বনিম্ন মান:1
সর্বোচ্চ মান:4096;
ডিফল্ট মান:2048;
নোট: রিকোয়েস্টে reasoning মডেল উল্লেখ থাকলে আউটপুট টোকেন সংখ্যা উল্লেখিতmax_output_tokensসীমা ছাড়িয়ে যেতে পারে - 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-এ প্রকৃত মডেল নাম ও ভার্সন নাম থাকে;
শুধু বেস মডেল নাম উল্লেখ করলে ডিফল্টভাবে তার সর্বশেষ ভার্সন সেট হবে;
নিচের এন্ডপয়েন্টে আলাদা রিকোয়েস্ট পাঠিয়ে উপলব্ধ LLM মডেলের তালিকা পেতে পারেন:https://api.dataforseo.com/v3/ai_optimization/perplexity/llm_responses/models - systemটাইপ: string | null
_message AI আচরণের জন্য নির্দেশনা
ঐচ্ছিক ফিল্ড
AI-এর ভূমিকা, টোন বা নির্দিষ্ট আচরণ নির্ধারণ করে
আপনিsystem_messageফিল্ডে সর্বোচ্চ 500 অক্ষর নির্দিষ্ট করতে পারেন - tagটাইপ: string | null
ব্যবহারকারী-নির্ধারিত টাস্ক আইডেন্টিফায়ার
ঐচ্ছিক ফিল্ড
অক্ষরসীমা 255
এই প্যারামিটার দিয়ে টাস্ক শনাক্ত করে ফলাফলের সঙ্গে মিলিয়ে নিতে পারেন
নির্দিষ্টtagমান response-এরdataঅবজেক্টে পাবেন - temperatureটাইপ: number | null
AI রেসপন্সের র্যান্ডমনেস
ঐচ্ছিক ফিল্ড
বেশি মান আউটপুটকে আরও বৈচিত্র্যময় করে
কম মান আউটপুটকে আরও কেন্দ্রীভূত করে
সর্বনিম্ন মান:0
সর্বোচ্চ মান:1.9
ডিফল্ট মান:0.77 - topটাইপ: number | null
_p AI response-এর বৈচিত্র্য
ঐচ্ছিক ফিল্ড
টোকেন নির্বাচন সীমিত করে response-এর বৈচিত্র্য নিয়ন্ত্রণ করে
সর্বনিম্ন মান:0
সর্বোচ্চ মান:1
ডিফল্ট মান:0.9 - userটাইপ: string
_prompt AI মডেলের জন্য প্রম্পট
আবশ্যক ফিল্ড
যে প্রশ্ন বা কাজ আপনি AI মডেলে পাঠাতে চান;
আপনিuser_promptফিল্ডে সর্বোচ্চ 500 অক্ষর নির্দিষ্ট করতে পারেন - webটাইপ: string | null
_search _country _iso _code ওয়েব সার্চ লোকালাইজেশনের জন্য দেশের কোড
ঐচ্ছিক ফিল্ড
লোকালাইজড ওয়েব সার্চ ফলাফল পেতে দেশের ISO কোড উল্লেখ করুন
নোট: শুধু Perplexity Sonar মডেলের জন্য উপলব্ধ
উদাহরণ:US
- টাইপ: object | null · Response36Afe1097B20_AiOptimizationPerplexityLlmResponsesLiveResponseInfo200
- টাইপ: number | null ফরম্যাট: doublecost
টাস্কের মোট খরচ, USD
- টাইপ: integer | nullstatus
_code সাধারণ স্ট্যাটাস কোড সম্পূর্ণ response কোড তালিকা এখানে দেখতে পাবেন
- টাইপ: string | nullstatus
_message সাধারণ তথ্যমূলক বার্তা সাধারণ তথ্যমূলক বার্তার সম্পূর্ণ তালিকা এখানে দেখতে পাবেন
- টাইপ: array (object | null)[] | nulltasks
টাস্কের অ্যারে
- টাইপ: object | null · Response36Afe1097B20_AiOptimizationPerplexityLlmResponsesLiveTaskInfo
- 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টাইপ: object | null
_out _queries fan-out কোয়েরির অ্যারে
আরও পূর্ণাঙ্গ উত্তর দিতে মূল কোয়েরি থেকে উদ্ভূত সম্পর্কিত সার্চ কোয়েরি রয়েছে - inputটাইপ: integer | null
_tokens ইনপুটে টোকেনের সংখ্যা
প্রসেস করা টোকেনের মোট সংখ্যা - itemsটাইপ: array (object | null)[] | null
রেসপন্স আইটেমের অ্যারে
কাঠামোবদ্ধ AI রেসপন্স ডেটা রয়েছে- টাইপ: object | null · Response36Afe1097B20_MessageAiOptimizationLlmResponseElementItem
- টাইপ: object · Response36Afe1097B20_MessageAiOptimizationLlmResponseElementItem
- typeডিসক্রিমিনেটরটাইপ: string | null
এলিমেন্টের ধরন
- sectionsটাইপ: array (object | null)[] | null
রিজনিং চেইন অংশ
LLM দ্বারা তৈরি রিজনিং চেইন অংশসহ অবজেক্টের অ্যারে- annotationsটাইপ: array (object | null)[] | null
রেসপন্স তৈরি করতে ব্যবহৃত রেফারেন্সের অ্যারে
web_searchপ্যারামিটারtrue-তে সেট না থাকলেnull-এর সমান
নোট:web_searchtrueথাকলেওannotationsখালি ফেরত দিতে পারে, কারণ AI ওয়েব তথ্য পুনরুদ্ধার করার চেষ্টা করে কিন্তু প্রাসঙ্গিক ফলাফল না-ও পেতে পারে- directটাইপ: string | null
_url উদ্ধৃত উৎসের সরাসরি URL
urlফিল্ডে Vertex AI রিডাইরেক্ট যে মূল উৎস URL-এ নিয়ে যায় তা রয়েছে - endটাইপ: integer | null
_index অ্যানোটেশন ইনডেক্সিংয়ের শেষ
- startটাইপ: integer | null
_index অ্যানোটেশন ইনডেক্সিংয়ের শুরু
- textটাইপ: string | null
রিজনিং চেইন অংশের টেক্সট
মডেলের চিন্তা প্রক্রিয়ার সারাংশ প্রদানকারী রিজনিং চেইন অংশের টেক্সট - titleটাইপ: string | null
উদ্ধৃত উৎসের ডোমেইন নাম বা শিরোনাম
- urlটাইপ: string | null
উদ্ধৃত উৎসের রিডাইরেক্ট URL
মূল উৎসে নিয়ে যাওয়া একটি Vertex AI রিডাইরেক্ট রয়েছে
- textটাইপ: string | null
রিজনিং চেইন অংশের টেক্সট
মডেলের চিন্তা প্রক্রিয়ার সারাংশ প্রদানকারী রিজনিং চেইন অংশের টেক্সট - typeটাইপ: string | null
এলিমেন্টের ধরন
- modelটাইপ: string | null
_name ব্যবহৃত AI মডেলের নাম
- moneyটাইপ: number | null
_spent - outputটাইপ: integer | null
_tokens আউটপুটে টোকেনের সংখ্যা
AI রেসপন্সে তৈরি করা টোকেনের মোট সংখ্যা - reasoningটাইপ: integer | null
_tokens Integer numbers.
- webটাইপ: boolean | null
_search ওয়েব সার্চ ব্যবহার হয়েছে কি না তা নির্দেশ করে
নোট: Perplexity Sonar মডেলে ওয়েব সার্চ ডিফল্টভাবে সক্রিয়
- 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/perplexity/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,
"web_search_country_iso_code": "FR",
"model_name": "sonar",
"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": "[Max Depth Exceeded]",
"sections": "[Max Depth Exceeded]"
}
],
"fan_out_queries": null
}
]
}
]
}