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