دليل مستخدم DeepSeek V4 API

1. التسجيل والمصادقة

تتوافق DeepSeek V4 API مع OpenAI SDK، مما يقلل بشكل كبير من تكاليف الترحيل ويسمح للمطورين بالتكامل بسلاسة مع أدوات نظام الذكاء الاصطناعي البيئي الحالية.

الحصول على مفتاح API

1. قم بزيارة منصة DeepSeek.
2. انقر فوق "API Keys" -> "Create new secret key" في الزاوية العلوية اليمنى.
3. ملاحظة: يتم عرض المفتاح مرة واحدة فقط عند الإنشاء، لذا احفظه بأمان.

2. البدء السريع (مثال Python)

أولاً، قم بتثبيت OpenAI SDK الرسمي (نعم، لقد قرأت ذلك بشكل صحيح، فقط استخدم OpenAI SDK):

pip install openai

ثم، قم ببساطة بتعديل معلمتين: base_url و api_key.

from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxxxxx",  # مفتاح DeepSeek API الخاص بك
    base_url="https://api.deepseek.com"  # نقطة رئيسية!
)

response = client.chat.completions.create(
    model="deepseek-v4",  # اسم النموذج، قد يختلف بعد إصدار V4
    messages=[
        {"role": "system", "content": "أنت مساعد ذكاء اصطناعي مفيد."},
        {"role": "user", "content": "مرحبًا، يرجى تقديم DeepSeek V4."},
    ],
    stream=False
)

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

3. الميزات المتقدمة

3.1 إخراج التدفق (Streaming)

لتحسين تجربة المستخدم، يوصى بتمكين إخراج التدفق، مما يسمح للمستخدمين برؤية تأثير إنشاء يشبه الآلة الكاتبة.

stream = client.chat.completions.create(
    model="deepseek-v4",
    messages=[{"role": "user", "content": "اكتب قصيدة طويلة عن الحيتان"}],
    stream=True,
)

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

3.2 استدعاء الوظيفة (Function Calling)

يدعم DeepSeek V4 استدعاء الوظائف القوي، القادر على تحليل معلمات JSON بدقة، مما يجعله مثاليًا لبناء الوكلاء (Agents).

3.3 وضع JSON

إذا كنت بحاجة إلى أن يخرج النموذج تنسيق JSON صالحًا، فتأكد من تحديد json_object في response_format واطلب صراحة إخراج JSON في الموجه.

4. التسعير وتحسين التكلفة

تسعير DeepSeek V4 ميسور التكلفة للغاية (الأسعار المحددة في انتظار الإعلان الرسمي، مرجع V3 بسعر 0.14 دولار/مليون رمز). لتوفير المزيد من المال:

• تخزين الموجه مؤقتًا (Prompt Caching): يقدم V4 آلية تخزين مؤقت للسياق. إذا كان موجه النظام الخاص بك طويلاً (على سبيل المثال، قاعدة المعرفة)، فستكون تكلفة الطلبات اللاحقة أقل بكثير بسبب إصابات ذاكرة التخزين المؤقت.
• تبسيط السياق: لا تحشو سجل دردشة غير ذي صلة فيه.

5. أفضل الممارسات

• معالجة الأخطاء: تأكد من تنفيذ try-except، خاصة لأخطاء rate_limit_exceeded (429)، مع استراتيجية إعادة المحاولة للتراجع الأسي.
• إعدادات المهلة: قد تتطلب مهام الاستدلال المعقدة أوقات إنشاء أطول، لذا قم بتعيين المهلة إلى 60 ثانية أو أكثر.
• موجه النظام: امنح V4 "شخصية" واضحة وسيكون أداؤه أفضل.

هل تواجه مشاكل؟ تحقق من وثائق API الخاصة بنا أو انضم إلى مجتمع Discord للحصول على المساعدة.