DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
إعداد مهام LLM Responses من Claude
يضع طلب Claude في قائمة الانتظار بدلًا من الانتظار، ويعيد معرّف مهمة id. الاستجابة مغلّفة في غلاف DataForSEO: البيانات في tasks[0].result، والنتيجة في tasks[0].status_code — ولا يزال الطلب المرفوض يعيد HTTP 200. تحقّق أولًا من task_post_supported في get_dataforseo_ai_claude_llm_responses_models، ثم استرجع النتيجة عبر get_dataforseo_ai_claude_llm_responses_fetch.
مرجع التسعير
- القياس: تكلفة الاستجابة المُبلَّغ عنها.
- تقدير الطلب المرجعي: 0.701 دولار أمريكي.
- مضاعف العميل المرجعي: 1.0. لا تُطبّقه مرة أخرى على مبلغ عميل مسوّى.
بيانات وصفية مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.
- النوع: array (object | null)[]
- forceالنوع: boolean | null
_web _search إجبار وكيل الذكاء الاصطناعي على استخدام البحث على الويب
حقل اختياري
لتفعيل هذا المعامل، يجب تفعيلweb_searchأيضًا;
عند التفعيل، يُلزَم نموذج الذكاء الاصطناعي بالوصول إلى معلومات الويب الحالية والاستشهاد بها;
القيمة الافتراضية:false;
ملاحظة: حتى إذا ضُبط المعامل علىtrue، فلا ضمان للاستشهاد بمصادر الويب في الاستجابة - maxالنوع: integer | null
_output _tokens الحد الأقصى لعدد الرموز في استجابة الذكاء الاصطناعي
حقل اختياري
الحد الأدنى:1;
الحد الأقصى:4096;
القيمة الافتراضية:2048;
ملاحظة: إذا ضُبطweb_searchعلىtrueأو حُدد نموذج استدلالي في الطلب، فقد يتجاوز عدد رموز الإخراج الحد المحدد فيmax_output_tokens
ملاحظة 2: إذا ضُبطuse_reasoningعلىtrue، فالحد الأدنى لـmax_output_tokensهو1025 - 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يتكوّن من اسم النموذج الفعلي واسم الإصدار;
إذا حُدد اسم النموذج الأساسي، فسيُضبط أحدث إصدار له افتراضيًا;
مثلًا، إذا حُددclaude-opus-4-0، فسيُضبطclaude-opus-4-20250514تلقائيًا كـmodel_name;
يمكنك الحصول على قائمة نماذج LLM المتاحة عبر إرسال طلب منفصل إلىhttps://api.dataforseo.com/v3/ai_optimization/claude/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
الحد الأقصى:1
القيمة الافتراضية:0.7ملاحظة: لا يمكن استخدام
temperatureمعtop_pفي الطلب نفسه - topالنوع: number | null
_p تنوّع استجابة الذكاء الاصطناعي
حقل اختياري
يتحكم في تنوّع الاستجابة عبر تقييد اختيار الرموز;
الحد الأدنى:0
الحد الأقصى:1
القيمة الافتراضية:nullملاحظة: لا يمكن استخدام
top_pمعtemperatureفي الطلب نفسه - useالنوع: boolean | null
_reasoning تفعيل الاستدلال لنموذج الذكاء الاصطناعي
حقل اختياري
عند التفعيل، سيجري النموذج استدلالًا قبل إنشاء استجابة
راجع نقطة نهاية Models للاطلاع على قائمة النماذج التي تدعمreasoning
القيمة الافتراضية:false
ملاحظة: إذا ضُبط علىtrue، فالحد الأدنى لـmax_output_tokensهو1025
ملاحظة 2: إذا ضُبط علىtrue، وجب ضبطforce_web_searchعلىfalse
ملاحظة 3: إذا ضُبط علىtrue، فلا يمكن استخدامtemperatureوtop_p - userالنوع: string
_prompt موجّه نموذج الذكاء الاصطناعي
حقل مطلوب
السؤال أو المهمة التي تريد إرسالها إلى نموذج الذكاء الاصطناعي;
يمكنك تحديد حتى 500 حرف في حقلuser_prompt - 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_AiOptimizationClaudeLlmResponsesTaskPostResponseInfo200
- النوع: number | null التنسيق: doublecost
إجمالي تكلفة المهام، بالدولار الأمريكي
- النوع: integer | nullstatus
_code رمز الحالة العام يمكنك العثور على القائمة الكاملة لرموز الاستجابة هنا
- النوع: string | nullstatus
_message رسالة معلوماتية عامة يمكنك العثور على القائمة الكاملة للرسائل المعلوماتية العامة هنا
- النوع: array (object | null)[] | nulltasks
مصفوفة المهام
- النوع: object | null · Response36Afe1097B20_AiOptimizationClaudeLlmResponsesTaskPostTaskInfo
- 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/claude/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?"
}
],
"max_output_tokens": 1024,
"temperature": 0.3,
"web_search_country_iso_code": "FR",
"model_name": "claude-sonnet-4-0",
"web_search": true,
"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
}
]
}