DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
پاسخ‌های زنده ChatGPT LLM
یک user_prompt به مدل ChatGPT می‌فرستد و پاسخ آن را به‌صورت همگام برمی‌گرداند. model_name مدل را انتخاب می‌کند — get_dataforseo_ai_chat_gpt_llm_responses_models را ببینید، و نامی که فهرست نشده باشد مستقیماً رد می‌شود. max_output_tokens، temperature و top_p همان‌طور که در API خود ارائه‌دهنده رفتار می‌کنند عمل می‌کنند، و web_search یا force_web_search به آن اجازه مرور می‌دهد. 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 برمی‌گرداند. ⚠️ این یک فراخوانی عمومی LLM است که از یک ارائه‌دهنده داده عبور می‌کند، نه یک سنجش سئو. اگر می‌خواهید بدانید ChatGPT درباره یک برند به کاربران چه می‌گوید، post_dataforseo_ai_chat_gpt_llm_scraper_live به‌جای آن تجربه مصرف‌کننده را بازتولید می‌کند.
مرجع قیمت‌گذاری
- اندازه‌گیری: هزینه پاسخ گزارش‌شده.
- برآورد درخواست مرجع: 0.0695 دلار آمریکا.
- ضریب مشتری مرجع: 1.0. ضریب‌های مرجع را نباید دوباره روی مبالغ تسویه‌شده مشتری اعمال کرد.
فقط فراداده مرجع، نه نقل‌قول حساب، نه قیمت تضمین‌شده و نه سقف هزینه. اعتبار منابع، اعتبار Felo نیست. هزینه‌های نهایی تابع سوابق صورت‌حساب Felo است.
- نوع: array (object | null)[]
- forceنوع: boolean | null
_web _search اجبار عامل هوش مصنوعی به استفاده از جستجوی وب
فیلد اختیاری
برای فعال‌سازی این پارامتر،web_searchنیز باید فعال باشد;
وقتی فعال باشد، مدل هوش مصنوعی موظف است به اطلاعات روز وب دسترسی پیدا کند و به آن‌ها استناد کند;
مقدار پیش‌فرض:false;
توجه: حتی اگر پارامتر رویtrueتنظیم شود، تضمینی برای استناد به منابع وب در پاسخ وجود ندارد
توجه 2: در مدل‌های استدلالی پشتیبانی نمی‌شود - maxنوع: integer | null
_output _tokens حداکثر تعداد توکن‌ها در پاسخ هوش مصنوعی
فیلد اختیاری
حداقل مقدار برای مدل‌های استدلالی (مثلاً وقتیreasoningدر نقطه پایانی Models برابرtrueاست):1024;
حداقل مقدار برای مدل‌های غیراستدلالی:16;
حداکثر مقدار:4096;
مقدار پیش‌فرض:2048
توجه: اگرweb_searchرویtrueتنظیم شود یا مدل استدلالی در درخواست مشخص شود، تعداد توکن‌های خروجی ممکن است از محدودیتmax_output_tokensفراتر رود - messageنوع: array (object | null)[] | null
_chain تاریخچه گفتگو فیلد اختیاری آرایه‌ای از اشیاء پیام که نوبت‌های گفتگوی قبلی را نشان می‌دهند; هر شیء باید شامل این موارد باشد: رشته 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نوع: string
_name نام مدل هوش مصنوعی
فیلد الزامیmodel_nameاز نام واقعی مدل و نام نسخه تشکیل می‌شود;
اگر نام مدل پایه تعیین شود، آخرین نسخه آن به‌صورت پیش‌فرض تنظیم می‌شود;
مثلاً اگرgpt-4.1تعیین شود،gpt-4.1-2025-04-14به‌صورت خودکار به‌عنوانmodel_nameتنظیم می‌شود;
می‌توانید فهرست مدل‌های LLM موجود را با ارسال یک درخواست جداگانه بهhttps://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_responses/modelsدریافت کنید - systemنوع: string | null
_message دستورالعمل‌های رفتار هوش مصنوعی
فیلد اختیاری
نقش، لحن یا رفتار مشخص هوش مصنوعی را تعیین می‌کند
می‌توانید حداکثر 500 کاراکتر در فیلدsystem_messageتعیین کنید - tagنوع: string | null
شناسه وظیفه تعریف‌شده توسط کاربر
فیلد اختیاری
محدودیت کاراکتر 255 است
می‌توانید از این پارامتر برای شناسایی وظیفه و تطبیق آن با نتیجه استفاده کنید
مقدارtagمشخص‌شده را در شیءdataپاسخ پیدا می‌کنید - temperatureنوع: number | null
تصادفی‌بودن پاسخ هوش مصنوعی
فیلد اختیاری
مقادیر بالاتر خروجی را متنوع‌تر می‌کنند;
مقادیر پایین‌تر خروجی را متمرکزتر می‌کنند;
حداقل مقدار:0
حداکثر مقدار:2
مقدار پیش‌فرض:0.94
توجه: در مدل‌های استدلالی پشتیبانی نمی‌شود - topنوع: number | null
_p تنوع پاسخ هوش مصنوعی
فیلد اختیاری
با محدود کردن انتخاب توکن، تنوع پاسخ را کنترل می‌کند;
حداقل مقدار:0
حداکثر مقدار:1
مقدار پیش‌فرض:0.92توجه:
top_pرا نمی‌توان در همان درخواست همراه باtemperatureاستفاده کرد - userنوع: string
_prompt پرامپت مدل هوش مصنوعی
فیلد الزامی
پرسش یا وظیفه‌ای که می‌خواهید به مدل هوش مصنوعی بفرستید;
می‌توانید حداکثر 500 کاراکتر در فیلدuser_promptتعیین کنید - webنوع: boolean | null
_search - webنوع: string | null
_search _city نام شهر موقعیت
فیلد اختیاری
توجه: در مدل‌هایo3-mini،o1-proوo1پشتیبانی نمی‌شود - webنوع: string | null
_search _country _iso _code کد کشور ISO موقعیت
فیلد اختیاری
برای فعال‌سازی این پارامتر،web_searchنیز باید فعال باشد;
وقتی فعال باشد، مدل هوش مصنوعی از کشوری که تعیین می‌کنید در وب جست‌وجو می‌کند;
توجه: در مدل‌هایo3-mini،o1-proوo1پشتیبانی نمی‌شود
- نوع: object | null · Response36Afe1097B20_AiOptimizationChatGptLlmResponsesLiveResponseInfo200
- نوع: number | null قالب: doublecost
هزینه کل وظایف، دلار آمریکا
- نوع: integer | nullstatus
_code کد وضعیت عمومی فهرست کامل کدهای پاسخ را اینجا پیدا می‌کنید
- نوع: string | nullstatus
_message پیام اطلاعاتی عمومی فهرست کامل پیام‌های اطلاعاتی عمومی را اینجا پیدا می‌کنید
- نوع: array (object | null)[] | nulltasks
آرایه‌ای از وظایف
- نوع: object | null · Response36Afe1097B20_AiOptimizationChatGptLlmResponsesLiveTaskInfo
- costنوع: number | null قالب: double
هزینه کل وظایف، دلار آمریکا
- 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 آرایه‌ای از پرس‌وجوهای انشعابی
حاوی پرس‌وجوهای جستجوی مرتبط مشتق‌شده از پرس‌وجوی اصلی برای ارائه پاسخ جامع‌تر است - inputنوع: integer | null
_tokens تعداد توکن‌ها در ورودی
مجموع توکن‌های پردازش‌شده - itemsنوع: array (object | null)[] | null
آرایه‌ای از آیتم‌های پاسخ
حاوی داده‌های ساختاریافته پاسخ هوش مصنوعی است- typeنوع: string | null
نوع عنصر
- modelنوع: string | null
_name نام مدل هوش مصنوعی استفاده‌شده
- moneyنوع: number | null
_spent - outputنوع: integer | null
_tokens تعداد توکن‌ها در خروجی
مجموع توکن‌های تولیدشده در پاسخ هوش مصنوعی - reasoningنوع: integer | null
_tokens تعداد توکن‌های استدلال
مجموع توکن‌های استفاده‌شده برای تولید محتوای استدلال - webنوع: boolean | null
_search نشان می‌دهد آیا از جستجوی وب استفاده شده است
- resultنوع: integer | null قالب: int64
_count تعداد عناصر در آرایه result
- statusنوع: integer | null
_code کد وضعیت وظیفه توسط DataForSEO تولید می‌شود و می‌تواند در بازه زیر باشد: 10000-60000 فهرست کامل کدهای پاسخ را اینجا پیدا می‌کنید
- 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
یک کلید API معتبر Felo لازم است.
- 402
درخواست ادامه نمی‌یابد چون یک الزام صورت‌حساب برآورده نشده است.
- 403
حساب مجاز به انجام این عملیات نیست.
- 429
به سقف درخواست یا هزینه رسیده‌اید.
- 502
سرویس نتوانست درخواست را کامل کند.
- 503
سرویس API یا صورت‌حساب موقتاً در دسترس نیست.
- 504
سرویس هنگام پردازش درخواست به پایان مهلت رسید.
- default
پاسخ خطا؛ پاسخ‌های عبوری بالادست ممکن است از قالب‌های ارائه‌دهنده استفاده کنند
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/chat_gpt/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": "gpt-4.1-mini",
"web_search": true,
"web_search_country_iso_code": "FR",
"web_search_city": "Paris",
"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
]
}
]
}
]
}