DeepSeek-V4-Flash يدعم الآن API الاستجابات وCodex: ما يحتاج المطورون لمعرفته

ضمن إعلان DeepSeek عن إصدار V4-Flash في 31 يوليو، يوجد السطر الأكثر إثارة للاهتمام استراتيجيًا: "يدعم V4-Flash الرسمي تنسيق Responses API أصلاً ومتوافق تمامًا مع Codex."

اقرأ ذلك مرة أخرى. قام مختبر صيني مفتوح المصدر بتطبيق أحدث تنسيق لواجهة برمجة تطبيقات OpenAI، وهو التنسيق الذي بنته OpenAI لمنتجاتها الوكيلة الخاصة، وذلك تحديدًا لتمكين وكيل البرمجة الخاص بـ OpenAI من التشغيل على نموذج DeepSeek. يذكر سجل التغييرات الدافع بوضوح: "لتلبية الطلب على Codex، تدعم واجهة برمجة التطبيقات الخاصة بنا الآن تنسيق Responses API."

تتناول هذه المقالة ما يعنيه ذلك عمليًا: مدى توافق التنفيذ، وما يتم تجاهله بصمت، وكيفية ربط V4-Flash بـ Codex في دقيقتين، وأين تكمن الصعوبات. إذا كنت تحتاج فقط إلى إعداد API أساسي أولاً، فابدأ بدليلنا لنسخة V4-Flash التجريبية العامة.

لماذا تُعد Responses API مهمة هنا

قدمت OpenAI واجهة Responses API كخليفة لـ Chat Completions: واجهة واحدة مصممة لأحمال العمل الوكيلية، مع عناصر استدلال من الدرجة الأولى، وأدوات مدمجة، وأحداث بث دلالية. نحن نفصل التنسيق في كيفية استخدام OpenAI Responses API، ولكن النسخة المختصرة هي: إنه التنسيق الذي تتحدثه حزمة وكيل OpenAI، بما في ذلك Codex، بشكل أصلي.

حتى الآن، كان تشغيل نموذج غير تابع لـ OpenAI خلف عميل Responses API يعني وجود وكيل ترجمة أو لا شيء. تجاوز DeepSeek الوكيل ونفّذ التنسيق من جانب الخادم على https://api.deepseek.com. تعمل حزمة تطوير البرامج (SDK) الحالية لـ OpenAI دون تغيير:

# pip3 install openai
from openai import OpenAI

client = OpenAI(
    api_key="<your DeepSeek API key>",
    base_url="https://api.deepseek.com"
)

response = client.responses.create(
    model="deepseek-v4-flash",
    instructions="You are a helpful assistant.",
    input="Hi, how are you?",
)

print(response.output_text)

ملاحظة سريعة قبل أن تتحمس: تعمل Responses API حاليًا مع deepseek-v4-flash فقط. تقول DeepSeek إن دعم deepseek-v4-pro سيصل في أوائل أغسطس 2026.

ما مدى اكتمال التوافق؟

نشرت DeepSeek مصفوفة توافق كاملة، وهو أكثر مما يكلف معظم المزودين "المتوافقين مع OpenAI" أنفسهم عناء القيام به. الصفوف المهمة:

مدعوم ويعمل:

• input و instructions، على شكل سلسلة نصية أو قائمة عناصر
• stream مع تسلسل الأحداث الدلالية الكامل
• temperature, top_p, max_output_tokens, top_logprobs
• أدوات بأنواع function و web_search؛ يتم تنفيذ البحث عبر الويب من جانب الخادم
• tool_choice بما في ذلك فرض دالة معينة
• reasoning.effort لعمق التفكير

مقبول لكنه غير فعال:

• reasoning.summary مقبول، ولكن لا يتم إنشاء أي ملخص
• text.verbosity مقبول دون أي تأثير
• parallel_tool_calls يتم تجاهله لأن استدعاء الأدوات المتوازي يكون دائمًا قيد التشغيل

غير مدعوم، حسب التصميم:

• previous_response_id و conversation: واجهة برمجة التطبيقات عديمة الحالة (stateless)، لذا تدير سجل المحادثة بنفسك وترسله كقائمة عناصر إدخال
• store: كل استجابة تعود بـ store: false
• background, metadata, include, service_tier, ومفاتيح تخزين المطالبة المؤقت؛ يتم تخزين السياق مؤقتًا تلقائيًا بدلاً من ذلك

الجزء السلس: يتم تجاهل المعلمات غير المدعومة بصمت بدلاً من رفضها، لذا تتصل عملاء Responses API الحاليون دون تعديل. الجزء الصعب: الطلبات التي تتجاوز نافذة السياق البالغة مليون رمز (token) تعيد خطأ 400 بدلاً من أن يتم اقتطاعها.

