توثيق واجهة برمجة التطبيقات

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

تواصل باستخدام مفتاح واجهة برمجة التطبيقات الخاص بك للوصول الفوري إلى نموذج الذكاء الاصطناعي المحرر من القيود. تتطلب جميع الطلبات رمز bearer صالح في رأس المصادقة. لا نفرض رسومًا على فشل المصادقة أو أخطاء توجيه النموذج.

استخدم عنوان URL الأساسي https://api.deepseekapiprices.com/v1 مع أي SDK قياسي من OpenAI. يمنحك مفتاحك الوصول إلى uncensored النموذج. لا يتطلب التسجيل رقم هاتف، ويُعرض المفتاح فوراً بعد إنشاء الحساب.

مثال على المصادقة

استبدل your-api-key مع المفتاح الفعلي الخاص بك. يتحقق الخادم من الرمز المميز قبل معالجة طلبك.

الطلب الأول

أرسل إكمال محادثة بسيط لاختبار الاتصال وجودة الاستجابة. تعيد نقطة النهاية النص في choices[0].message.content الحقل. ندعم استدعاء الوظائف ووضع JSON للمخرجات المهيكلة.

• معرف النموذج: uncensored
• نقطة النهاية: POST /v1/chat/completions
• الحد الأقصى للإخراج: 16,000 رمز مميز

يوضح الطلب أدناه طلباً أساسياً. تأكد من صحة مفتاح API الخاص بك لتجنب خطأ 401.

Copycurl https://api.deepseekapiprices.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Translate this technical documentation to German"}]
  }'

تحقق من أن هيكل الاستجابة يتطابق مع معيار OpenAI. هذا يضمن قدرتك على تغيير المزودين دون إعادة كتابة منطق تطبيقك.

تكامل واجهة برمجة تطبيقات Python

ثبّت الحزمة الرسمية من OpenAI وقم بتكوين عنوان URL الأساسي. يعمل هذا النهج مع القياسي openai مكتبة Python. تحتاج فقط إلى ضبط تكوين العميل.

• URL الأساسي: https://api.deepseekapiprices.com/v1
• مفتاح واجهة برمجة التطبيقات: يتم تعيينه عبر متغير البيئة أو المنشئ
• النموذج: uncensored

يوضح مقتطف الكود التالي الإعداد الأدنى. يتعامل مع الطلب ويطبع المحتوى. يتم رفع الأخطاء كاستثناءات OpenAI قياسية.

Copyfrom openai import OpenAI

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

هذه الطريقة مثالية لخدمات الخلفية والبرامج النصية. تحافظ على التوافق مع قواعد الشفرة الموجودة.

إعداد Node SDK

قم بتكوين عميل Node.js بعنوان URL الأساسي المخصص. هذا يسمح لك باستخدام القياسي openai حزمة. الإعداد مطابق لخدمات متوافقة مع OpenAI الأخرى.

• URL الأساسي: https://api.deepseekapiprices.com/v1
• الحزمة: openai (npm)
• النموذج: uncensored

استخدم الكود التالي لتهيئة العميل. يضمن توجيه جميع الطلبات بشكل صحيح. يمكنك بعد ذلك استدعاء chat.completions.create كما هو معتاد.

Copyimport OpenAI from "openai";

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

التعامل مع الأخطاء بشكل مناسب لإدارة حدود المعدل أو نقص الرصيد. يرمي حزمة SDK أخطاء قياسية لمشاكل API.

استخدام الرموز والبث

تمكين التدفق لتوصيل الرمز في الوقت الفعلي. اضبط stream: true في معاملات الطلب الخاص بك. تُعيد واجهة برمجة التطبيقات الشرائح بمجرد توليدها. تظهر تفاصيل استخدام الرموز في الشريحة الأخيرة.

• البث: مدعوم عبر SSE
• استخدام الرموز: يُقدّم في القطعة النهائية
• المعلمات: temperature, top_p, stop

تقليل معالجة التدفق من زمن الاستجابة المُدرَك للاستجابات الطويلة. إنه ضروري لواجهات الدردشة. يوضح المثال التالي إعداد التدفق.

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)

قم بتحليل الاستجابة المتدفقة لتحديث واجهة المستخدم تدريجيًا. يحسن هذا تجربة المستخدم بشكل كبير.

حدود المعدلات ونافذة السياق

احترم حد 300 طلب في الدقيقة لكل مفتاح. يمكنك إرسال 8 طلبات متزامنة في نفس الوقت. يجب ألا يتجاوز جسم الطلب 8 ميجابايت. الأخطاء والرفض مجانيان، لذا فإن حدود معدل الطلب تنطبق فقط على الطلبات الناجحة.

يدعم النموذج نافذة سياق تتكون من 100,000 رمز. يشمل هذا رموز التعليمات والتكميل معاً. استخدم هذا للمستندات الطويلة أو المحادثات الممتدة. يلخص الجدول التالي الحدود.

حد	القيمة
الطلبات في الدقيقة	300
الطلبات المتزامنة	8
حد حجم الطلب الأقصى	8 ميجابايت
نافذة السياق	100,000 رمز

تجاوز هذه الحدود يعيد خطأ 429. زد التزامن بحذر لتجنب التقييد.