DeepSeek-V4-Flash API متاح الآن: كيفية استخدام الـ API الرسمي (دليل البيتا العامة)

أطلقت DeepSeek واجهة برمجة تطبيقات DeepSeek-V4-Flash الرسمية هذا الصباح. صدر الإعلان في 31 يوليو 2026، وتوضح ملاحظات الإصدار ثلاثة أمور: حصلت قدرات وكيل النموذج على ترقية جادة، وهو الآن يدعم تنسيق واجهة برمجة تطبيقات Responses الخاص بـ OpenAI بشكل أساسي، ويعمل مع Codex منذ اليوم الأول.

إذا كنت تستخدم deepseek-v4-flash منذ أبريل، فقد كنت تستخدم النسخة التجريبية. يرفع هذا الإصدار النموذج إلى نسخته الرسمية، DeepSeek-V4-Flash-0731، وتحصل على الترقية دون تغيير سطر واحد من التعليمات البرمجية. يبقى اسم النموذج كما هو.

يتناول هذا الدليل كل شيء: الحصول على مفتاح، إجراء أول مكالمة لك، تشغيل وضع التفكير وإيقافه، وكيف تبدو أسعار النسخة التجريبية العامة. إذا كنت جديدًا على مجموعة DeepSeek، ابدأ بقراءة ما هو DeepSeek V4؟ للحصول على نظرة عامة عن العائلة، ثم عد إلى هنا.

💡

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

زر

ما الذي تم إصداره بالفعل في 31 يوليو

وفقًا لسجل التغييرات الرسمي، يغطي الإصدار واجهة برمجة التطبيقات فقط. تطبيقات DeepSeek ونماذج الويب لم تتغير، وواجهة برمجة تطبيقات V4-Pro لم تتغير. إليك الملخص:

DeepSeek-V4-Flash-0731 هو الإصدار الرسمي لسلسلة V4-Flash، وهو الآن في مرحلة تجريبية عامة على واجهة برمجة التطبيقات.
نفس البنية والحجم مثل V4-Flash-Preview. تقول DeepSeek أن النموذج تم تدريبه مرة أخرى فقط، لذا فإن المكاسب تأتي من التدريب، وليس من شبكة أكبر.
قفزت معايير الوكيل لتتجاوز V4-Pro-Preview. أعلنت DeepSeek عن نتائج Terminal Bench 2.1 عند 82.7، وCybergym عند 76.7، وToolathlon المتحقق منها عند 70.3، وDeepSWE عند 54.4. هذه هي الأرقام المنشورة لـ DeepSeek نفسها، تم اختبارها بأقصى جهد باستخدام أدواتها الخاصة.
دعم واجهة برمجة تطبيقات Responses الأصلية والتكامل الرسمي مع Codex. نغطي كلاهما بالتفصيل في DeepSeek-V4-Flash يدعم الآن واجهة برمجة تطبيقات Responses وCodex.
الإصدار الرسمي لـ DeepSeek-V4-Pro "سيتبع قريبًا"، وفقًا لسجل التغييرات. من المتوقع دعم واجهة برمجة تطبيقات Responses وCodex لـ V4-Pro في أوائل أغسطس 2026.

ملاحظة صادقة: تأتي المطالبة الرئيسية بالمعيار ("تجاوز V4-Pro-Preview بكثير") من تقييم DeepSeek الخاص، واثنتان من المعايير المدرجة (DSBench-FullStack وDSBench-Hard) هي مجموعات اختبار داخلية. ستستغرق الأرقام المستقلة بضعة أيام لتظهر.

الخطوة 1: احصل على مفتاح API الخاص بك

توجه إلى منصة DeepSeek، قم بتسجيل الدخول، وأنشئ مفتاحًا من صفحة مفاتيح API. تبدأ المفاتيح بـ sk-. قم بتخزينه كمتغير بيئة بدلاً من ترميزه مباشرةً:

export DEEPSEEK_API_KEY="sk-your-key-here"

واجهة برمجة تطبيقات DeepSeek متوافقة مع تنسيقات واجهات برمجة تطبيقات OpenAI و Anthropic، لذا لا تحتاج إلى حزمة تطوير برمجيات خاصة بـ DeepSeek. هناك عنواني URL أساسيين مهمين:

التنسيق	عنوان URL الأساسي
متوافق مع OpenAI	`https://api.deepseek.com`
متوافق مع Anthropic	`https://api.deepseek.com/anthropic`