يتبع البث نموذج أحداث Responses API، من response.created حتى response.completed، مع وصول دلتا الاستدلال (response.reasoning_text.delta) كأحداث منفصلة عن نص الإخراج. لا يوجد مُنهي data: [DONE]؛ ينتهي البث بحدث response.completed، أو response.incomplete، أو response.failed. إذا كان مُعالج أحداث SSE الخاص بك ينتظر [DONE]، فسيتوقف. يغطي دليلنا حول بث استجابات API باستخدام أحداث المرسلة من الخادم أنماط التحليل الدفاعي لمثل هذا الاختلاف في اللهجة بالتحديد.

إعداد Codex مع DeepSeek-V4-Flash

يتفاعل Codex مع النماذج عبر Responses API، وهو السبب الرئيسي لوجود هذا الإصدار. يقدم دليل التكامل الخاص بـ DeepSeek مسارين، وكلاهما يقوم بتكوين كل عميل Codex في وقت واحد (واجهة سطر الأوامر (CLI)، تطبيق ChatGPT لسطح المكتب، وإضافة VS Code)، نظرًا لأنهم يتشاركون في تكوين واحد.

البرنامج النصي بنقرة واحدة

تأكد من تثبيت Codex CLI أو تطبيق ChatGPT لسطح المكتب وتشغيله مرة واحدة على الأقل، ثم:

