الملخص: أتاحت DeepSeek للمطورين قدرات البحث وتحليل الملفات وقراءة الروابط والصوت الموجودة في تطبيقها، مع تولّي خدمة API تنفيذ مسارات الأدوات الرئيسية.
في 13 نوفمبر 2026، أعلنت DeepSeek رسميًا عن إطلاق واجهات API للحزمة الكاملة للتطبيق. فالقدرات التي كانت مدمجة في تطبيق DeepSeek ونسخته على الويب — البحث عبر الإنترنت، والبحث بالتفكير العميق، وقراءة الروابط، وإدخال الملفات، والتحقق من أمان النموذج — إضافة إلى الواجهات المستقلة Search وFetch وOCR وASR وTTS، أصبحت جميعها متاحة للاستدعاء عبر API. والتغيير الجوهري في هذا التحديث هو أنه بعد أن يعلن المطور في الطلب عن أدوات مثل deepseek_web_search وdeepseek_read_url، تتولى خدمة DeepSeek تنفيذ البحث وقراءة صفحات الويب ودمج السياق، ولم يعد على العميل أن ينسّق بنفسه سلسلة الاستدعاء «النموذج ← البحث ← الجلب ← الإرجاع ← طلب جديد». وتقول الشركة إنه يمكن عبر هذه المجموعة من واجهات API تحقيق وظائف تكاد تكون مطابقة لما يقدمه تطبيق DeepSeek.
نتناول في ما يلي أولاً القدرات التي فُتحت هذه المرة، وأي النماذج والبروتوكولات يمكن استخدامها؛ ثم نفصّل واحدًا واحدًا المسارات التقنية والقيود الخاصة بالبحث عبر الإنترنت والبحث العميق والملفات والروابط والصوت وOCR؛ بعد ذلك نقارن بين طريقتي التطوير القديمة والجديدة، ونوضح ما لا تزال الواجهة الأمامية مسؤولة عنه؛ وأخيرًا نستعرض، مع ثلاثة أنواع من المنتجات — سؤال وجواب إخباري، وقراءة التقارير المالية، والمساعد الصوتي — منطق اختيار مساري التكامل: الأدوات المدمجة والأدوات المستقلة.

