تتكوّن واجهة برمجة تطبيقات DeepSeek من نقطتَي نهاية واسمَي نموذجين — إليك ما يقبله كل واحد منهما.

تبدو واجهة DeepSeek API أبسط مما هي عليه في الواقع. فهناك عنوانا URL أساسيان، ومعرّفان للنماذج، ومصفوفة ميزات يتطابق عموداها تقريبًا — باستثناء السطر الوحيد الذي يحدد ما إذا كان عبء عملك ممكنًا أصلًا. إذا كنت تنتقل من OpenAI SDK فأنت تحتاج إلى أحدهما؛ وإذا كنت تنتقل من إطار عمل على غرار Anthropic فأنت تحتاج إلى الآخر؛ وإذا كنت ترسل لقطات شاشة، فلن يقبلها إلا أحد النموذجين.

القاعدتان

• صيغة OpenAI — code>https://api.deepseek.com/code>. إكمالات الدردشة بصيغة OpenAI، بما في ذلك واجهة Responses API، ومخرجات JSON، واستدعاءات الأدوات، وإكمال البادئة في الإصدار التجريبي.

• صيغة Anthropic — code>https://api.deepseek.com/anthropic/code>. النموذجان نفسهما خلف واجهة ذات شكل Anthropic، وهو ما تحتاجه أداة برمجية تتحدث بذلك البروتوكول.

كلا القاعدتين تخدم كلا الطرازين. إن اختيار القاعدة يتعلق بمكتبة العميل لديك، وليس بالإمكانات.

الاسمان، وما وراء كلٍّ منهما

• deepseek-flash —يُقدَّم حاليًا بواسطة DeepSeek-V4.1-Flash-1017، نقطة الحفظ الخاصة بشهر أكتوبر. متعدد الوسائط: نص وصور كمدخلات، ونص كمخرجات. سياق بطول 1M، وأقصى مخرجات 384K، و2,500 طلب متزامن.

• deepseek-v4-pro —مُقدَّم بواسطة DeepSeek-V4-Pro-0813. نص فقط. نفس سعة السياق البالغة 1M والمخرجات البالغة 384K، و500 طلب متزامن.

لا يزال يُقبل معرّفان قديمان — code>deepseek-v4-flash/code> و code>deepseek-v4-flash-vision-exp/code> — لكن وثائق DeepSeek صريحة في أن النماذج المقابلة قد أُحيلت إلى التقاعد، وأن الطلبات يخدمها V4.1-Flash-1017، وأنها تُحاسَب بسعر Flash. عمليًا، يعني ذلك أن تكاملًا قديمًا يستمر في العمل ويبدأ بهدوء في إعادة إجابات نموذج مختلف، وهو أمر يستحق التحقق منه قبل أن تنسب تغييرًا في المخرجات إلى أي شيء آخر.

مصفوفة الميزات، صفًا بصف

تقريبًا كل شيء مشترك. الاستثناءات هي السبب الكامل لوجود هذا الدليل.

• وضع التفكير — يدعم كلا النموذجين وضعَي عدم التفكير والتفكير، مع اعتبار التفكير هو الوضع الافتراضي. مستويات الجهد هي منخفض وعالٍ وأقصى؛ وتوصي DeepSeek باستخدام المستوى المنخفض للمهام البسيطة، والعالٍ لأعمال الوكلاء اليومية، والأقصى للسيناريوهات الأصعب.

• إخراج JSON، واستدعاءات الأدوات، وإكمال البادئة —مدعومة بشكل متطابق على كليهما. إكمال البادئة في النسخة التجريبية.

• واجهة Responses API وواجهة Anthropic API — كلتاهما مدعومتان على كلا الطرازين، وهذا أمر غير معتاد ويستحق المعرفة: يمكنك تشغيل أيّ من الطرازين من أيّ من شكلي العميل دون طبقة ترجمة.

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

• الرؤية — علامة صح لـ code>deepseek-flash/code>، و«غير مدعوم» لـ code>deepseek-v4-pro/code>. هذا هو المفرق الوحيد في المصفوفة، وليس شيئًا يستطيع تغييرٌ في الموجّه الالتفاف حوله.

ما الذي توحي به المعرّفات بشأن التكلفة

تحمل الأسماء بنية التسعير. يبلغ سعر Flash 0.15 دولارًا للإدخال و0.60 دولارًا للإخراج لكل مليون رمز، مع إصابة ذاكرة مؤقتة بسعر 0.003 دولار؛ ويبلغ سعر V4 Pro 0.66 دولارًا و1.98 دولارًا، وإصابة الذاكرة المؤقتة 0.022 دولار. يتضاعف كلا السعرين خلال 01:00–04:00 و06:00–10:00 بتوقيت UTC، من الاثنين إلى الجمعة. لذا فإن اسم النموذج الذي تختاره يحدد القدرة والفاتورة معًا، وتحدد الأسماء القديمة أعلاه الفاتورة بسعر Flash بغض النظر عن نقطة التفتيش التي تُجيب.

ثمة نتيجة عملية واحدة: بما أن code>deepseek-flash/code>

كيف يتقارن هذا بطبقة توجيه

توفّر واجهة DeepSeek الأصلية نموذجين فقط عبر بروتوكولين. إذا كان تطبيقك لا يحتاج أبدًا إلا إلى أقوى نموذج من DeepSeek، فهذا كافٍ. أما الحالات التي لا يكفي فيها فهي تلك التي لا يستطيع هذا الشكل التعبير عنها: اختيار نموذج احتياطي عند انقطاع أحد المزوّدين، أو دمج DeepSeek مع نموذج مزوّد آخر في سير عمل واحد، أو اختبار A/B بين Flash وPro على حركة مرور حية دون تكاملين.

هذا هو الغرض من نقطة النهاية المتوافقة مع OpenAI لدى OrcaRouter والتي تضم 224 نموذجًا، وDeepSeek V4 Pro وV4.1 Flash كلاهما متاحان عليها بأسعار DeepSeek المنشورة دون أي هامش — بما في ذلك بند إصابة ذاكرة التخزين المؤقت ومضاعفة أسعار الذروة، لأن سعر المورّد هو ما يمرّ كما هو. تظل نقاط النهاية أعلاه تعمل تمامًا كما توثّقها DeepSeek؛ فالموجّه لا يحل محل واجهة برمجة تطبيقات المورّد، بل يمنحك مكانًا واحدًا للتبديل بين عدة واجهات منها.

قائمة التحقق الخاصة بالترحيل، بالترتيب

• اختر الأساس بناءً على شكل عميلك، لا بناءً على النموذج الذي تريده.

• اختر النموذج بناءً على ما ترسله: الصور تعني Flash، أما العمل النصي فقط فالسعر هو الفيصل.

• عيّن جهد التفكير صراحةً بدلاً من وراثة الإعداد الافتراضي، لأن الإعداد الافتراضي هو تفعيل التفكير.

• تحقّق مما إذا كان معرّفك القديم قد أُحيل إلى التقاعد في غفلةٍ منك — فالاسمان القديمان مقبولان، وتُعاد فوترتهما، وتُعاد خدمتهما.

• قِس نسبة إصابة الذاكرة المؤقتة قبل أن تقدّر الفاتورة الشهرية، لأن البادئة المستقرة خصم مقداره 30× أما البادئة غير المستقرة فقيمتها لا شيء.