الخطوة 2: قم بإجراء مكالمتك الأولى

أسرع فحص للتأكد من الصحة هو باستخدام curl:

curl https://api.deepseek.com/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${DEEPSEEK_API_KEY}" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "Summarize what changed in DeepSeek-V4-Flash-0731."}
    ],
    "stream": false
  }'

نفس المكالمة عبر حزمة تطوير برمجيات OpenAI Python:

# pip3 install openai
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ.get("DEEPSEEK_API_KEY"),
    base_url="https://api.deepseek.com"
)

response = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Write a Python function that validates an email address."}
    ],
    stream=False
)

print(response.choices[0].message.content)

وعبر Node.js:

// npm install openai
import OpenAI from "openai";

const openai = new OpenAI({
  baseURL: "https://api.deepseek.com",
  apiKey: process.env.DEEPSEEK_API_KEY,
});

const completion = await openai.chat.completions.create({
  model: "deepseek-v4-flash",
  messages: [{ role: "user", content: "Hello!" }],
});

console.log(completion.choices[0].message.content);

نظرًا لأن اسم النموذج deepseek-v4-flash يشير الآن إلى إصدار 0731، فإن أي تكامل موجود قمت بإنشائه مقابل الإصدار التجريبي سيستخدم النموذج الجديد تلقائيًا. لا يوجد شيء لترحيله.

الخطوة 3: التحكم في وضع التفكير وجهد الاستدلال

يدعم V4-Flash كلاً من وضع عدم التفكير ووضع التفكير، والتفكير هو الوضع الافتراضي. يمكنك التحكم فيه باستخدام المعامل thinking، ويمكنك ضبط العمق باستخدام reasoning_effort:

response = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[{"role": "user", "content": "Plan a database migration from MySQL to Postgres."}],
    reasoning_effort="high",
    extra_body={"thinking": {"type": "enabled"}}
)

سلوكان يستحقان المعرفة قبل ضبط المعاملات:

لا يؤثر temperature وtop_p أثناء تشغيل وضع التفكير.
إكمال FIM (ملء الفراغ، لا يزال تجريبيًا) يعمل فقط في وضع عدم التفكير.

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

الخطوة 4: بث الاستجابة

اضبط stream: true وستعيد واجهة برمجة التطبيقات أحداثًا مرسلة من الخادم. إذا لم تقم بتصحيح حمولات SSE من قبل، فإن دليلنا حول بث استجابات نماذج اللغة الكبيرة باستخدام أحداث مرسلة من الخادم يغطي التنسيق بالتفصيل.

stream = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[{"role": "user", "content": "Explain connection pooling."}],
    stream=True
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

التسعير خلال النسخة التجريبية العامة

وفقًا لصفحة النماذج والتسعير الرسمية، يظل V4-Flash رخيصًا بشكل تنافسي:

العنصر	deepseek-v4-flash	deepseek-v4-pro
الإدخال، ذاكرة التخزين المؤقتة (لكل مليون رمز)	$0.0028	$0.003625
الإدخال، عدم وجود ذاكرة التخزين المؤقتة (لكل مليون رمز)	$0.14	$0.435
الإخراج (لكل مليون رمز)	$0.28	$0.87
طول السياق	1M tokens	1M tokens
الحد الأقصى للإخراج	384K	384K
حد التزامن	2,500	500

ثلاث ملاحظات حول التسعير:

تخزين السياق مؤقتًا تلقائي، وتكلفة الوصول إلى ذاكرة التخزين المؤقت أقل 50 مرة من عدم وجودها. تستفيد جلسات الوكيل طويلة الأمد التي تعيد استخدام موجه النظام بشكل كبير.
أعلنت DeepSeek عن سياسة أوقات الذروة/خارج الذروة: سيتم محاسبة الاستخدام في ساعات الذروة (09:00-12:00 و14:00-18:00 بتوقيت بكين) بسعر مضاعف للسعر العادي. اعتبارًا من 31 يوليو، تشير الوثائق إلى أن تاريخ السريان "يخضع للإعلان الرسمي"، لذلك لم يتم تفعيله بعد. راقب صفحة التسعير.
يخبر حد التزامن قصته الخاصة: 2500 طلب متزامن لـ Flash مقابل 500 لـ Pro. قامت DeepSeek ببناء هذا النموذج ليتم استخدامه بكثافة بواسطة أساطيل الوكلاء.

