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

عنوان URL الأساسي والمصادقة

تعمل واجهة برمجة التطبيقات (API) لدينا مع أي عميل متوافق مع OpenAI عن طريق تغيير عنوان URL الأساسي فقط وتوفير مفتاح API الخاص بك. نحن لا نوجه نماذج متعددة؛ نحن نستضيف نموذج لغة كبير واحد غير خاضع للرقابة مضبوط لحالات الاستخدام الخاصة بالبالغين والمبرمجين. تعتمد المصادقة على مفتاح API واحد لكل حساب، تتلقاه فوراً بعد التسجيل عبر Google أو البريد الإلكتروني. لا يوجد رقم هاتف مطلوب، ولا توجد رسوم اشتراك. لا يتم استخدام مدخلاتك في بيانات التدريب، مما يضمن الخصوصية أثناء دمج نقطة النهاية الخاصة بنا في قاعدة التعليمات البرمجية الحالية.

Copycurl https://api.deepseekapidocumentation.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Explain the difference between supervised fine-tuning and RLHF."}]
  }'

POST /v1/chat/completions: نقطة النهاية الأساسية

أرسل محادثاتك إلى نقطة النهاية الوحيدة لدينا للحصول على ردود النص-إلى-نص. لا تحتاج إلى إدارة توجيه النموذج أو القلق بشأن تأخير البوابة لأننا نخدم نقطة نهاية واحدة مُعدلة مباشرة. معرف النموذج هو uncensored، ويستجيب لمعلمات إكمال الدردشة القياسية. يلغي هذا النهج تعقيد الاختيار من بين مجموعة من النماذج. تحصل على سلوك قابل للتنبؤ دون ضوضة إصدارات العارض المتعددة.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.deepseekapidocumentation.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

GET /v1/models: تحقق من نموذجك غير الخاضع للرقابة

تأكد من اتصالك والنموذج النشط عن طريق النقر على نقطة نهاية النماذج. تُرجع هذه النقطة تكوين نموذج اللغة الكبير غير المقيد الخاص بنا، والمميز عن GPT أو Claude أو البائعين الآخرين. يمكنك التحقق من نافذة السياق وحدود الرموز مباشرة من هذه الاستجابة. إنها طريقة سريعة للتأكد من أن عميل SDK الخاص بك يشير إلى خوادمنا بشكل صحيح. استخدم هذا لتصحيح أخطاء الاتصال قبل إرسال حمولات كبيرة.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.deepseekapidocumentation.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

المعلمات: درجة الحرارة وTop P والبث

تحكم في الإبداع باستخدام temperature و top_p، أو مكن البث عبر أحداث الإرسال الخادم (SSE). يوفر البث تحديثات رموز في الوقت الفعلي، وهو أمر حاسم لبناء واجهات دردشة متجاوبة. يمكنك أيضاً تعيين seed للمخرجات الحتمية أو تحديد تسلسلات التوقف. تعيد واجهة برمجة التطبيقات الخاصة بنا استخدام الرموز في الشريحة الأخيرة من التدفق. تساعدك هذه الشفافية في تتبع التكاليف بدقة أثناء توليد النموذج للنص.

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

وضع JSON واستدعاء الوظائف

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

حدود المعدلات وعد الرموز

يدعم كل مفتاح 300 طلب في الدقيقة ويسمح بـ 8 طلبات متزامنة. تحتفظ نافذة السياق بـ 100,000 رمز إجمالاً، مع حد أقصى للإخراج يبلغ 16,000 رمز لكل طلب. إذا لم تضبط max_tokens, الحد الافتراضي هو 2,048 رمزًا. لا يمكن أن تتجاوز أجسام الطلبات 8 ميجابايت. هذه الحدود صارمة ولكن قابلة للتنبؤ، مما يساعدك على تصميم منطق إعادة المحاولة القوي دون إبطاء غير متوقع. لا تستهلك الأخطاء الرصيد، لذا يمكنك الاختبار بحرية.