bash <(curl -fsSL https://cdn.deepseek.com/api-docs/codex-deepseek-setup-en.sh)

يقوم مستخدمو Windows بتشغيل نسخة PowerShell:

irm https://cdn.deepseek.com/api-docs/codex-deepseek-setup-en.ps1 | iex

يطلب البرنامج النصي مفتاح API الخاص بك لـ DeepSeek عند التشغيل الأول، ثم يقوم بأربعة أمور: ينشئ نسخة احتياطية من ملف ~/.codex/config.toml الحالي إلى ~/.codex/backup-deepseek/، ويكتب كتالوج نموذج إلى ~/.codex/models.json، ويضيف قسم [model_providers.deepseek] إلى تكوينك مع الحفاظ على خوادم MCP وإعدادات ثقة المشروع، ويتحقق من صحة بناء الجملة قبل كتابة أي شيء. قم بتشغيله مرة أخرى في أي وقت لتبديل النماذج أو استعادة إعداداتك الأصلية من القائمة.

ينطبق الحذر القياسي عند توجيه مخرج curl إلى bash: اقرأ البرنامج النصي أولاً إذا كانت هذه سياستك. يُعد سلوك النسخ الاحتياطي والتحقق علامة جيدة، لكنه لا يزال برنامجًا نصيًا لطرف ثالث يمس تكوين Codex الخاص بك.

ما يخبرك به كتالوج النموذج

يستحق ملف models.json الذي يكتبه البرنامج النصي القراءة، لأنه يوثق كيف تضع DeepSeek النموذج داخل Codex:

• نافذة السياق: 1,048,576 رمزًا (token)
• مستويات الاستدلال: low، high، و max، مع كون high هو الافتراضي
• مكالمات الأدوات المتوازية مدعومة
• يتطلب إصدار عميل Codex 0.144.0 أو أحدث

يصف الكتالوج V4-Flash بأنه "أحدث نموذج برمجة وكيل رائد"، ويعمل deepseek-v4-flash فقط اليوم. يتضمن الكتالوج بالفعل deepseek-v4-pro عندما يصل الدعم في أوائل أغسطس.

هل يصمد حقًا داخل Codex؟

تعتبر DeepSeek أن إعادة التدريب اللاحق في 0731 كان يستهدف تحديدًا عبء العمل هذا. أرقام الوكيل المنشورة: Terminal Bench 2.1 عند 82.7، Cybergym عند 76.7، Toolathlon تم التحقق منه عند 70.3، DeepSWE عند 54.4، وكلها أُفيد بأنها تتفوق على V4-Pro-Preview. تعامل مع هذه الأرقام على أنها أرقام موردين حتى تظهر نتائج مستقلة؛ فقد تم إنتاجها باستخدام أدوات DeepSeek الخاصة بأقصى جهد، واثنان من المعايير في الإعلان هما مجموعتا اختبار داخلية.

الاقتصاديات أصعب في الجدال بشأنها. بسعر 0.14 دولار لكل مليون رمز إدخال (فشل ذاكرة التخزين المؤقت) و 0.28 دولار لكل مليون إخراج، يكلف V4-Flash جزءًا صغيرًا من تكلفة النماذج التي يشغلها Codex عادةً، وتخفض نجاحات ذاكرة التخزين المؤقت تكلفة الإدخال إلى 0.0028 دولار. يكلف يوم من جلسات الوكيل الكثيفة أقل من القهوة التي تشربها خلاله. لجدول التكلفة الكامل، راجع قسم التسعير في دليلنا التجريبي. إذا كنت تقارن Codex نفسه بالبدائل، فإن مقارنتنا بين Claude Code و Codex CLI تغطي جانب الوكيل في المعادلة.

تحقق من نقطة النهاية قبل أن تثق بالوكيل

لا يمكن تصحيح الوكيل إلا بقدر واجهة برمجة التطبيقات التي يدعمها، وتستحق نقطة نهاية تجريبية عامة جديدة تمامًا اختبارًا قبل السماح لـ Codex بالعمل على مستودع حقيقي. هذه مهمة تستغرق خمس دقائق في Apidog:

1. أضف POST https://api.deepseek.com/responses كنقطة نهاية وخزّن مفتاحك في متغير بيئة.
2. أرسل حمولة (payload) responses.create بحد أدنى وتأكد من شكل عناصر الإخراج: عنصر reasoning يتبعه عنصر message.
3. قم بتشغيل stream: true وشاهد تسلسل الأحداث مباشرة. يعرض Apidog كل حدث SSE فور وصوله، مما يجعل من الواضح ما إذا كان عميلك يجب أن يستمع إلى response.output_text.delta أو ينتظر شيئًا لا يأتي أبدًا.
4. احفظ طلبًا مع أداة function مرفقة وتأكد من أن تنسيق إخراج function_call يتطابق مع ما يتوقعه مُعالجك.

عندما يتم إطلاق V4-Pro Responses في أغسطس، أعد تشغيل نفس الطلبات المحفوظة مقابل اسم النموذج الجديد وقارن السلوك. قم بتنزيل Apidog مجانًا واحتفظ بالمجموعة الكاملة في مشروع واحد.

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

ما هي نماذج DeepSeek التي تعمل مع Responses API؟ deepseek-v4-flash فقط اليوم. من المقرر دعم deepseek-v4-pro في أوائل أغسطس 2026.

هل أحتاج إلى SDK جديد؟ لا. يعمل SDK الرسمي لـ OpenAI؛ وجّه base_url إلى https://api.deepseek.com واستدعِ client.responses.create. توجد تفاصيل الإعداد في دليل النسخة التجريبية العامة لـ V4-Flash.

هل تعمل حالة المحادثات المتعددة كما في نسخة OpenAI؟ لا. تنفيذ DeepSeek عديم الحالة (stateless): لا يتم دعم previous_response_id، conversation، و store. أرسل السجل الكامل كعناصر إدخال في كل استدعاء.

هل يمكنني استخدام DeepSeek في Codex جنبًا إلى جنب مع حسابي في OpenAI؟ نعم. يضيف الإعداد DeepSeek كمزود نموذج؛ وتقوم قائمة البرنامج النصي بالتبديل بين النماذج، ويتم عمل نسخة احتياطية من تكوينك الأصلي حتى تتمكن من استعادته.

هل هذا هو نفسه توافق Anthropic API؟ ميزة منفصلة. تكشف DeepSeek أيضًا عن نقطة نهاية بتنسيق Anthropic على https://api.deepseek.com/anthropic، وهي الطريقة التي يعمل بها تكامل Claude Code. توجد نقطة نهاية Responses API لأدوات الوكيل بتنسيق OpenAI مثل Codex.

ماذا يشير هذا الإصدار حقًا

تتقارب جودة النماذج، لذا ينتقل التنافس إلى طبقة التكامل. نظرت DeepSeek إلى حيث يتواجد المطورون فعليًا، داخل وكلاء مثل Codex، وبنت البنية التحتية الدقيقة اللازمة لتكون واجهة خلفية جاهزة للاستخدام هناك، وصولًا إلى نشر المعلمات التي يتم تجاهلها بصمت. هذه الشفافية نادرة، وتجعل قصة التوافق موثوقة.

الخطوة واضحة وذكية: OpenAI تشحن الوكيل، وDeepSeek تقدم الرموز بجزء من السعر. ما إذا كان نموذج 0731 يتفوق حقًا على V4-Pro-Preview في قاعدة التعليمات البرمجية الخاصة بك هو أمر لا يمكن إلا لتقييماتك الخاصة الإجابة عليه. قم بتوصيله بـ Apidog، وقم بتشغيل مجموعة الاختبار الخاصة بك على كليهما، ودع النتائج، وليس جدول المقارنات المعيارية، تقرر.