DEV Community

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

Posted on • Originally published at apidog.com

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

أطلقت DeepSeek واجهة برمجة التطبيقات الرسمية لـ DeepSeek-V4-Flash صباح اليوم. صدر الإعلان في 31 يوليو 2026، ويؤكد ثلاثة تغييرات رئيسية: ترقية كبيرة لقدرات الوكيل، ودعم أصلي لتنسيق OpenAI Responses API، وتكامل مع Codex منذ اليوم الأول.

جرّب Apidog اليوم

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

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

💡 بعد الحصول على المفتاح، اختبر نقاط النهاية قبل دمجها في تطبيقك. يتيح لك Apidog إرسال طلبات إلى DeepSeek API، وفحص استجابات SSE المتدفقة، وحفظ الطلبات الناجحة كاختبارات قابلة لإعادة الاستخدام.

ما الذي صدر في 31 يوليو؟

بحسب سجل التغييرات الرسمي، يغطي التحديث واجهة برمجة التطبيقات فقط. لم تتغير تطبيقات DeepSeek أو نماذج الويب أو واجهة V4-Pro API.

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

ملاحظة: الأرقام المعيارية المنشورة هي نتائج DeepSeek الخاصة، كما أن DSBench-FullStack وDSBench-Hard مجموعتا اختبار داخليتان. انتظر التقييمات المستقلة قبل اتخاذ قرارات إنتاجية مبنية على المعايير فقط.

نتائج DeepSeek-V4-Flash

الخطوة 1: أنشئ مفتاح API

انتقل إلى منصة DeepSeek، وسجّل الدخول، ثم أنشئ مفتاحًا من صفحة API Keys. تبدأ المفاتيح عادةً بـ sk-.

لا تضع المفتاح مباشرةً في الشيفرة. خزّنه كمتغير بيئة:

export DEEPSEEK_API_KEY="sk-your-key-here"
Enter fullscreen mode Exit fullscreen mode

تدعم DeepSeek تنسيقات OpenAI وAnthropic، لذلك يمكنك غالبًا استخدام SDK الموجود لديك.

التنسيق عنوان 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
  }'
Enter fullscreen mode Exit fullscreen mode

Python باستخدام OpenAI SDK 

# 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)
Enter fullscreen mode Exit fullscreen mode

Node.js باستخدام OpenAI SDK 

// 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);
Enter fullscreen mode Exit fullscreen mode

يشير الاسم 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"}}
)
Enter fullscreen mode Exit fullscreen mode

ضع هذه السلوكيات في الحسبان:

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

استخدم وضع عدم التفكير للمهام الحساسة للكمون، مثل الإكمال التلقائي. ولحلقات الوكلاء أو تصحيح الأخطاء المعقدة، فعّل التفكير وارفع reasoning_effort.

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

اضبط stream=True لاستقبال أحداث مرسلة من الخادم (SSE). إذا لم تتعامل مع SSE من قبل، راجع دليل بث استجابات نماذج اللغة الكبيرة باستخدام 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="")
Enter fullscreen mode Exit fullscreen mode

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

وفقًا لصفحة النماذج والتسعير الرسمية، تظل أسعار 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

نقاط عملية مهمة:

  1. تخزين السياق مؤقتًا تلقائي. تكلفة الوصول إلى ذاكرة التخزين المؤقت أقل 50 مرة من الإدخال دونها، لذلك تستفيد جلسات الوكلاء الطويلة التي تعيد استخدام موجه النظام.
  2. أعلنت DeepSeek سياسة تسعير لأوقات الذروة وخارجها. ستُحسب ساعات الذروة في بكين، من 09:00 إلى 12:00 ومن 14:00 إلى 18:00، بسعر مضاعف عند تفعيلها. حتى 31 يوليو، لم يكن تاريخ التطبيق محددًا نهائيًا.
  3. حد التزامن البالغ 2,500 طلب لـ Flash، مقابل 500 لـ Pro، يعكس استهداف النموذج لأحمال الوكلاء عالية التوازي.

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

اختبار API وتصحيح الأخطاء باستخدام Apidog

يكفي curl للاختبار الأولي، لكنه لا يكون عمليًا عند مقارنة التفكير مع عدم التفكير أو عند فحص استدعاءات الأدوات المتدفقة. يمكنك تنفيذ سير العمل التالي في Apidog:

اختبار DeepSeek API في Apidog

  1. أنشئ مشروعًا وأضف نقطة النهاية أضف طلبًا من النوع POST إلى: 
   https://api.deepseek.com/chat/completions
Enter fullscreen mode Exit fullscreen mode

يمكنك أيضًا استيراد مواصفات متوافقة مع OpenAI لإضافة نقاط النهاية دفعة واحدة.

  1. استخدم متغير بيئة للمفتاح أنشئ المتغير DEEPSEEK_API_KEY داخل بيئة Apidog، ثم أضفه إلى رأس التفويض: 
   Authorization: Bearer {{DEEPSEEK_API_KEY}}
Enter fullscreen mode Exit fullscreen mode

يسهّل ذلك التبديل بين مفاتيح الاختبار والإنتاج.

  1. أرسل الطلب وافحص البث

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

  2. احفظ الطلبات كاختبارات

    احفظ طلبًا مع التفكير مفعّلًا وآخر معطّلًا. أعد تشغيلهما بعد كل تحديث للنموذج للتحقق من استمرار عمل الموجهات كما تتوقع.

حمّل Apidog مجانًا؛ سير العمل السابق متاح ضمن الخطة المجانية.

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

هل أحتاج إلى تعديل الكود للحصول على النموذج الجديد؟

لا. اسم النموذج deepseek-v4-flash يقدّم الآن DeepSeek-V4-Flash-0731، وتُحدّث التكاملات الحالية تلقائيًا.

هل هذا هو النموذج نفسه المستخدم في تطبيق DeepSeek؟

لا. تحديث 31 يوليو يخص API فقط؛ لم تتغير تطبيقات DeepSeek ونماذج الويب.

ماذا حدث لـ deepseek-chat وdeepseek-reasoner؟

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

هل يمكن استخدامه مجانًا؟

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

هل يعمل V4-Flash مع Codex وResponses API؟

نعم، يدعم كليهما، وهو نموذج DeepSeek الوحيد الذي يدعمهما حاليًا. من المتوقع دعم V4-Pro في أوائل أغسطس 2026. راجع دليل Responses API وCodex.

الخلاصة

DeepSeek-V4-Flash-0731 إصدار هادئ من ناحية الترحيل: الاسم والبنية والأسعار نفسها، مع تحسينات معلنة في قدرات الوكيل. يدعم النموذج الآن Responses API وCodex، ويستهدف أحمال الوكلاء ذات التزامن العالي.

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

Top comments (0)