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


نقاط رئيسية
- توثّق DeepSeek API على غرار OpenAI، لذا يعمل SDK الخاص بـ OpenAI عن طريق تغيير عنوان URL الأساسي، والمفتاح، واسم النموذج.
- هذا الموقع ليس API الرسمي الخاص بـ DeepSeek؛ إنه يقدم نموذجًا واحدًا مستقلًا مفتوح الأوزان تحت المعرف uncensored.
- نفس الكود يعمل على كليهما: تتغير ثلاث قيم فقط.
- نافذة السياق هنا هي 100,000 رمز، مع دعم البث المتدفق، والأدوات، ووضع JSON.
الخمسة أشياء التي تجيب عليها وثائق DeepSeek API
عندما يبحث المطورون عن وثائق واجهة برمجة التطبيقات الخاصة بـ deepseek، فإنهم يحاولون عادةً إكمال طلب أولي. النمط هو نفسه لأي خدمة بأسلوب OpenAI، ولهذا السبب يجعل الجدول المقارنة سهلة.
| السؤال | وثائق DeepSeek | هذه واجهة برمجة التطبيقات (API) |
|---|---|---|
| عنوان URL الأساسي | مُوثَّقة في البدء السريع الخاص بهم (api.deepseek.com) | https://api.deepseek4api.com/v1 |
| المصادقة | رمز Bearer في رأس Authorization | رمز Bearer في رأس Authorization |
| اسم النموذج | مذكورة في وثائق النماذج الخاصة بهم؛ تحقق من الأسماء الحالية | uncensored |
| نقطة النهاية الرئيسية | إكمالات الدردشة | إكمالات الدردشة، الاستجابات، قائمة النماذج |
| الأسعار | تحقق من أسعارها الحالية | $0.15 / مليون رمز إدخال، $0.50 / مليون رمز إخراج |
اقرأ صفحات DeepSeek الخاصة بأي شيء يتعلق بنماذجهم وأسعارهم وحدودهم؛ فهي تتغير، ولا تحاول هذه المقالة إعادة صياغتها. النقطة هي أن شكل الطلب مشترك، لذا فإن الانتقال بين الاثنين هو تغيير في التكوين.
شيء واحد يجب أن يكون واضحًا فيه: هذا الموقع ليس API الرسمي الخاص بـ DeepSeek، وليس وسيطًا (router) لـ DeepSeek. إنه نقطة نهاية مستضافة ومتوافقة مع OpenAI تقدم نموذجًا واحدًا مفتوح الأوزان يعمل من قبل مزود مستقل ومضبط للإجابة بدون رفض المحتوى للاستخدام القانوني للبالغين.
الخطوة 1: المصادقة و Base URL
أنشئ حسابًا (Google، أو البريد الإلكتروني وكلمة المرور) وافتح صفحة مفتاح API. انسخ المفتاح. يمكن للمستخدمين الجدد أيضًا المطالبة برصيد تجريبي مجاني بقيمة $0.50 هناك بنقرة واحدة، صالح لمدة 7 أيام ولا يحتاج إلى بطاقة.
يحمل كل طلب الرأس Authorization: Bearer YOUR_KEY. مع curl:
curl https://api.deepseek4api.com/v1/models \
-H "Authorization: Bearer YOUR_KEY"
هذا يدرج النموذج المتاح، uncensored. إذا قمت بنسخ مثال من DeepSeek، استبدل ثلاثة أشياء: Base URL، المفتاح واسم النموذج. لا يحتاج أي شيء آخر إلى التغيير.
الخطوة 2: إكمال دردشة في Python
SDK الخاص بـ OpenAI هو ما تستخدمه وثائق DeepSeek في أمثلتها، ويعمل دون تغيير هنا:
from openai import OpenAI
client = OpenAI(
base_url="https://api.deepseek4api.com/v1",
api_key="YOUR_KEY",
)
resp = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You are a concise technical assistant."},
{"role": "user", "content": "Explain idempotency in two sentences."},
],
temperature=0.7,
)
print(resp.choices[0].message.content)
print(resp.usage)
معلمات أخذ العينات المدعومة، بما في ذلك temperature، top_p، stop، seed وعقوبات الحضور والتردد، يتم تمريرها. max_tokens اختياري لأن الإكمال يمكن أن يستخدم أي شيء يتبقى من نافذة الرموز 100,000.
الخطوة 3: البث المتدفق، وضع JSON والأدوات
البث المتدفق
قم بتعيين stream: true لتلقي أحداث SSE. يتم الإبلاغ عن الاستخدام في نهاية التدفق.
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.deepseek4api.com/v1",
apiKey: process.env.API_KEY,
});
const stream = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Write a haiku about caching." }],
stream: true,
});
for await (const chunk of stream) {
process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}
وضع JSON
مرر response_format: {"type": "json_object"} واذكر JSON في الموجّه الخاص بك. المخرج هو كائن JSON يمكنك تحليله مباشرة.
استدعاء الدوال
يعمل المعاملان tools و tool_choice بتنسيق OpenAI، وتعود مكالمات الأدوات في أجزاء (deltas)، وتعيد النتائج كرسائل مع role: "tool". إذا كان كودك يقوم بالفعل باستدعاء الدوال ضد DeepSeek، فيجب أن يتم نقله مع تغيير القيم الثلاث المذكور أعلاه، ولكن اختبر مخططاتك الخاصة.
أين يختلفان
نفس البروتوكول لا يعني نفس الخدمة. الأشياء التي يجب التحقق منها عند نقل عبء العمل:
- سلوك النموذج. يعطي نموذج مختلف إجابات مختلفة، ونمط استنتاج وسلوك رفض مختلف. أعد تشغيل مجموعة الموجّهات الخاصة بك قبل التبديل إلى أي شيء في بيئة الإنتاج.
- الحقول الخاصة بالاستدلال. إذا كنت تعتمد على حقول استجابة خاصة بالبائع من نموذج DeepSeek معين، فلا تفترض أنها موجودة هنا. حقول إكمال الدردشة القياسية موجودة.
- الميزات غير المقدمة. هذا API للنصوص فقط: لا صور، صوت، فيديو، تضمينات أو ضبط دقيق.
- الحدود. المفتاح الكامل يسمح بـ 8 طلبات متزامنة و300 في الدقيقة؛ المفتاح التجريبي يسمح بـ 2 و60. تجاوز الحد يعطيك HTTP 429 مع
rate_limitedأوconcurrency. - الرصيد. تحقق من الرصيد عبر
GET /v1/balance، مسار منح الرصيد على غرار OpenAI، أو رأسX-Balance-USDفي كل استجابة.
لمعرفة كيف يفكر مستخدم يركز على DeepSeek في التكلفة، انظر إلى ملاحظات تسعير DeepSeek؛ ولإعدادات المحرر، انظر دليل VS Code.
تكلفة الطلب هنا
الفوترة مسبقة الدفع ومبنية على الرموز: $0.15 لكل مليون رمز مدخل و $0.50 لكل مليون رمز مخرج. طلب يحتوي على 1,500 رمز مدخل و 600 رمز مخرج يكلف 1,500 × $0.15 / 1M = $0.000225 للمدخلات بالإضافة إلى 600 × $0.50 / 1M = $0.0003 للمخرجات، ليصبح المجموع $0.000525. شحن بقيمة $20 يغطي حوالي 38,000 طلب من هذا النوع.
تقبل عمليات الشحن أي مبلغ صحيح يتراوح بين $20 و$500، مع إضافة +5% من $50، و+10% من $100، و+15% من $200. يمكنك الدفع بالعملات المشفرة فقط (USDT على TRC20، USDC على Base). الرصيد لا ينتهي، ولا تُحاسَب الطلبات الفاشلة أو المرفوضة. التفاصيل في صفحة الأسعار.
قائمة مراجعة للانتقال
إذا كنت تنقل تطبيقاً يتواصل بالفعل مع DeepSeek، فاعمل على هذه الخطوات بالترتيب. كل خطوة تستغرق دقائق.
- ضع القيم الثلاث في الإعدادات. يجب أن تأتي Base URL والمفتاح واسم النموذج من متغيرات البيئة، وليس ثوابت مبعثرة في الكود.
- شغّل اختباراً سريعاً. إكمال دردشة واحد، إكمال متدفق واحد، طلب وضع JSON واحد وطلب استدعاء دالة واحد. الأربعة مقاطع البرمجية أعلاه تغطيها.
- أعد تشغيل الموجّهات الحقيقية. خذ 30 موجهاً من سجلاتك وقارن الإجابات جانباً إلى جانب. قيّمها وفقاً لمعاييرك الخاصة بدلاً من الدرجة العامة.
- عالج خطأ 429. أضف إعادة المحاولة مع تأخير متزايد واحترم رأس
Retry-After. الطلب المتدفق يحتفظ بمكانه في التوازي حتى ينتهي البث، لذا أغلق البث المتروك. - راقب التكلفة. سجل
usageمن كل استجابة وقارنها برأسX-Balance-USDعلى مدار يوم من حركة المرور. - أطلق النشر تدريجياً. أرسل 5 إلى 10 في المئة من حركة المرور إلى نقطة النهاية الجديدة أولاً، ثم زد النسبة.
قارن التكلفة لكل مهمة، وليس السعر لكل رمز (token)، لأن النماذج المختلفة تستخدم أعداداً مختلفة من الرموز لنفس المهمة. لإجراء فحص مفتوح حول سلوك نماذج الكتابة المنفتحة، يُعد دليل الكتابة مرافقاً مفيداً.
الاختيار بينهما
استخدم واجهة API الخاصة بـ DeepSeek عندما تحتاج تحديداً إلى نموذج DeepSeek أو ميزاته الخاصة من البائع أو دعمه الرسمي. استخدم نقطة النهاية هذه عندما تريد نموذجاً متوافقاً مع OpenAI مُستضافاً يجيب دون رفض المحتوى للاستخدام القانوني للبالغين، مع فواتير مسبقة الدفع بسيطة وموجّهات لا تُستخدم للتدريب. سيرغب العديد من الفرق في استخدام كليهما خلف مفتاح تكوين، وهو ما يسهله البروتوكول المشترك. توجد المواد المرجعية لهذه الواجهة في المستندات.
المزيد من الأدلة
أسئلة وأجوبة
هل هذه هي واجهة DeepSeek API الرسمية؟
لا. إنها نقطة نهاية مستقلة متوافقة مع OpenAI تخدم نموذج واحد مفتوح الأوزان تحت المعرف uncensored. إنها ليست خدمة DeepSeek ولا توجه الطلبات إليها.
هل يمكنني إعادة استخدام كود DeepSeek؟
إذا كان يستخدم SDK الخاص بـ OpenAI أو تنسيق إكمالات الدردشة، فغالباً نعم. غيّر Base URL والمفتاح واسم النموذج، ثم اختبر موجّهاتك.
أين أجد اسم النموذج؟
استدعِ GET /v1/models. تخدم هذه API نموذجاً واحداً فقط بالمعرف uncensored.
ما طول نافذة السياق؟
100,000 رمز (token) للموجّه بالإضافة إلى الإكمال.
رمز Bearer في رأس Authorization
أنشئ حساباً، وانسخ المفتاح، ثم غيّر URL الأساسي. هذه هي الإعدادات الكاملة.