واجهة برمجة DeepSeek API الجديدة: البحث والملفات والصوت والأسعار لمواقع ووردبريس

This article is available in English — Read in English

أعلنت شركة DeepSeek يوم 13 نوفمبر 2026 إتاحة كامل تجربة تطبيق DeepSeek App مباشرة عبر DeepSeek API للمطورين والشركات. قبل هذا التحديث، كان أي فريق برمجي يريد بناء مساعد متكامل يضطر إلى ربط محرك بحث خارجي مع أداة سحب روابط ومحلل ملفات PDF وخدمة صوتية منفصلة حول نموذج المحادثة. الآن أصبح بإمكان المطور تفعيل البحث الحي وقراءة الروابط وفحص الملفات ومراجعة الأمان داخل طلب المحادثة نفسه، أو استدعاء نقاط نهاية مستقلة للبحث والجلب وOCR والصوت مباشرة من الخادم.

بالنسبة لأصحاب المواقع والمتاجر المبنية على ووردبريس وووكومرس في مصر والسعودية والإمارات وباقي دول الخليج، تكمن أهمية التحديث في نقطتين واضحتين. الأولى أن واجهتي تحويل الصوت إلى نص والنص إلى صوت تدعمان اللغة العربية تلقائيا بجانب الإنجليزية. والثانية أن جمع هذه الأدوات تحت مزود واحد يقلل تعقيد البنية البرمجية، مع ضرورة الانتباه إلى حدود الرفع والفوترة وضوابط الخصوصية قبل إطلاق أي أداة للزوار.

ما الذي تغير في إصدار DeepSeek API الجديد

ينقل تحديث 13 نوفمبر واجهة DeepSeek من مجرد نقطة نهاية لتوليد النصوص وفهم الصور إلى حزمة بناء تطبيقات متكاملة تعمل على نموذج deepseek-flash، وهو الاسم التشغيلي لنموذج DeepSeek-V4.1-Flash-1017 بنافذة سياق تصل إلى مليون توكن وحد أقصى للإخراج يبلغ 384 ألف توكن. وكما أوضحنا سابقا في مقال DeepSeek V4.1 Flash Harness، تتجه الشركة بقوة نحو دعم سير العمل الوكيل والأدوات المدمجة بدلا من الاكتفاء بالردود النصية المجردة.

بدلا من كتابة حلقات برمجية على خادمك لتنفيذ استعلامات البحث وإعادة إرسال الصفحات إلى النموذج، تتولى خوادم DeepSeek تنفيذ البحث وجلب الروابط تلقائيا بمجرد إعلان الأدوات المدمجة في الطلب. وكل ما يفعله تطبيقك هو تمرير الكتل العائدة في الجولات التالية من المحادثة دون تعديل. كما نشرت الشركة واجهة تجريبية مفتوحة المصدر على GitHub تسمح للمطورين باختبار استيراد سجل المحادثات ورسم مخططات Mermaid ورفع الملفات وتشغيل الصوت مباشرة من المتصفح باستخدام مفتاحهم الخاص.

وتعمل قدرات الدردشة الجديدة عبر ثلاثة بروتوكولات متوافقة على النطاق api.deepseek.com، وهي واجهة Messages المتوافقة مع Anthropic على المسار POST /anthropic/v1/messages، وواجهة Responses على المسار POST /responses، وواجهة Chat Completions على المسار POST /chat/completions. هذا التنوع يعني أن إضافات ووردبريس أو خدمات Node.js المبنية مسبقا على مكتبات OpenAI أو Anthropic يمكنها تبني أدوات DeepSeek بجهد برمجي محدود.

الأدوات المدمجة على الخادم لتدفقات المحادثة

تفصل DeepSeek بين الأدوات التي يديرها النموذج تلقائيا أثناء المحادثة وبين الواجهات المستقلة التي يستدعيها الكود الخاص بك مباشرة. فعند إضافة deepseek_web_search أو deepseek_read_url داخل مصفوفة الأدوات في طلب الدردشة، يقرر النموذج بنفسه متى يبحث على الإنترنت أو يقرأ رابطا أرسله المستخدم دون أن يشغل خادمك أي زاحف ويب أو خادم بروكسي.

البحث في الويب والبحث بالتفكير العميق وقراءة الروابط

يختلف سلوك البحث حسب تفعيل وضع التفكير من عدمه. عند تعطيل التفكير وإتاحة أداة deepseek_web_search، يجري النموذج بحثا في الويب أو الصور متى احتاج السؤال إلى معلومات محدثة ثم يقدم الإجابة مع الاستشهادات. أما عند تفعيل وضع التفكير، فيعمل ما تسميه الشركة البحث بالتفكير العميق، حيث ينفذ النموذج عدة خطوات استدلالية يبحث خلالها ويفتح الصفحات ويطالع فقراتها للتحقق من الحقائق قبل صياغة الرد النهائي.