للمعرفة: مصطلحات API الخاصة بحزمة DeepSeek الكاملة
| المصطلح | الشرح |
|---|---|
| API | واجهة تتبادل بين البرامج الطلبات والنتائج بصيغة متفق عليها |
| Harness | إطار تشغيل يدير سير تنفيذ الوكيل والنموذج والأدوات والسياق |
| Server-side Tool | أداة ينفّذها خادم خدمة النموذج، ولا يستقبل العميل سوى نتيجة التنفيذ |
| Deep Thinking Search | قيام النموذج أثناء عملية الاستدلال بعدة عمليات بحث وفتح صفحات ويب والتنقيب عن المعلومات |
| Chat Completions | واجهة إكمال المحادثة التقليدية على نمط OpenAI |
| Responses API | واجهة تدعم الاستجابات المهيكلة واستدعاء الأدوات والتفاعل متعدد الجولات |
| Messages API | واجهة رسائل على نمط Anthropic |
| Files API | واجهة لتحميل الملفات وتحليلها وإرجاع file_id للاستشهاد به في المحادثة |
| OCR | التعرف الضوئي على الحروف: تحويل النص في الصور أو المستندات إلى نص قابل للمعالجة |
| ASR | التعرف التلقائي على الكلام: تحويل الصوت إلى نص |
| TTS | تحويل النص إلى كلام |
| Citation | آلية استشهاد تربط محتوى الإجابة بمصدر معلومات محدد |
| tool_choice | معامل في الطلب يتحكم في طريقة استدعاء النموذج للأدوات |
1 واجهات API لحزمة DeepSeek الكاملة تفتح القدرات الأساسية للتطبيق أمام المطورين
1.1 ماذا أطلقت واجهات API لحزمة DeepSeek الكاملة في 13 نوفمبر؟
تنقسم القدرات التي أُطلقت في هذا التحديث إلى نوعين: النوع الأول أدوات من جانب الخادم مدمجة في المحادثة ويستدعيها النموذج تلقائيًا أثناء الإجابة، والنوع الثاني واجهات أدوات مستقلة يمكن للمطورين استدعاؤها منفردة وتجميعها بحرية.
| القدرة | الاسم الإنجليزي | شكل الاستدعاء | الوظيفة |
|---|---|---|---|
| البحث عبر الإنترنت | Web Search | أداة مدمجة في المحادثة | يقرر النموذج بنفسه ما إذا كان سيبحث، ثم يعيد إجابة مع مراجع |
| البحث بالتفكير العميق | Deep Thinking Search | أداة مدمجة في المحادثة | بحث متعدد الخطوات، وفتح صفحات الويب، والبحث داخل الصفحة |
| قراءة الروابط | Read URL | أداة مدمجة في المحادثة | قراءة روابط صفحات الويب الواردة في رسائل المستخدم |
| إدخال الملفات | File Input | Files API + المحادثة | تحليل ملفات PDF وOffice والصور ثم إدخالها إلى السياق |
| أمان النموذج | Safety Check | معاملات الطلب | مراجعة الإدخال ونتائج الأدوات والإخراج |
| البحث في صفحات الويب | Search API | واجهة مستقلة | إرجاع نتائج بحث منظمة |
| جلب صفحات الويب | Fetch API | واجهة مستقلة | استخراج النص الأساسي لصفحة الويب |
| التعرف الضوئي على الحروف | Optical Character Recognition | واجهة مستقلة | التعرف على النصوص في الصور والمستندات وتحديد مواقعها على الصفحة |
| التعرف التلقائي على الكلام | Automatic Speech Recognition | واجهة مستقلة | تحويل الصوت إلى نص |
| تحويل النص إلى كلام | Text-to-Speech | واجهة مستقلة | تحويل النص إلى صوت، مع دعم البث عبر WebSocket |
يتركّز هذا التحديث على طبقة قدرات التطبيق لدى النموذج. فإلى جانب قدرات الاستدلال في النموذج نفسه، جرى فتح المكوّنات التي تعتمد عليها تجربة على مستوى التطبيق كالبحث والمستندات والصوت والتحكم في المخاطر دفعةً واحدة، بحيث يحصل المطورون على مجموعة من البنية التحتية يمكن تركيبها مباشرةً لبناء منتجاتهم.
وفي اليوم نفسه، أتاحت DeepSeek أيضًا نموذج Chat Demo خفيفًا للواجهة الأمامية مفتوح المصدر، ليكون تطبيقًا مرجعيًا لمحاكاة تجربة التطبيق. وكخلفية لذلك، كانت DeepSeek قد أتاحت في 13 أغسطس إطار تشغيل الوكيل DeepSeek Harness مفتوح المصدر. وهو ينتمي مع واجهات API لحزمة DeepSeek الكاملة إلى طبقتين مختلفتين: طبقة الإطار وطبقة الواجهات، وهما خطان منتجان مستقلان لكنهما مترابطان.
1.2 ما النماذج والبروتوكولات التي يدعمها API الحزمة الكاملة من DeepSeek
يتولى deepseek-flash حاليًا التكامل الكامل للأدوات على مستوى المحادثة، وهو الموافق للإصدار الرسمي DeepSeek-V4.1-Flash-1017. يدعم هذا النموذج وضع التفكير ووضع عدم التفكير، والبحث عبر الإنترنت، والبحث بالتفكير العميق، وقراءة الروابط، وتحليل الملفات، وفهم الصور، والتحقق الأمني، مع نافذة سياق بطول 1M وحد أقصى للإخراج يبلغ 384K. ويستهدف التكامل المذكور في الإعلان deepseek-flash بشكل صريح، أما نطاق دعم الأدوات في نماذج أخرى مثل DeepSeek-V4-Pro فيُحدَّد وفق التوضيحات الرسمية اللاحقة.
| البروتوكول | عنوان الطلب | الميزات |
|---|---|---|
| OpenAI Chat Completions | POST api.deepseek.com/chat/completions |
إكمال المحادثة التقليدي، بأقل تكلفة للانتقال |
| OpenAI Responses | POST api.deepseek.com/responses |
استجابات منظمة وتفاعل أدوات متعدد الجولات |
| Anthropic Messages | POST api.deepseek.com/anthropic/v1/messages |
تنسيق رسائل على نمط Anthropic |
تدعم البروتوكولات الثلاثة قدرات البحث من جانب الخادم وقراءة الروابط والتعامل مع الملفات، غير أن معاملات الطلب وبنية الاستجابة تختلف في كل منها. ويمكن للفرق التي لديها كود OpenAI SDK أن تفضل Chat Completions أو Responses، أما المشاريع المبنية على منظومة Claude فيمكنها اختيار بروتوكول Messages.
2 كيف تُنجز حزمة API الكاملة من DeepSeek المهام التي كانت موزعة سابقًا؟
2.1 البحث عبر الإنترنت في DeepSeek: النموذج يقرر متى يبحث
بعد الإعلان عن deepseek_web_search ضمن tools في الطلب، يقرر النموذج بناءً على السؤال ما إذا كان يحتاج إلى الاتصال بالإنترنت، ويولّد عبارات البحث تلقائيًا، بينما ينفّذ الخادم البحث، ثم يرتّب المعلومات ويضيف مراجع المصادر. تدعم هذه الأداة البحث في صفحات الويب والصور.
خذ استعلامًا إخباريًا تقنيًا مثل «ما ميزات API الجديدة التي أطلقتها DeepSeek مؤخرًا؟» كمثال؛ سيتضمن المحتوى المُعاد عبارات البحث، ونتائج بحث منظمة، وعناوين URL للمصادر، والعناوين، وأوقات النشر، ومعلومات الاستشهاد. يوضح طلب Chat Completions الوارد في الوثائق الرسمية كما يلي، وهو يفعّل في الوقت نفسه وضع التفكير والبحث عبر الإنترنت وقراءة الروابط:
{
"model": "deepseek-flash",
"thinking": { "type": "enabled" },
"tools": [
{ "type": "deepseek_web_search" },
{ "type": "deepseek_read_url" }
],
"messages": [
{ "role": "user", "content": "调查DeepSeek最近发布了哪些API新功能" }
],
"stream": true
}
تحتاج قواعد التحكم في استدعاء الأدوات إلى انتباه خاص:
- بعد الإعلان عن الأداة في
tools، يقرر النموذج ما إذا كان سيستدعيها. - لا يمكن لـ
tool_choiceأن يفرض تحديدdeepseek_web_searchأوdeepseek_read_url. - يؤدي
tool_choice: noneإلى تعطيل جميع الأدوات. - هناك قيود على نطاق الدعم عند دمج أدوات الاتصال بالإنترنت مع أدوات الخادم الأخرى، ويؤدي تجاوز هذا النطاق إلى خطأ 400.
2.2 البحث العميق في DeepSeek: من استعلام واحد إلى بحث متعدد الخطوات
عند تفعيل وضع التفكير، يتحول البحث عبر الإنترنت إلى بحث تفكير عميق. فالنموذج يستخدم أثناء الاستدلال ثلاثة إجراءات بالتناوب: search للبحث عن الكلمات المفتاحية، وopen_page لفتح صفحة الويب التي عثر عليها، وfind_in_page للبحث عن معلومات محددة داخل الصفحة.
نتيجة كل خطوة تؤثر على قرار الخطوة التالية. إذ يمكن للنموذج أن يضيف كلمات مفتاحية جديدة بناءً على نتائج الجولة الأولى، وأن يفتح البيانات الرسمية للتحقق من التفاصيل، ثم يقارن بين مصادر متعددة بشكل متقاطع، ليقدم بعد نحو 20 استدعاء أداة كحد أقصى إجابةً مدعومة بالمراجع. وبالنسبة إلى الأسئلة البحثية، فهذا يعني أن وكيل استرجاع صغيرًا أصبح مدمجًا داخل الواجهة.
2.3 ملفات وروابط DeepSeek: دع النموذج يقرأ المواد الخارجية مباشرة
deepseek_read_url مخصص لقراءة عنوان URL الذي يقدمه المستخدم، والقواعد كالتالي:
- يتعرف فقط على عناوين URL الواردة في آخر رسالة من المستخدم، ويأخذ في الاعتبار أول 10 عناوين مختلفة كحد أقصى، والعنوان المكرر يُحسب مرة واحدة.
- النموذج هو من يقرر أي العناوين سيُقرأ فعليًا.
- عند قراءة عدة صفحات ويب طويلة في الجولة نفسها، يقل السياق المتاح لكل صفحة على حدة.
- إذا فُعّل التفكير وأُعلن
deepseek_web_searchفي الوقت نفسه، فإن هذه الجولة تعتمد آلية بحث التفكير العميق.
تُتاح قدرة الملفات عبر Files API: استدعِ POST /files لرفع ملف، وبعد أن يكمل الخادم التحليل يعيد file_id، ويكفي الإشارة إلى هذا المعرّف في المحادثة. يجب عند الرفع تحديد غرض التحليل، والفرق بين الوضعين هو ما إذا كان النموذج سيتمكن من رؤية الرسوم والجداول:
- text_recognition: يحتفظ بالنص الخالص فقط، مناسب للمواد النصية مثل العقود والأوراق البحثية، بينما يُهمل محتوى الرسوم والجداول.
- rich_layout_recognition: يحتفظ بالنص، ويقوم تلقائيًا بقص الصور والرسوم البيانية ويسلمها إلى النموذج بموضعها الأصلي؛ مناسب للتقارير المالية وPPT والتقارير المختلطة نصًا وصورة، ويستهلك Tokens إضافية للصور.
تشمل الصيغ المدعومة PDF وDOC/DOCX وPPT/PPTX، وكذلك الصور PNG وJPEG وWebP وGIF وBMP وTIFF وغيرها. الحد الأقصى للملف الواحد 100 MiB وبحد أقصى 1000 صفحة، ويجب أن يكتمل الرفع والتحليل كل منهما في غضون 120 ثانية، ويمكن الإشارة إلى 20 ملفًا كحد أقصى في الطلب الواحد. أما ملفات XLSX وCSV وEPUB وغيرها فيمكن رفعها بوصفها user_data، ويقوم النظام بتحويلها إلى Markdown دون تحصيل رسوم تحليل.
بعد دخول نتيجة التحليل إلى سياق النموذج، يمكن للنموذج الإجابة بناءً على النص الكامل أو التلخيص أو المقارنة، ويبقى محتوى الملفات التاريخية محفوظًا طوال المحادثات متعددة الجولات. والإشارة المتكررة إلى ملف تم تحليله لا تُحتسب عليها رسوم تحليل مرة أخرى، لكنها تُحاسب على Tokens الإدخال التي تدخل السياق فعليًا. ومن الناحية الهندسية هناك تفصيلان إضافيان: عند الرفع عبر Multipart يجب أن يأتي حقل purpose قبل حقل file؛ وإذا كان المستند طويلًا بحيث يتجاوز حد السياق، فإن الطلب يعيد خطأ 400.
2.4 DeepSeek للصوت وOCR: استكمال قدرات الإدخال والإخراج في التطبيقات
إن OCR وASR وTTS كلها واجهات مستقلة، ومساراتها هي /v1/tools/ocr و/v1/tools/asr و/v1/tools/tts على الترتيب.
- OCR: يتعرّف على النصوص الموجودة في الصور وملفات PDF وWord وPowerPoint، مع تحديد موضع كل نص في الصفحة. الحد الأقصى للملف الواحد 100 MiB و1000 صفحة، ومهلة المعالجة 180 ثانية. وتختلف وظيفته عن تحليل الملفات: فالـ OCR مسؤول عن استخراج النص بشكل مستقل، أما تحليل الملفات فهو المسؤول عن إدخال المحتوى إلى سياق النموذج.
- ASR: يدعم 21 لغة من بينها الصينية والكانتونية والإنجليزية واليابانية، ويتعرّف على اللغة تلقائيًا. صيغة الإدخال هي 16-bit PCM WAV أو Ogg Opus، والحد الأقصى للملف الواحد 8 MiB وبمدة أقصاها 120 ثانية، ويستخدم التعرف غير المتدفق عبر رفع الملف كاملًا.
- TTS: يوفّر صوتين هما stella (نجمة البحر، صوت أنثوي، الافتراضي) وtide (المدّ الداكن، صوت ذكوري)، ويدعم 10 لغات من بينها الماندرين والكانتونية والإنجليزية. الحد الأقصى للإدخال في المرة الواحدة 10,000 حرف محتسب، ويمكن أن يعيد حتى 30 دقيقة من الصوت. صيغ الإخراج هي WAV وPCM، ويدعم التركيب المتدفق عبر WebSocket، لكنه لا يدعم تعديل سرعة الكلام حاليًا.
وبربط هذه الواجهات الثلاثة مع نموذج المحادثة نحصل على سلسلة مساعد صوتي متكاملة: يحوّل ASR كلام المستخدم إلى نص، ثم يجيب deepseek-flash بالاستعانة بالبحث أو بالاستدلال على الملفات، وأخيرًا يقرأ TTS الإجابة بصوت مسموع. أما مساعد المستندات فيمكنه أولًا استخدام OCR لاستخراج نص المستندات الممسوحة ضوئيًا على دفعات وبناء فهرس لها، ثم استخدام Files API ليقرأ النموذج ملفًا واحدًا بعمق أكبر.