للحصول على صورة تكلفة أكمل عبر عائلة V4، بما في ذلك تاريخ خفض الأسعار الدائم لـ V4-Pro، راجع تحليل أسعار DeepSeek V4 API الخاص بنا.

اختبار وتصحيح أخطاء واجهة برمجة التطبيقات في Apidog

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

إنشاء مشروع وإضافة نقطة النهاية. أضف POST https://api.deepseek.com/chat/completions (أو استورد مواصفات متوافقة مع OpenAI لتصل جميع نقاط النهاية دفعة واحدة).
تخزين المفتاح كمتغير بيئة. ضع DEEPSEEK_API_KEY في بيئة Apidog وقم بالإشارة إليه في رأس التخويل (Authorization header) كـ Bearer {{DEEPSEEK_API_KEY}}. يصبح التبديل بين مفتاح الاختبار ومفتاح الإنتاج بنقرة زر.
الإرسال والفحص. بالنسبة للمكالمات المتدفقة، يعرض Apidog أحداث SSE فور وصولها، حتى تتمكن من مشاهدة محتوى الاستدلال ومحتوى الإجابة يمران كفروقات منفصلة بدلاً من التدقيق في جدار من سطور data: الخام.
حفظ المتغيرات كحالات اختبار. احتفظ بطلب واحد محفوظ مع تمكين وضع التفكير وآخر بدونه، ثم أعد تشغيلهما بعد كل تحديث للنموذج. عندما تُصدر DeepSeek الترقية الصامتة التالية لـ deepseek-v4-flash، ستعرف بنقرة واحدة ما إذا كانت موجهاتك لا تزال تعمل كما ينبغي.

حمّل Apidog مجانًا، سير العمل بأكمله المذكور أعلاه يعمل على الخطة المجانية.

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

هل أحتاج إلى تغيير الكود الخاص بي للحصول على النموذج الجديد؟ لا. اسم النموذج deepseek-v4-flash يقدم الآن DeepSeek-V4-Flash-0731. تتم ترقية التكاملات الحالية تلقائيًا.

هل هذا هو نفس النموذج المستخدم في تطبيق DeepSeek؟ لا. تحديث 31 يوليو يغطي واجهة برمجة التطبيقات فقط. تطبيقات ونماذج الويب لم تتغير.

ماذا حدث لـ deepseek-chat و deepseek-reasoner؟ كانت أسماء النماذج القديمة هذه مقررة للتوقف في 24 يوليو 2026. استخدم deepseek-v4-flash أو deepseek-v4-pro. يغطي دليلنا حول كيفية استخدام DeepSeek V4 API عملية الترحيل.

هل يمكنني استخدامه مجانًا؟ واجهة برمجة تطبيقات DeepSeek تعتمد على الدفع حسب الاستخدام ولا توجد طبقة مجانية دائمة، ولكن تسعير الوصول من ذاكرة التخزين المؤقت يجعل التجربة شبه مجانية في الممارسة. راجع كيفية استخدام DeepSeek V4 API مجانًا للحصول على الخيارات الحالية.

هل يعمل V4-Flash مع Codex و Responses API؟ نعم، كلاهما، وهو النموذج الوحيد من DeepSeek الذي يفعل ذلك حتى الآن. من المتوقع دعم V4-Pro في أوائل أغسطس 2026. الإعداد الكامل موجود في دليل Responses API و Codex الخاص بنا.

الخلاصة

DeepSeek-V4-Flash-0731 هو نوع هادئ من الإصدارات: نفس اسم النموذج، نفس الأسعار، نفس البنية، ومجموعة من درجات معايير الوكيل التي تتفوق الآن على V4-Pro-Preview الأكبر، على الأقل في اختبارات DeepSeek الخاصة. يشير دعم واجهة برمجة تطبيقات Responses وتكييف Codex إلى الهدف من هذا النموذج: أعباء عمل وكيل ذات تزامن عالٍ بأسعار تنافسية تتفوق على جميع المختبرات الغربية.

احصل على مفتاح، وجه حزمة تطوير برمجيات OpenAI الخاصة بك إلى https://api.deepseek.com، واختبر النموذج باستخدام مجموعة الاختبار الخاصة بك قبل الثقة بجدول المعايير. Apidog يجعل حلقة التحقق هذه سريعة: احفظ موجهاتك كحالات اختبار مرة واحدة، أعد تشغيلها مع كل تحديث للنموذج، ولن تتفاجأ أبدًا بترقية صامتة مرة أخرى.

زر