تعمل قراءة الروابط عبر أداة منفصلة باسم deepseek_read_url، وفيها يرصد النموذج أي رابط في رسالة المستخدم ويجلب محتواه داخل السياق للإجابة منه. وتوضح وثائق الأدوات قيدا مهما، وهو أنه لا يمكن إجبار معامل tool_choice على استدعاء deepseek_web_search أو deepseek_read_url بالاسم، وإلا يرد الخادم بخطأ 400، بينما يؤدي ضبط tool_choice على none إلى إيقاف جميع الأدوات بما فيها قراءة الروابط.

رفع الملفات وتحليل التخطيط وفحص الأمان

تعتمد أسئلة المستندات على خطوتين تبدآن برفع الملف إلى واجهة الملفات POST /files ثم تمرير معرف الملف العائد file_id داخل طلب المحادثة. تقبل الواجهة الصور حتى 64 ميجابايت بصيغ JPEG وPNG وGIF وWebP، والنصوص والجداول XLSX وXLS والكتب الإلكترونية EPUB وMOBI حتى 32 ميجابايت تحت غرض user_data. أما ملفات PDF وWord وPowerPoint حتى 100 ميجابايت فتتطلب أحد غرضين: text_recognition أو rich_layout_recognition.

الاختيار بين الغرضين يؤثر مباشرة على دقة الإجابة وتكلفة التوكنات. في وضع text_recognition، تستخرج الواجهة النصوص فقط وتسقط الرسوم البيانية والصور والمخططات. أما في وضع rich_layout_recognition، فيقص المحلل الأشكال والمخططات تلقائيا ويدرجها في مواضعها الأصلية ليتمكن نموذج الرؤية من قراءتها، مع تنبيه رسمي بأن النظام لا يضمن التقاط كل شكل بنسبة كاملة وأن الأشكال المقصوصة تستهلك توكنات إدخال وتحتسب ضمن حد الصور في الطلب.

وللتطبيقات الموجهة للجمهور، أضافت DeepSeek معامل الأمان safety_check بمستويين هما low (الافتراضي) وhigh. تفعيل المستوى المرتفع يراجع المدخلات والمخرجات بما فيها نتائج الأدوات والصور، وإذا رصد مخاطر يرد برمز الخطأ 400 Content Exists Risk أو ينهي الاستجابة بعلامة رفض حسب البروتوكول المستخدم. وتؤكد الوثائق أن التطبيقات العامة ملزمة بتفعيل هذا الفحص، مع بقاء المطور مسؤولا عن مراجعة المحتوى وتسجيل النماذج والإفصاح عن المحتوى المولد بالذكاء الاصطناعي.

تكتمل منظومة الدردشة بميزتين عمليتين هما تمرير بيانات المستخدم لتعريف النموذج بالتاريخ الحالي وموقع المستخدم ولغته، وتوليد عنوان قصير للمحادثة تلقائيا بعد انتهاء الرد.

نقاط الأدوات المستقلة: البحث والجلب وOCR والصوت

في مهام الأتمتة الخلفية التي لا تريد فيها أن يتحكم نموذج الدردشة بتوقيت استدعاء الأداة، توفر الشركة خمس واجهات REST وWebSocket مستقلة تحت المسار https://api.deepseek.com/v1/tools/، وهي مناسبة لعمليات ووردبريس المجدولة مثل تصنيف المستندات وتوجيهها آليا أو تحديث بيانات المنتجات.

• واجهة البحث (POST /v1/tools/search): تستعلم من فهرس بحث DeepSeek الداخلي وتعيد من نتيجة واحدة إلى 50 نتيجة منظمة مع خيار إرجاع محتوى الصفحة بصيغة Markdown، وتدعم معاملات البحث مثل site: و-site: والعبارات المطابقة وlang:، لكن البحث عن الصور غير متاح بعد في هذه الواجهة المستقلة.
• واجهة جلب الصفحات (POST /v1/tools/fetch): تسحب محتوى رابط صفحة ويب واحدة وتعيده بصيغة Markdown نظيفة لبناء أنظمة الاسترجاع المعزز RAG.
• واجهة OCR (POST /v1/tools/ocr): تتعرف على النصوص صفحة بصفحة في ملفات PDF وWord وPowerPoint والصور حتى 100 ميجابايت و1,000 صفحة خلال مهلة كلية أقصاها 180 ثانية دون حفظ الملف في واجهة الملفات، وتعيد إحداثيات الصناديق المطبعة من 0 إلى 1000 لتحديد مواضع العناصر.
• تحويل الصوت إلى نص ASR (POST /v1/tools/asr): تفرغ ملفات الصوت بصيغة 16-bit PCM WAV أو Ogg Opus بحد أقصى 8 ميجابايت و120 ثانية عبر 21 لغة تكتشف تلقائيا بينها العربية ar والإنجليزية en، ولا تدعم البث الصوتي المستمر وتقرأ القناة اليسرى فقط في الملفات الثنائية بحد أقصى 50 طلبا متزامنا للحساب.
• تحويل النص إلى صوت TTS (POST /v1/tools/tts وWebSocket): تحول حتى 10,000 حرف مفوتر (بحد 64 كيلوبايت للطلب و30 دقيقة صوت) إلى كلام طبيعي عبر صوتين هما stella وtide في 10 لغات بينها العربية والإنجليزية مع خيار تنظيف رموز Markdown، دون دعم لتغيير سرعة النطق أو استئناف البث المقطوع.

