DeepSeek V4 Flash مع Codex: دليل إعداد Responses API
أطلقت DeepSeek الاختبار العام لواجهة API الرسمية لـ DeepSeek-V4-Flash في 31 يوليو 2026. يحتفظ النموذج ببنية V4-Flash Preview وحجمه، لكنه تلقى post-training جديدا يركز على تنفيذ الوكلاء والبرمجة واستخدام الأدوات.
التغيير الأهم للمطورين هو الدعم الأصلي لواجهة OpenAI Responses API والتكامل المخصص مع Codex. تنص وثائق DeepSeek الحالية على أن deepseek-v4-flash هو نموذج DeepSeek الوحيد القابل للاتصال مباشرة بـ Codex. ومن المتوقع إضافة دعم V4 Pro في تحديث لاحق.
تتيح هذه البوابة deepseek-v4-flash عبر /v1/responses لاستخدامه مع Codex وغيره من عملاء الوكلاء المبنيين على بروتوكول Responses.
ما الذي تغير في DeepSeek-V4-Flash-0731؟
تقول DeepSeek إن DeepSeek-V4-Flash-0731 يستخدم بنية V4-Flash Preview وحجم النموذج نفسيهما. يغير إصدار 31 يوليو مرحلة post-training بدلا من البنية الأساسية. ولم تتم ترقية API الخاصة بـ V4 Pro أو نماذج تطبيق DeepSeek ونسخة الويب ضمن هذا الإصدار.
| العنصر | المعلومات الحالية |
|---|---|
| معرف النموذج في البوابة | deepseek-v4-flash |
| تاريخ الإصدار | 31 يوليو 2026 |
| حالة الإصدار | اختبار عام لواجهة API الرسمية |
| الترقية الرئيسية | تنفيذ الوكلاء والبرمجة واستخدام الأدوات |
| Responses API | مدعومة أصليا |
| Codex | تكامل رسمي مخصص |
| السياق | 1M في كتالوج البوابة |
| معامل البوابة | 2.5x |
| السعر المرجعي للبوابة | نحو 1 يوان صيني لكل مليون Token |
| إدخال الصور | مصنف حاليا على أنه غير مدعوم في كتالوج البوابة |
قد تتغير إتاحة النموذج والأسعار. أعد التحقق من صفحة أسعار النماذج ودليل النماذج المباشرين قبل الاستخدام في الإنتاج.
نتائج اختبارات الوكلاء الرسمية
نشرت DeepSeek النتائج التالية للإصدار الرسمي من V4 Flash:
| الاختبار | النتيجة الرسمية |
|---|---|
| Terminal Bench 2.1 | 82.7 |
| NL2Repo | 54.2 |
| Cybergym | 76.7 |
| DeepSWE | 54.4 |
| Toolathlon verified | 70.3 |
| Agent Last Exam | 25.2 |
| Automation Bench (Public) | 25.1 |
| DSBench-FullStack | 68.7 |
| DSBench-Hard | 59.6 |
توضح هذه النتائج اتجاه القدرات، ولا تضمن نسبة نجاح محددة في مستودعك. تذكر DeepSeek أن تقييمات Code Agent العامة استخدمت وضعا مبسطا غير منشور بعد من DeepSeek Harness، مع effort بمستوى max وtop_p=0.95 وtemperature=1.0. أما DSBench-FullStack وDSBench-Hard فهما مجموعتا اختبار داخليتان.
عند الشراء أو اختيار النموذج، اختبره على مستودعات وأدوات وصلاحيات واختبارات قبول مثبتة الإصدارات. قس نسبة الإكمال من المحاولة الأولى، وأعطال الأدوات، والوقت المستغرق، واستهلاك Tokens، وحجم إعادة العمل المطلوبة من المهندسين.
Responses API مقارنة بـ Chat Completions
تناسب Chat Completions المحادثة والكتابة والترجمة والتلخيص وأسئلة البرمجة البسيطة. ويتكون مسارها الأساسي من قائمة رسائل يتبعها نص مولد.
صممت Responses API للوكلاء والتنفيذ المتواصل للأدوات. يمكن أن تشمل المهمة خرج النموذج، واستدعاءات الدوال، وإجراءات الطرفية، ونتائج الأدوات، ثم استدلالا لاحقا. يستخدم Codex هذا البروتوكول الأغنى لفحص الشفرة وتعديل الملفات وتشغيل الاختبارات ومواصلة العمل بعد كل نتيجة.
| القدرة | Chat Completions | Responses API |
|---|---|---|
| المحادثة وتوليد النص | مناسبة | مدعومة |
| Structured tool calls | متاحة | Workflow أصلي |
| التنفيذ المستمر بأدوات متعددة | يديره العميل | أنسب |
| تكامل Codex | ليست بروتوكول Codex | مطلوبة |
| بنية أحداث الوكيل | أبسط | أغنى |
| مسارات العمل الهندسية الطويلة | تحتاج Orchestration إضافيا | حالة استخدام أساسية |
استخدم Chat Completions للتوليد البسيط وعالي الحجم. واستخدم /v1/responses عندما يتطلب العمل Codex أو MCP أو أدوات الطرفية أو تنفيذا هندسيا متعدد الخطوات.
استدعاء DeepSeek V4 Flash عبر Responses API
ابدأ بطلب صغير:
curl https://api.llm-token.cn/v1/responses \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-v4-flash",
"input": "Inspect this repository and propose the smallest fix for the failing tests."
}'
تحقق من Base URL وAPI key ومعرف النموذج وحالة HTTP وبنية أحداث الاستجابة قبل اختبار streaming أو function calls أو MCP أو السياق الطويل أو المهام الكثيفة في استخدام الطرفية.
لا تستبدل النموذج بنموذج DeepSeek آخر داخل Codex. توثق DeepSeek حاليا deepseek-v4-flash وحده على أنه متوافق مع Codex. قد تعيد معرفات النماذج الأخرى أخطاء في البروتوكول، أو تفشل في استدعاء الأدوات، أو تقطع المهام، أو تنتج بنى أحداث غير متوافقة.
الحدود بين Direct API وعميل Codex
واجهة Responses API المباشرة من DeepSeek عديمة الحالة حاليا. تنص الوثائق على عدم دعم previous_response_id وconversations وstorage وbackground mode. يدعم الخادم function tools وweb search وأداة apply_patch المخصصة التي يستخدمها Codex، لكنه يتجاهل الأدوات الأصلية mcp وfile_search وcode_interpreter وcomputer_use. كما أن إدخال الصور والملفات غير مدعوم.
يظل Codex قادرا على قراءة الملفات وتشغيل أوامر Shell لأن العميل ينسق هذه الأدوات محليا ويرسل نتائجها إلى النموذج. اختبر قدرات API الخاصة بالنموذج وقدرات الأدوات من جهة العميل بشكل منفصل، ولا تتعامل معهما على أنهما طبقة واحدة.
إعداد deepseek-v4-flash في Codex
ثبت Codex CLI أو حدثه:
npm install -g @openai/codex@latest
codex --version
أضف مزود Responses إلى ~/.codex/config.toml:
model_provider = "llm-token"
model = "deepseek-v4-flash"
model_reasoning_effort = "high"
[model_providers.llm-token]
name = "LLM Token"
base_url = "https://api.llm-token.cn/v1"
wire_api = "responses"
requires_openai_auth = true
مرر API key الخاص بالبوابة بطريقة المصادقة الآمنة التي يدعمها إصدار Codex لديك. لا تودع مفتاحا حقيقيا في Git، ولا تلصقه في الشفرة النموذجية، ولا تكشفه في السجلات.
ابدأ بمهمة للقراءة فقط:
Read the repository structure and list its build command, test command, and three main modules. Do not modify files.
لا تمنح صلاحيات كتابة الملفات وShell إلا بعد التأكد من عمل النموذج واستدعاءات الأدوات وإدارة السياق بشكل صحيح. راجع دليل إعداد Codex لتفاصيل التثبيت الكاملة.
أعباء العمل الموصى بها
- تحليل المستودعات وتشخيص الأخطاء والإصلاحات محددة النطاق
- تعديل الشفرة تكرارا بعد فشل الاختبارات
- أوامر الطرفية والبحث في الشفرة والمهام الهندسية متعددة الخطوات
- MCP servers وfunction calls وتنسيق الأدوات الخارجية
- الاختبارات الآلية ومراجعة الشفرة وتخطيط الترحيل
- أعباء تطوير حساسة للتكلفة مع حاجة إلى سلوك الوكلاء
DeepSeek V4 Flash ليس مجرد مسار محادثة منخفض التكلفة. تكمن قيمته الأساسية في إدخال معامل بوابة أقل إلى مسارات عمل Codex والوكلاء. ومع ذلك، تحتاج وكلاء الإنتاج إلى حدود صلاحيات، ومهل زمنية، وحدود لإعادة المحاولة، وميزانية Tokens، وشروط واضحة للتدخل البشري.
قائمة تحقق للاستخدام في الإنتاج
- انسخ معرف النموذج الدقيق
deepseek-v4-flashمن دليل النماذج. - استخدم
https://api.llm-token.cn/v1بصفته Base URL واضبط بروتوكول Codex علىresponses. - تحقق من الحالة وبنية الأحداث والنموذج المختار والفوترة بطلب قصير.
- استخدم مهمة مستودع للقراءة فقط لاختبار الوصول إلى الملفات والبحث والاحتفاظ بالسياق.
- اختبر Shell وpatch وfunction calls وMCP والتنفيذ متعدد جولات الأدوات كل على حدة.
- حدد حدودا صريحة للملفات وقواعد البيانات والمدفوعات وعمليات النشر والخوادم.
- ثبت المستودع وcommit البداية وdependencies وأوامر القبول عند مقارنة النماذج.
- سجل completion rate ومدة P50/P95 ومزيج الأعطال والتكلفة لكل مهمة مقبولة.
الأسئلة الشائعة
هل يدعم DeepSeek V4 Flash استخدام Codex؟
نعم. تؤكد DeepSeek أن الإصدار الرسمي من V4 Flash يدعم Responses API أصليا ومكيف للعمل مع Codex. وتوثق حاليا deepseek-v4-flash بصفته نموذج DeepSeek الوحيد المدعوم في Codex.
أي endpoint ينبغي أن يستخدمه Codex؟
استخدم /v1/responses وليس /v1/chat/completions. اضبط Base URL لهذه البوابة على https://api.llm-token.cn/v1 وأضف wire_api = "responses".
هل يمكن تشغيل DeepSeek V4 Pro في Codex؟
تنص وثائق DeepSeek على أن دعم V4 Pro في Codex متوقع في أوائل أغسطس 2026. لا تعتبره متوافقا حتى تؤكد API الرسمية ومسار البوابة ذلك.
ما تكلفة DeepSeek V4 Flash؟
يعرض كتالوج البوابة الحالي معاملا قدره 2.5x، أو نحو 1 يوان صيني لكل مليون Token. صفحة الأسعار المباشرة وسجل الحساب هما المرجعان المعتمدان.
هل Responses API أفضل دائما من Chat Completions؟
لا. Chat Completions أبسط للمحادثة والتوليد لمرة واحدة. تكون Responses أكثر فائدة مع Codex وMCP والأدوات ومسارات العمل الهندسية المتواصلة.
أين يمكنني شراء الوصول إلى API أو شحنه؟
يمكن للعملاء الجدد البدء من صفحة الشراء، ويمكن لحاملي API key الحاليين استخدام الشحن. ابدأ باختبارات صغيرة، للقراءة فقط، وقابلة للعكس.
المصادر الرئيسية
- سجل تغييرات DeepSeek بتاريخ 31 يوليو 2026: حالة الإصدار واختبارات الوكلاء وشروط التقييم وResponses API ودعم Codex
- دليل تكامل Codex من DeepSeek: النموذج المدعوم وحدود تكامل Codex
- دليل Responses API من DeepSeek: البروتوكول وإرشادات الطلب
- دليل نماذج البوابة: معرف المسار والمعامل والسياق وتسميات القدرات الحالية