3 واجهات API لحزمة DeepSeek الكاملة تغيّر طريقة تكامل المطورين
3.1 كيف كان المطورون يبنون مساعدًا ذكيًا متصلًا بالإنترنت سابقًا
قبل ظهور الأدوات من جانب الخادم، كان بناء مساعد قادر على الاتصال بالإنترنت يتطلب أن يدير العميل بنفسه حلقة الأدوات:
- بعد سؤال المستخدم، يُرسل طلب إلى API النموذج.
- يقرر النموذج أن البحث مطلوب، فيعيد طلب استدعاء أداة.
- يستدعي العميل واجهة API بحث تابعة لطرف ثالث.
- يستدعي العميل خدمة استخراج المحتوى للحصول على النص الفعلي للصفحة.
- يضمّ العميل النتائج إلى السياق، ثم يرسل طلبًا آخر إلى النموذج.
- يولّد النموذج الإجابة النهائية.
في هذه السلسلة، غالبًا ما تأتي خدمة البحث وخدمة الاستخراج وتحليل الملفات وOCR والصوت ومراجعة المحتوى من موردين مختلفين، ويحتاج كل مورد إلى تكامل منفصل للمصادقة والفوترة ومعالجة الأخطاء وسياسات المهلة.
3.2 كيف تختصر واجهة API لحزمة DeepSeek الكاملة سلسلة الاستدعاء؟
في النمط الجديد، لا يحتاج المطور إلا إلى الإعلان عن الأداة داخل الطلب. يقرر نموذج DeepSeek بنفسه ما إذا كان يجب البحث، ثم ينفّذ الخادم عملية البحث وقراءة صفحة الويب، وينظّم نتائج الأداة والسياق، ويواصل النموذج استدلاله، ليعيد في النهاية الإجابة مع الاستشهاد بالمصادر. وهكذا أصبحت الخطوات من الثانية إلى الخامسة، التي كان العميل يتولاها سابقًا، تُنفَّذ بالكامل على الخادم.

