DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
استجابات Claude LLM المباشرة
يرسل user_prompt إلى نموذج Claude ويعيد ردّه بشكل متزامن. يجب أن يأتي model_name من get_dataforseo_ai_claude_llm_responses_models — تبدو الأسماء مثل claude-sonnet-5، ويُرفض التخمين المعقول. يعيد 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 مع ذلك.
مرجع التسعير
- القياس: تكلفة الاستجابة المُبلَّغ عنها.
- تقدير الطلب المرجعي: 0.0567 دولار أمريكي.
- مضاعف العميل المرجعي: 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 - 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_AiOptimizationClaudeLlmResponsesLiveResponseInfo200
- النوع: number | null التنسيق: doublecost
إجمالي تكلفة المهام، بالدولار الأمريكي
- النوع: integer | nullstatus
_code رمز الحالة العام يمكنك العثور على القائمة الكاملة لرموز الاستجابة هنا
- النوع: string | nullstatus
_message رسالة معلوماتية عامة يمكنك العثور على القائمة الكاملة للرسائل المعلوماتية العامة هنا
- النوع: array (object | null)[] | nulltasks
مصفوفة المهام
- النوع: object | null · Response36Afe1097B20_AiOptimizationClaudeLlmResponsesLiveTaskInfo
- 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/claude/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,
"model_name": "claude-opus-4-0",
"temperature": 0.3,
"web_search": true,
"web_search_country_iso_code": "FR",
"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
]
}
]
}
]
}