البدء السريع لمستخدمي DeepSeek

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

تستضيف واجهة برمجة التطبيقات الخاصة بنا على https://api.deepseekapikey.com/v1. للمصادقة، قم بتضمين مفتاح API الخاص بك في رأس Authorization كرمز Bearer. يمكنك إنشاء مفتاح على صفحة الحصول على مفتاح API باستخدام البريد الإلكتروني وكلمة المرور فقط. إذا فقدت مفتاحك، يمكنك تجديده في أي وقت، مما يلغي سريان المفتاح السابق على الفور. على عكس بعض البائعين، لا نطلب بطاقة ائتمان للحساب التجريبي الأولي.

الطلب الأول

أرسل طلب POST قياسي إلى /v1/chat/completions. استخدم معرف النموذج uncensored للوصول إلى نموذجنا مفتوح الأوزان. يتبع جسم الطلب الهيكل القياسي مع مصفوفة messages تحتوي على الموجّه الخاص بك. تدعم نقطة النهاية إدخال النص وإخراج النص، مما يجعلها بديلاً جاهزًا للعديد من التكاملات الحالية.

Copycurl https://api.deepseekapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

دمج SDK لـ Python

إذا كنت تستخدم عميل Python الرسمي لـ OpenAI، يمكنك توجيهه إلى عنوان URL الأساسي الخاص بنا عن طريق تجاوز معلمة base_url. مرر مفتاحك إلى تهيئة العميل. يتيح لك هذا النهج الحفاظ على بنية كود Python الحالي مع توجيه الطلبات عبر نقطة النهاية بدون رقابة. يتعامل العميل مع تسلسل JSON وتحليل الاستجابة تلقائيًا.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.deepseekapikey.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)

دمج SDK لـ Node.js

لتطبيقات Node.js، قم بتهيئة عميل OpenAI بنفس استراتيجية التكوين. اضبط baseURL على نقطة نهاية واجهة برمجة التطبيقات الخاصة بنا وقم بتوفير مفتاحك. يضمن ذلك توجيه جميع المكالمات اللاحقة، بما في ذلك استخدام الأداة، بشكل صحيح إلى خوادمنا. تعمل هذه الطريقة مع أي SDK متوافق مع OpenAI يحترم تجاوز baseURL.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.deepseekapikey.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);

الاستجابات المتدفقة

تمكين البث المتدفق عن طريق تعيين stream: true في حمولة الطلب الخاص بك. تُرجع واجهة برمجة التطبيقات دفق أحداث المخدم (SSE)، مما يتيح لك استقبال الرموز بمجرد إنشائها. هذا مثالي لواجهات المستخدم التي تستفيد من التغذية الراجعة في الوقت الفعلي. يتطابق تنسيق التدفق مع مواصفات SSE القياسية لـ OpenAI، لذا يجب أن تعمل معالجات التدفق الحالية دون تعديل.

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)

الحدود والأخطاء والسياق

تدعم نافذة السياق 100,000 رمز لكل من الموجّه والإكمال معًا. إذا تجاوزت حدّ المعدل البالغ 300 طلب في الدقيقة، فإن واجهة برمجة التطبيقات تُرجع خطأ 429. تُرجع فشل المصادقة حالة 401، بينما يؤدي عدم كفاية رصيد مسبق الدفع إلى خطأ 402. يمكنك التحقق من النماذج المتاحة عبر GET /v1/models، على الرغم من أن نقطة النهاية الأساسية مصممة لإكمال الدردشة. لا تُستخدم الموجّهات للتدريب، ويحجب النموذج المحتوى الجنسي الذي يتضمن قاصرين.