عندما يتولى الخادم تنفيذ سير العمل، يتولى أيضًا جزءًا من معاملات التوليد. فعند تفعيل أداة التصفح المدمجة أو التحقق الأمني أو ميزة عنوان الجلسة، قد تُتجاهل المعاملات temperature وtop_p وfrequency_penalty وpresence_penalty وstop وseed وn وparallel_tool_calls في Chat Completions. ويبقى max_tokens ساريًا، لكنه يحدّ من طول المخرجات في كل خطوة استدلال. أما الحالات التي تتطلب تحكمًا صارمًا في معاملات أخذ العينات، فينبغي تقييم مدى ملاءمة نمط الأدوات المدمجة لها بشكل منفصل.
يُفعَّل التحقق الأمني عبر معامل الطلب "safety_check": {"level": "high"}، ويغطي مدخلات المستخدم ونتائج الأدوات والمخرجات النهائية للنموذج، وعند رصد خطر يُعيد الخطأ 400 أو ينتهي برفض الإجابة. وتشير الوثائق الرسمية صراحةً إلى أن هذه الإمكانية توفر تحكمًا أساسيًا في المخاطر، إلا أن مزوّدي التطبيقات لا يزالون ملزمين بواجبات مراجعة المحتوى وتسجيل نماذج اللغة الكبيرة ووسم المحتوى المولّد بالذكاء الاصطناعي.
3.3 ما يبقى على الواجهة الأمامية مسؤوليتها عند استخدام مجموعة واجهات DeepSeek الكاملة
يتولّى DeepSeek تنفيذ الأدوات وتنظيم السياق، بينما تبقى تجربة المنتج مسؤولية العميل. وأبرز الحقول المرتجعة التي يجب التعامل معها:
server_tool_use: ما استدعاءات الأدوات التي نفّذها الخادم.web_search_tool_resultوweb_fetch_tool_result: نتائج البحث ونتائج جلب صفحات الويب.citations: الاستشهادات بالمصادر داخل الإجابة، وتُسلَّم في المخرجات المتدفقة عبر أحداث مثلcitations_delta.signature: التوقيع اللازم لحفظ جزء من سياق الأدوات.
في المحادثات متعددة الأدوار يجب إعادة تمرير كتل المحتوى ذات الصلة كما هي تمامًا. فنص صفحة الويب التي يقرأها deepseek_read_url يُحفظ عبر توقيع مشفّر، وإذا عدّله العميل أو أسقطه فلن يستطيع استعادة سياق صفحة الويب في الأدوار التالية. ويُستحسن ربط الاستشهادات بكتلة النص المقابلة لها عند العرض. وهناك تفصيل آخر في حالة البث المتدفق: قد يكون جزء من المحتوى قد ظهر بالفعل، ثم يتبيّن في النهاية أن الرد مرفوض، وهنا يجب على الواجهة الأمامية أن تسحب المحتوى المعروض وتستبدله برسالة الرفض.
يُعدّ Chat Demo المفتوح المصدر الرسمي مرجعًا ممتازًا في هذا الجانب؛ فهو ينفّذ إنشاء عنوان المحادثة تلقائيًا، وتحرير الرسائل، وإعادة التوليد، ومواصلة التوليد، واستيراد المحادثات السابقة وتصديرها، وعرض Markdown وMermaid، والسمتين الفاتحة والداكنة، والمراجعة الأمنية للصور، والإدخال الصوتي والقراءة الصوتية، مع حفظ مفتاح API والمحادثات السابقة والصور محليًا في المتصفح. أما التطبيق التجاري الكامل فيحتاج فوق ذلك إلى طبقة أعمال تكميلية تشمل الحسابات وإدارة البيانات والدفع والصلاحيات والمراجعة الأمنية.
4 أنواع المنتجات الأنسب لحزمة واجهات DeepSeek الكاملة
4.1 مساعد الأسئلة الإخبارية والبحث البحثي بالذكاء الاصطناعي
عندما يستفسر المستخدم عن معلومات آنية مثل الإصدارات الحديثة للنماذج أو مستجدات القطاع، يقوم النموذج بالبحث عبر الإنترنت لجمع المواد، ثم يفتح الإعلانات الرسمية للتحقق منها، ثم يقدّم إجابة مدعومة بالمراجع. البحث بالتفكير العميق يناسب الأسئلة البحثية التي تتطلب التحقق المتقاطع من مصادر متعددة، أما قراءة الروابط فتناسب الحالات التي يلصق فيها المستخدم عنوان URL مباشرة ويطلب التلخيص أو المقارنة.
4.2 مساعد التقارير المالية بصيغة PDF ومعرفة المؤسسة
تحتوي التقارير المالية وأوراق العمل التقنية وعروض PowerPoint الداخلية عادةً على كمّ كبير من الرسوم البيانية. باستخدام وضع rich_layout_recognition، يستطيع النموذج فهم النص الأساسي ومحتوى الرسوم مثل مخططات اتجاه الإيرادات في آنٍ واحد، والإجابة عن أسئلة من قبيل «أي ربع شهد أسرع نمو» والتي تعتمد على الرسوم البيانية. أما العقود والوثائق التنظيمية النصية البحتة فيكفيها استخدام text_recognition، وبتكلفة أقل.
4.3 تطبيقات التفاعل الصوتي
يمكن لمزيج ASR وdeepseek-flash وTTS أن يغطي تطبيقات الأسئلة الصوتية وتنظيم تسجيلات الاجتماعات ونسخ المقابلات وتطبيقات القراءة بصوت عالٍ. وتجدر الإشارة إلى أن الحد الأقصى لمقطع الصوت الواحد في ASR هو 120 ثانية وأن التعرف غير تدفقي (non-streaming)، لذا تحتاج التسجيلات الطويلة إلى تقسيم من جهة العميل؛ بينما يدعم TTS التركيب التدفقي عبر WebSocket، فيمكن التوليد والتشغيل في آنٍ واحد، مما يقلل زمن انتظار أول حرف.
أسعار أدوات DeepSeek الرسمية كما يلي، وفقًا لوثيقة الأسعار الرسمية بتاريخ 15 نوفمبر 2026:
| القدرة | وحدة الفوترة | السعر المعلن | خصم محدود المدة |
|---|---|---|---|
| Search البحث | 1000 طلب ناجح | ¥5 | ¥5 |
| Fetch جلب صفحات الويب | 1000 طلب ناجح | ¥5 | ¥5 |
| تحليل الملفات | 1000 صفحة | ¥1.5 | ¥1.5 |
| OCR | 1000 صفحة | ¥1.5 | ¥1.5 |
| ASR | ساعة واحدة من الصوت | ¥0.78 | ¥0.39 |
| TTS | 10,000 حرف مفوتر | ¥3 | ¥1.5 |
تُحتسب تكاليف الأدوات بشكل منفصل عن تكاليف Tokens النموذج. سعر الإخراج في DeepSeek-V4.1-Flash لكل مليون Token هو ¥4 في الفترات الخاملة و¥8 في فترات الذروة، وفترات الذروة هي أيام العمل بتوقيت بكين من 09:00 إلى 12:00 ومن 14:00 إلى 18:00. لا تُفرض رسوم على طلبات الأدوات الفاشلة أو التي لا تعيد نتائج أو التي تنتهي مهلتها. يُحتسب البحث المدمج في النموذج حسب عدد عبارات الاستعلام البحثي الفعلية، ويُحتسب جلب صفحات الويب حسب عدد الصفحات التي جُلت بنجاح، ولا تُفرض رسوم منفصلة على البحث داخل الصفحات في البحث العميق، لذا قد تُحتسب تكاليف بحث متعددة في المحادثة الواحدة.
5 حزمة واجهات API المتكاملة من DeepSeek: من استدعاء نموذج واحد إلى تطبيق AI متكامل
تخفض حزمة واجهات API المتكاملة العوائق الهندسية أمام دمج القدرات في التطبيقات: فالبحث والقراءة والمستندات والصوت والتحكم في المخاطر كلها مجمّعة في حساب واحد ونظام فوترة واحد، مما يتيح للمطورين تركيز جهودهم على تفاعل المنتج ومنطق الأعمال. وبالنسبة لقدرة الاتصال بالشبكة، هناك مساران للدمج يمكن اختيارهما حاليًا.