الأسعار الرسمية والحدود التقنية بالتفصيل

تحتسب DeepSeek رسوم الأدوات لكل استخدام فوق تكلفة التوكنات عند تشغيلها داخل الدردشة، أو كرسوم مستقلة عند استدعاء مسارات /v1/tools/ مباشرة. جميع الأرقام التالية مأخوذة من صفحة التسعير الرسمية بتحديث 13 نوفمبر 2026، مع تطبيق أسعار الذروة من الإثنين إلى الجمعة بين 01:00 و04:00 صباحا وبين 06:00 و10:00 صباحا بتوقيت UTC باستثناء العطلات الرسمية الصينية، بينما تنخفض الأسعار للنصف في الأوقات غير الذروية وعطلات نهاية الأسبوع.

الأداة أو الفئة	السعر الرسمي بالدولار	الحدود التقنية الأساسية
إدخال deepseek-flash (تطابق التخزين المؤقت)	0.003 خارج الذروة / 0.006 ذروة لكل مليون توكن	سياق مليون توكن، حد تزامن 2,500 طلب
إدخال deepseek-flash (دون تخزين مؤقت)	0.15 خارج الذروة / 0.30 ذروة لكل مليون توكن	سياق مليون توكن، يدعم الرؤية والصور
إخراج deepseek-flash	0.60 خارج الذروة / 1.20 ذروة لكل مليون توكن	حد أقصى 384 ألف توكن إخراج
البحث في الويب (نصوص وصور)	0.75 لكل 1,000 عملية بحث	من 1 إلى 50 نتيجة في الواجهة المستقلة
جلب صفحة ويب	0.75 لكل 1,000 عملية جلب	يعيد نص Markdown جاهز للمعالجة
تحليل الملفات وواجهة OCR	0.225 لكل 1,000 صفحة	حتى 100 ميجابايت و1,000 صفحة، مهلة 180 ثانية
تحويل النص إلى صوت TTS	0.45 قياسي / 0.225 عرض مؤقت لكل 10,000 حرف	صوتان stella وtide في 10 لغات بينها العربية
تحويل الصوت إلى نص ASR	0.116 قياسي / 0.058 عرض مؤقت لكل ساعة صوت	يحاسب بالثانية، حد 8 ميجابايت و120 ثانية و50 تزامن

بالنسبة للفرق العاملة في القاهرة أو الرياض أو دبي، توافق ساعات الذروة بتوقيت UTC الفترة من 03:00 إلى 06:00 صباحا ومن 08:00 إلى 12:00 ظهرا بتوقيت القاهرة (UTC+2) أيام العمل. لذلك فإن جدولة مهام المعالجة الخلفية الثقيلة مثل فحص كتالوجات الموردين ليلا تمنحك سعر التوكن المخفض للنصف، بينما تبقى رسوم الأدوات مثل البحث وOCR والصوت ثابتة على مدار الساعة.

يجب الانتباه أيضا إلى أن أسعار TTS وASR الحالية تشمل خصما ترويجيا مؤقتا بنسبة 50% (0.225 دولار لكل 10,000 حرف و0.058 دولار لساعة الصوت)، ومع احتفاظ الشركة بحق تعديل الأسعار يفضل حساب الميزانيات التشغيلية على السعر القياسي الكامل (0.45 و0.116 دولار). وعند المقارنة مع نموذج Gemini 4 Hydrogen المسعر عند 1.50 دولار لمليون توكن إدخال و7.50 دولار لمليون توكن إخراج، يظل deepseek-flash أقل بكثير في تكلفة التوكن مع توفير أدوات البحث وOCR والصوت العربي من نفس الحساب.

المزايا والقيود التي يجب تقييمها قبل الاعتماد

توحيد كل هذه القدرات تحت واجهة واحدة يوفر عليك إدارة اشتراكات متعددة، لكنه يفرض قيودا تقنية وتشغيلية واضحة لا ينبغي تجاهلها قبل الربط بموقع حي.

