دليل استخدام واجهة برمجة تطبيقات DeepSeek API للمطورين

بدء العمل مع واجهة برمجة التطبيقات

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

تستخدم المصادقة تنسيق bearer token with مفاتيح تبدأ بالبادئة "sk-". عنوان URL الأساسي لجميع نقاط نهاية API هو https://api.deepseek.com/v1، متبعاً اتفاقيات RESTful. تشمل العناوين (headers) المطلوبة Authorization مع مفتاح API الخاص بك، وتحديد Content-Type كـ application/json. يتم تطبيق حدود المعدل لكل مفتاح بدلاً من كل حساب، مما يسمح للفرق بتوزيع الحصص عبر مشاريع متعددة.

لتثبيت Python SDK، استخدم pip لإضافة مكتبة العميل الرسمية. يوضح الكود التالي سير عمل الطلب الأول بالكامل باستخدام نقطة نهاية إكمال الدردشة مع نموذج DeepSeek V3:

pip install deepseek-sdk

from deepseek import DeepSeek

client = DeepSeek(api_key="sk-your-api-key-here")

response = client.chat.completions.create(
    model="deepseek-chat-v3",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Explain quantum computing in simple terms."}
    ],
    max_tokens=500,
    temperature=0.7
)

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

بالنسبة للمطورين الذين يفضلون استخدام curl، يتطلب طلب HTTP المكافئ تكويناً صريحاً للعناوين. يعمل هذا النهج لاختبار الواجهة دون الاعتماد على أدوات SDK:

curl https://api.deepseek.com/v1/chat/completions \
  -H "Authorization: Bearer sk-your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-chat-v3",
    "messages": [{"role": "user", "content": "Hello, API!"}],
    "max_tokens": 100
  }'

تعيد واجهة برمجة التطبيقات استجابات JSON تحتوي على النص المولد، وإحصائيات استخدام التوكن، والبيانات الوصفية للطلب. تتضمن الاستجابات الناجحة مصفوفة choices مع مخرجات النموذج، بينما تعيد الأخطاء أكواداً قياسية لتصحيح الأخطاء. تظهر أعداد التوكن في كائن usage، الذي يتتبع prompt_tokens و completion_tokens وإجمالي التوكن لضمان دقة الفواتير.

• احصل على إعدادات مفتاح API من تبويب الأمان في لوحة تحكم المطور.
• ثبت مكتبة Python SDK أو استخدم طلبات HTTP المباشرة لمرونة أكبر.
• اختبر الاتصال باستخدام عملية إكمال دردشة بسيطة قبل البدء في التكامل الفعلي.
• راقب عناوين الاستجابة لمعرفة حالة حدود المعدل والحصة المتبقية من الاستخدام.