| البُعد | أدوات خادم مدمجة في النموذج | أدوات Search / Fetch مستقلة |
|---|---|---|
| طريقة الاستدعاء | إعلان deepseek_web_search وdeepseek_read_url داخل طلب المحادثة |
استدعاء واجهات البحث والجلب بشكل منفصل |
| التحكم في سير العمل | النموذج يقرر متى يبحث وأي الصفحات يقرأ | المطور يحدد توقيت البحث وطريقة تصفية النتائج ودمجها |
| نطاق النماذج | deepseek-flash |
غير مرتبطة بنموذج معيّن، ويمكن ربطها بـ Agent وRAG وأي نموذج لغة كبير |
| طريقة الفوترة | احتساب حسب مصطلحات الاستعلام وعدد الصفحات المجلوبة، مع احتساب Token إضافية | احتساب حسب عدد الاستدعاءات الناجحة، ولا تستهلك Token النموذج نفسها |
| سيناريوهات الاستخدام | إعادة إنتاج سريعة لأسئلة وأجوبة شبكية بأسلوب التطبيقات | الحاجة إلى سير عمل استرجاع قابل للتحكم وإعادة استخدام نتائج البحث عبر النماذج |
| المنصات المتاحة | واجهة API الرسمية من DeepSeek | واجهة API الرسمية من DeepSeek؛ ومنصة APIYI (apiyi.com) أطلقت deepseek-search وdeepseek-fetch |
أطلقت منصة APIYI في 21 أكتوبر واجهتي الأدوات المستقلتين deepseek-search وdeepseek-fetch، وهما متاحتان في مجموعتي default وsvip. وبالنسبة للبحث المدمج في النموذج الذي تم إطلاقه في 13 نوفمبر، تعتبر APIYI في وثائقها أن أعمال التوافق الخاصة باستدعاء العميل للبحث المدمج مدرجة ضمن الخطط المستقبلية. لذلك، فإن استخدام قدرة DeepSeek على الاتصال بالشبكة عبر APIYI يعتمد حاليًا على مسار الأدوات المستقلة: استدعاء البحث والجلب بنفسك، ثم تسليم النتائج إلى أي نموذج للاستدلال.
5.1 الوصول إلى بحث DeepSeek عبر أداة مستقلة
مثال مبسّط للغاية: استدعاء Search للحصول على نتائج مُهيكلة (أسماء حقول الطلب تخضع لتوثيق APIYI):
import requests
BASE_URL = "https://api.apiyi.com/v1" # واجهة APIYI الموحدة
headers = {"Authorization": "Bearer YOUR_API_KEY"}
resp = requests.post(f"{BASE_URL}/tools/search", headers=headers, json={
"model": "deepseek-search",
"query": "DeepSeek 全家桶应用 API",
"count": 5,
})
print(resp.json())
عرض التنفيذ الكامل: البحث + الجلب + تلخيص النموذج
import requests
import openai
API_KEY = "YOUR_API_KEY"
BASE_URL = "https://api.apiyi.com/v1" # البحث والجلب واستدعاء النموذج تتشارك نفس نقطة الدخول
HEADERS = {"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"}
def search(query: str, count: int = 5) -> dict:
"""استدعاء deepseek-search وإرجاع نتائج بحث مُهيكلة (أسماء الحقول وفقًا للتوثيق)"""
r = requests.post(f"{BASE_URL}/tools/search", headers=HEADERS, json={
"model": "deepseek-search", "query": query, "count": count,
}, timeout=30)
r.raise_for_status()
return r.json()
def fetch(url: str) -> dict:
"""استدعاء deepseek-fetch وإرجاع النص الرئيسي لصفحة الويب بصيغة Markdown؛ الطلبات الفاشلة لا تُحتسب عليها رسوم"""
r = requests.post(f"{BASE_URL}/tools/fetch", headers=HEADERS, json={
"model": "deepseek-fetch", "url": url,
}, timeout=60)
r.raise_for_status()
return r.json()
def answer(question: str, context: str, model: str = "your-model-id") -> str:
"""تسليم المحتوى المسترجَع إلى أي نموذج لتوليد إجابة مع ذكر المصادر"""
client = openai.OpenAI(api_key=API_KEY, base_url=BASE_URL)
resp = client.chat.completions.create(
model=model,
messages=[
{"role": "system", "content": "根据提供的资料回答,并注明来源 URL。"},
{"role": "user", "content": f"资料:\n{context}\n\n问题:{question}"},
],
)
return resp.choices[0].message.content
if __name__ == "__main__":
q = "DeepSeek 11 月 13 日开放了哪些 API 能力?"
results = search(q)
# استخراج أول بضعة روابط URL وفقًا لبنية الاستجابة الفعلية، ثم جلب النص الرئيسي وتسليمه للنموذج
print(results)
🚀 نصيحة للبدء السريع: إذا أردت التحقق من فعالية الاسترجاع أولاً، يمكنك التسجيل في APIYI على apiyi.com والحصول على حصة تجريبية، ثم استخدام مفتاح API واحد لاستدعاء deepseek-search وdeepseek-fetch ونماذج المحادثة الشائعة في الوقت نفسه، وتسليم نتائج البحث إلى نماذج مختلفة لمقارنة جودة الإجابات.
تُظهر بيانات الاختبار الذاتي لدى APIYI أن Search يعيد النتائج في حوالي 1.8 ثانية عند count=5، وفي حوالي 3 ثوانٍ عند count=50، وأن 20 طلبًا متزامنًا يكتمل كله في نحو ثانيتين؛ بينما يستغرق Fetch في جلب صفحة ويب عادية حوالي 1.6 ثانية ليعيد نصًا بصيغة Markdown يبلغ نحو 6400 حرف. هذه نتائج اختبار لمرة واحدة في بيئة شبكة محددة، والوقت الفعلي يتأثر بموقع الهدف.
5.2 كيف تختار مسار ربط DeepSeek بالإنترنت
- اختر الأداة المدمجة: إذا كنت تريد أسرع طريقة لتكرار تجربة تطبيق DeepSeek، وتقبل أن يحدد النموذج مسار الاستدعاء بنفسه، وتستخدم
deepseek-flash. - اختر الأداة المستقلة: إذا كنت بحاجة إلى التحكم بنفسك في كلمات الاستعلام، وتصفية المصادر، وتخزين النتائج مؤقتًا، أو ترغب في تمرير النتائج نفسها إلى نماذج مختلفة مثل Claude وGPT وGemini لمعالجتها.
- استخدام مختلط: الأداة المدمجة للأسئلة والأجوبة المباشرة، وSearch / Fetch المستقلة لجمع المواد بالجملة في الخلفية وإدخالها إلى RAG.
الأسئلة الشائعة (FAQ)
س1: ما المقصود بواجهات API للحزمة الكاملة من DeepSeek؟
هي مجموعة من واجهات API لقدرات التطبيقات أعلنت عنها DeepSeek في 13 نوفمبر 2026، وتشمل البحث عبر الإنترنت، والبحث بالتفكير العميق، وقراءة الروابط، وإدخال الملفات، والتحقق الأمني، إضافة إلى واجهات مستقلة لكل من Search وFetch وOCR وASR وTTS، أي أنها تغطي القدرات الرئيسية التي تعمل خلف تطبيق DeepSeek.
س2: ما الفرق بين واجهات API للحزمة الكاملة من DeepSeek وDeepSeek Harness؟
Harness هو إطار عمل لتشغيل الـ Agent صدر مفتوح المصدر في 13 أغسطس، وهو مسؤول عن إدارة النماذج والأدوات والإضافات والسياق؛ أما واجهات API للحزمة الكاملة فهي واجهات الخدمة الخاصة بالنماذج والأدوات. يمكن للمطورين بناء Agent باستخدام Harness، ثم ربط قدرات البحث والملفات والصوت عبر واجهات API.
س3: ما النماذج التي يمكنها استخدام الأدوات المدمجة في واجهات API للحزمة الكاملة من DeepSeek؟
التكامل الكامل للأدوات على مستوى المحادثة متاح حالياً عبر `deepseek-flash` (DeepSeek-V4.1-Flash-1017)، ويدعم ثلاث بروتوكولات: Chat Completions وResponses وAnthropic Messages. أما OCR وASR وTTS وSearch وFetch فهي واجهات مستقلة يمكن استدعاؤها بشكل منفصل.
س4: ما قدرات واجهات API للحزمة الكاملة من DeepSeek التي يمكن استدعاؤها عبر APIYI؟
أطلقت APIYI أدوات DeepSeek المستقلة Search وFetch (deepseek-search وdeepseek-fetch)، وتُحتسب التكلفة حسب الاستدعاءات الناجحة، وهي متاحة في مجموعتي default وsvip. أما توافق العملاء مع البحث المدمج في النموذج فلا يزال قيد التخطيط، ويُرجى الرجوع إلى وثائق APIYI على apiyi.com لمعرفة آخر مستجدات الدعم.
س5: كيف أختبر بسرعة تأثير البحث في DeepSeek والجمع بين عدة نماذج؟
1. سجّل في APIYI على apiyi.com واحصل على مفتاح API وحصة تجريبية.
2. استخدم الكود الوارد في هذا المقال، واضبط base_url على `https://api.apiyi.com/v1`.
3. استدعِ deepseek-search أولاً للحصول على النتائج، ثم استخدم deepseek-fetch لقراءة النص الكامل، وأخيراً سلّم النتائج إلى أي نموذج محادثة لتوليد الإجابة.
س6: ما القيود المعروفة في واجهات API للحزمة الكاملة من DeepSeek؟
– لا يمكن لـ `tool_choice` فرض استدعاء أدوات البحث عبر الإنترنت، بل يقرر النموذج متى يبحث.
– بعد تفعيل الأدوات المدمجة، قد تُتجاهل معاملات أخذ العينات مثل `temperature` و`top_p`.
– الحد الأقصى لمقطع ASR الواحد هو 120 ثانية، وهو غير تدفقي؛ ولا يدعم TTS حالياً ضبط سرعة الكلام.
– الحد الأقصى للملف الواحد هو 100 MiB و1000 صفحة، وإذا تجاوز السياق سيُعيد الخطأ 400.
– يوفر التحقق الأمني ضوابط مخاطر أساسية، لكن يبقى على جهة التطبيق مسؤولية مراجعة المحتوى.
النقاط الأساسية في مجموعة واجهات DeepSeek API
- موعد الإطلاق: في 13 نوفمبر 2026، تم فتح 10 قدرات تطبيقية تقف خلف تطبيق App.
- التغيير الجوهري: يتم تنفيذ البحث وقراءة صفحات الويب على الخادم، ويكفي أن يعلن العميل عن الأدوات المستخدمة.
- النموذج المزوِّد: تكامل الأدوات على مستوى المحادثة يقدمه
deepseek-flash، ويدعم ثلاث بروتوكولات. - البحث العميق: تُنفَّذ أدوات search وopen_page وfind_in_page بالتناوب، بحد أقصى نحو 20 استدعاء أداة.
- تحليل الملفات: يوجد نمطان يتحددان حسب الحفاظ على الرسوم البيانية من عدمه، ويُستخدم النمط النصي-الصوري مع المستندات المالية.
- مسؤوليات الواجهة الأمامية: لا يزال العميل مسؤولاً عن عرض الاستشهادات وإعادة إرسال التوقيع وسحب الرفض في البث المتدفق.
- مسار التكامل: عندما تحتاج إلى استرجاع قابل للتحكم، يمكنك استدعاء أدوات Search / Fetch المستقلة عبر APIYI apiyi.com.
الخلاصة
يمكن تلخيص النقاط الأساسية في مجموعة واجهات DeepSeek API في ثلاثة أمور:
- انفتاح طبقة القدرات: البحث والمستندات والصوت والتحكم في المخاطر والنماذج موحدة في مجموعة API واحدة، وتذكر الجهة الرسمية أنه يمكن إعادة بناء تجربة App على أساسها.
- تقصير سلسلة الاستدعاء: تتولى أدوات الخادم البحث والجلب وتركيب السياق، ويوجّه المطورون جهدهم إلى التفاعل ومنطق الأعمال.
- وجود مسارين بالتوازي: الأدوات المدمجة مناسبة لبناء سريع لتجربة سؤال وجواب على غرار App، بينما تناسب أدوات Search / Fetch المستقلة الاسترجاع القابل للتحكم وإعادة الاستخدام عبر النماذج.
عند بناء نموذج أولي للأسئلة والأجوبة عبر الإنترنت، يمكنك أولاً استخدام الأدوات المدمجة للتحقق من التجربة؛ وإذا كنت تحتاج إلى تحكم دقيق في عملية الاسترجاع أو دمج عدة نماذج، يُنصح بالاتصال عبر APIYI apiyi.com بأدوات البحث والجلب المستقلة، مع واجهة موحدة للنماذج المتعددة لمقارنة النتائج بسرعة.
📚 المراجع
- DeepSeek تطلق API لحزمة تطبيقات متكاملة: إعلان رسمي بتاريخ 2026-11-13
- الرابط:
api-docs.deepseek.com/zh-cn/news/news261113/ -
الوصف: القائمة الكاملة للإمكانات التي جرى إتاحتها في هذا الإصدار
-
وثائق أدوات الوصول إلى الإنترنت في DeepSeek: البحث من جانب الخادم وقراءة الروابط
- الرابط:
api-docs.deepseek.com/zh-cn/guides/web_tools/ -
الوصف: تعريف الأدوات وقواعد الاستدعاء وطريقة الفوترة
-
وثائق تحليل الملفات في DeepSeek: دليل استخدام Files API
- الرابط:
api-docs.deepseek.com/zh-cn/guides/document_parsing/ -
الوصف: نمطا التحليل وحدود الملفات
-
دليل بناء Chatbot في DeepSeek: النقاط الأساسية لتطوير العميل
- الرابط:
api-docs.deepseek.com/zh-cn/guides/build_a_chatbot/ -
الوصف: الحقول المُرجَعة، وإعادة الإرسال في المحادثات متعددة الأدوار، والمعاملات التي يتم التحكم فيها
-
نماذج DeepSeek والأسعار: أسعار Token والأدوات
- الرابط:
api-docs.deepseek.com/zh-cn/quick_start/pricing/ -
الوصف: أسعار فترات الذروة وفترات الخمول
-
DeepSeek Chat Demo: مثال الواجهة الأمامية مفتوح المصدر الرسمي
- الرابط:
github.com/deepseek-ai/chat-demo -
الوصف: تنفيذ مرجعي لعرض الاقتباسات والتفاعل مع الملفات والصوت
-
وثائق DeepSeek Search & Fetch في APIYI: شرح واجهات الأدوات المستقلة
- الرابط:
docs.apiyi.com/api-capabilities/deepseek-search-fetch/overview - الوصف: معاملات الواجهة، وتوفر المجموعات، والتسعير
المؤلف: فريق APIYI التقني
للتواصل التقني: يسعدنا تواصلكم معنا عبر الصفحة الرئيسية لموقع APIYI، ولمزيد من مواد التكامل يمكنكم زيارة مركز الوثائق على docs.apiyi.com
