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

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

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

نقطة نهاية إكمال الدردشة

أرسل حمولات JSON القياسية إلى POST /v1/chat/completions لتلقي استجابات نصية. يقبل الرابط معرف النموذج الخاص بك كـ uncensored ويدعم معلمات مثل temperature و top_p. يمكنك تكوين نافذة سياق مكونة من 100,000 رمز لكل من الطلب والإكمال. تأكد من أن جسم الطلب يبقى تحت 8 ميجابايت لتجنب الحذف أو الرفض.

Copycurl https://api.deepseekuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the capital of France?"}]
  }'

استجابات البث (SSE)

فعّل إخراج الرمز الفوري عن طريق تعيين stream: true في طلبك. يعيد الخادم أحداث خادم المراسلة (SSE) التي يمكنك تحليلها تدريجيًا. تظهر إحصائيات استخدام الرموز في الجزء الأخير من التدفق. يقلل هذا الأسلوب من زمن الاستجابة المُدرَك لمهام توليد المحتوى طويل المدى.

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

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

Copyfrom openai import OpenAI

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

حدود معدل الطلبات والحصص

يدعم كل مفتاح API 300 طلب في الدقيقة، مع حد تزامن يبلغ ثمانية طلبات متزامنة. إذا تجاوزت هذه الحدود، يعيد الخادم خطأ 429. يمكنك مراقبة استخدامك وإضافة رصيد إلى حسابك عبر لوحة التحكم. لا تنتهي صلاحية الرصيد المدفوع مسبقاً، لذا يمكنك إيقاف الاستخدام دون فقدان الأموال.

معالجة الأخطاء

تعامل مع أخطاء HTTP القياسية مثل 401 للمفاتيح غير الصالحة و402 عندما يكون رصيدك غير كافٍ. يشير رمز 429 إلى أنك وصلت إلى حد المعدل. الأخطاء لا تستهلك رصيدك المدفوع مسبقًا، لذا فإن الطلبات الفاشلة مجانية. تحقق دائمًا من جسم الاستجابة للحصول على رسائل خطأ مفصلة لتصحيح مشاكل الحمولة بسرعة.

Copyimport OpenAI from "openai";

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