DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
تنظیم وظایف ‘LLM Responses ChatGPT’
یک پرامپت ChatGPT را به‌جای انتظار برای پاسخ در صف قرار می‌دهد و id وظیفه را برمی‌گرداند. system_message و message_chain را نسبت به نقطه پایانی زنده اضافه می‌کند، بنابراین یک گفتگوی چندنوبتی را می‌توان در یک وظیفه فرستاد. در پاکت DataForSEO پیچیده شده است: داده در tasks[0].result و نتیجه در tasks[0].status_code — درخواست ردشده همچنان HTTP 200 برمی‌گرداند. ⚠️ همه مدل‌ها از صف پشتیبانی نمی‌کنند — task_post_supported را در get_dataforseo_ai_chat_gpt_llm_responses_models بررسی کنید. با get_dataforseo_ai_chat_gpt_llm_responses_fetch بازیابی کنید.
مرجع قیمت‌گذاری
- اندازه‌گیری: هزینه پاسخ گزارش‌شده.
- برآورد درخواست مرجع: 0.701 دلار آمریکا.
- ضریب مشتری مرجع: 1.0. ضریب‌های مرجع را نباید دوباره روی مبالغ تسویه‌شده مشتری اعمال کرد.
فقط فراداده مرجع، نه نقل‌قول حساب، نه قیمت تضمین‌شده و نه سقف هزینه. اعتبار منابع، اعتبار Felo نیست. هزینه‌های نهایی تابع سوابق صورت‌حساب Felo است.
- نوع: array (object | null)[]
- forceنوع: boolean | null
_web _search اجبار عامل هوش مصنوعی به استفاده از جستجوی وب
فیلد اختیاری
برای فعال‌سازی این پارامتر،web_searchنیز باید فعال باشد;
وقتی فعال باشد، مدل هوش مصنوعی موظف است به اطلاعات روز وب دسترسی پیدا کند و به آن‌ها استناد کند;
مقدار پیش‌فرض:false;
توجه: حتی اگر پارامتر رویtrueتنظیم شود، تضمینی برای استناد به منابع وب در پاسخ وجود ندارد
توجه 2: در مدل‌های استدلالی پشتیبانی نمی‌شود - maxنوع: integer | null
_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دریافت کنید - pingbackنوع: string | null
_url نشانی URL اطلاع‌رسانی تکمیل وظیفه
فیلد اختیاری
وقتی وظیفه تکمیل شد، با ارسال درخواست GET به نشانی URL که تعیین کرده‌اید به شما اطلاع می‌دهیم
می‌توانید رشته ‘$id’ را به‌عنوان متغیر$idو ‘$tag’ را به‌عنوان متغیر$tagکدگذاری‌شده با urlencoded استفاده کنید. مقادیر لازم را پیش از ارسال درخواست تنظیم می‌کنیم
مثال:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
توجه: کاراکترهای خاص درpingback_urlبا urlencoded کدگذاری می‌شوند;
از جمله کاراکتر#به%23کدگذاری می‌شود - postbackنوع: string | null
_url نشانی URL برای ارسال نتایج وظیفه
فیلد اختیاری
وقتی وظیفه تکمیل شد، درخواست POST با نتایج فشرده‌شده در قالبgzipرا بهpostback_urlکه تعیین کرده‌اید می‌فرستیم
می‌توانید رشته ‘$id’ را به‌عنوان متغیر$idو ‘$tag’ را به‌عنوان متغیر$tagکدگذاری‌شده با urlencoded استفاده کنید. مقادیر لازم را پیش از ارسال درخواست تنظیم می‌کنیم.
مثال:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
توجه: کاراکترهای خاص درpostback_urlبا urlencoded کدگذاری می‌شوند;
از جمله کاراکتر#به%23کدگذاری می‌شود - 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_AiOptimizationChatGptLlmResponsesTaskPostResponseInfo200
- نوع: number | null قالب: doublecost
هزینه کل وظایف، دلار آمریکا
- نوع: integer | nullstatus
_code کد وضعیت عمومی فهرست کامل کدهای پاسخ را اینجا پیدا می‌کنید
- نوع: string | nullstatus
_message پیام اطلاعاتی عمومی فهرست کامل پیام‌های اطلاعاتی عمومی را اینجا پیدا می‌کنید
- نوع: array (object | null)[] | nulltasks
آرایه‌ای از وظایف
- نوع: object | null · Response36Afe1097B20_AiOptimizationChatGptLlmResponsesTaskPostTaskInfo
- costنوع: number | null قالب: double
هزینه کل وظایف، دلار آمریکا
- dataنوع: object | null
همان پارامترهایی را دارد که در درخواست POST تعیین کرده‌اید
- propertyنوع: object | null
Name
- idنوع: string | null
شناسه وظیفه شناسه یکتای وظیفه در سیستم ما در قالب UUID
- pathنوع: array (string | null)[] | null
مسیر URL
- resultنوع: object | null
آرایه‌ای از نتایج
در این حالت، مقدارnullخواهد بود - 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/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?"
}
],
"model_name": "gpt-4.1-mini",
"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
}
]
}