• فوترة موحدة وثلاثة بروتوكولات: تستطيع الفرق التي تستخدم مكتبات OpenAI أو Anthropic إضافة البحث وقراءة الملفات وفحص الأمان دون البحث عن خدمات كشط صفحات أو OCR خارجية.
• دعم صوتي عربي بتكلفة منخفضة: الاكتشاف التلقائي للغة العربية في ASR وTTS يسهل بناء تجارب صوتية بتكلفة مبدئية بسيطة، لكن الخيارات تقتصر حاليا على صوتين فقط دون تحكم في سرعة القراءة.
• حدود صارمة لحجم الصوت وزمن OCR: واجهة ASR ترفض الملفات الأكبر من 8 ميجابايت أو الأطول من 120 ثانية ولا تدعم البث المباشر، وواجهة OCR تفرض مهلة 180 ثانية تشمل الرفع والمعالجة، ما يستلزم تقسيم الملفات الضخمة في طوابير عمل.
• التزامات الامتثال والخصوصية: فحص الأمان المرتفع يقدم حماية أساسية فقط ولا يعفي صاحب الموقع من مراجعة المحتوى والالتزام بضوابط الخصوصية، كما لا يمكن إعادة تنزيل الملفات المرفوعة أو نواتج تحليلها من واجهة الملفات.

ماذا يعني هذا التحديث لأصحاب مواقع ووردبريس وووكومرس

إذا كنت تدير موقع شركة أو متجر ووكومرس، لا تضع مفتاح DeepSeek API أبدا داخل كود JavaScript في واجهة المتصفح. صحيح أن DeepSeek طرحت تطبيقا تجريبيا يعمل في المتصفح للمطورين، لكنها حذرت بوضوح أنه مخصص للتجربة الشخصية فقط لأن المفاتيح تبقى على جهاز المستخدم. أي دمج فعلي على موقع عام يحتاج إلى نقطة نهاية آمنة عبر ووردبريس REST API أو وسيط خادم من خلال تطوير مواقع ووردبريس المخصصة.

في السوق العربي، تبرز ثلاث حالات استخدام عملية ومربحة لهذه الحزمة:

• مساعد استفسارات صوتي بالعربية والإنجليزية: يمكن لعيادة أو شركة عقارات أو مورد B2B استقبال رسائل صوتية قصيرة حتى 120 ثانية في نموذج التواصل، وتفريغها عبر /v1/tools/asr ثم الرد من صفحات الخدمة المعتمدة أو تحويل الرد إلى صوت عبر /v1/tools/tts.
• استخراج قوائم أسعار الموردين عبر OCR: تستطيع متاجر الجملة على ووكومرس التي تستلم كتالوجات PDF مصورة بالعربية أو الإنجليزية تشغيل /v1/tools/ocr في مهام خلفية لاستخراج النصوص والأسعار ومراجعتها بشريا قبل تحديث المنتجات.
• لوحة مساعدة موثقة لفريق المحتوى والدعم: يمكن ربط deepseek_read_url أو /v1/tools/fetch مع تطبيقات الذكاء الاصطناعي في ووردبريس لمساعدة الفريق في تلخيص مواصفات الشركات المصنعة والتحقق من الروابط من داخل لوحة الإدارة.

وقبل فتح أي أداة محادثة أو رفع ملفات للزوار، احرص على تفعيل مستوى الأمان high مع حدود معدل الطلبات لكل عنوان IP والتحقق الصارم من صيغ الملفات وسقوف الإنفاق، حتى لا يتسبب مستخدم واحد في استنزاف الرصيد عبر استعلامات بحث متكررة أو ملفات ضخمة. وإذا أردت تقييم ملاءمة هذه الحزمة لبنية متجرك أو موقعك وضبط ضوابط التكلفة والأمان قبل البرمجة، يمكنك حجز استشارة مجانية لمراجعة الخطة التقنية الأنسب لمشروعك.

الأسئلة الشائعة

المراجع

• وثائق DeepSeek API: إتاحة تجربة تطبيق DeepSeek الكاملة عبر API بتاريخ 2026-11-13
• وثائق DeepSeek API: النماذج والتسعير
• وثائق DeepSeek API: دليل بناء روبوت المحادثة
• وثائق DeepSeek API: أدوات الويب deepseek_web_search وdeepseek_read_url
• وثائق DeepSeek API: واجهات البحث وجلب الصفحات
• وثائق DeepSeek API: تحليل الملفات والمستندات
• وثائق DeepSeek API: واجهة OCR المستقلة
• وثائق DeepSeek API: تحويل الصوت إلى نص ASR
• وثائق DeepSeek API: تحويل النص إلى صوت TTS
• وثائق DeepSeek API: مراجعة أمان المحتوى
• مستودع GitHub: تطبيق DeepSeek chat-demo مفتوح المصدر