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

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

ابدأ بتوجيه عميلك إلى عنوان URL الأساسي الخاص بنا واستخدام رمز حامل. نقطة النهاية هي https://api.howmuchisdeepseekapi.com/v1. تسترد مفتاحك بالنقر على 'Get API key' في صفحة التسجيل، حيث يمكنك تسجيل الدخول باستخدام Google أو استخدام بريد إلكتروني وكلمة مرور. لا يلزم رقم هاتف، ويظهر المفتاح على الفور. تحتاج فقط إلى مفتاح نشط واحد لكل حساب؛ فإن إنشاء مفتاح جديد يحل محل القديم.

المصادقة قياسية. مرر المفتاح في Authorization الرأس. يعمل هذا الإعداد مع عملاء Python أو JS الرسميين لـ OpenAI. تقوم ببساطة بتكوين عنوان URL الأساسي ومفتاح API في كائن العميل. يضمن ذلك تشغيل الكود الحالي الخاص بك دون إعادة هيكلة كبيرة.

Copycurl https://api.howmuchisdeepseekapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the current pricing for the deepseek api endpoint"}]
  }'

نقطة نهاية إكمال الدردشة (/v1/chat/completions)

أرسل تلميحاتك إلى نقطة إكمال الدردشة. هنا يتحول النص المدخل إلى نص مخرج. معرّف النموذج الذي يجب عليك استخدامه هو uncensored. إنه نموذج مفتوح المصدر مُعدّل للإجابة دون رفض المحتوى للاستخدام القانوني للبالغين. إنه ليس GPT أو Claude أو DeepSeek. أرسل رسائلك كمصفوفة من كائنات الدور والمحتوى.

تتوقع واجهة برمجة التطبيقات هياكل JSON قياسية. يمكنك تضمين أدوار النظام والمستخدم والمساعد. ستحتوي الاستجابة على رد النموذج. تعيد الأخطاء مثل نفاد الرصيد رمز الحالة 402. تعيد المفاتيح غير الصالحة خطأ 401. تساعد هذه الرموز القياسية في التعامل مع الفشل بسلاسة في منطق التطبيق الخاص بك.

Copyfrom openai import OpenAI

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

نقطة نهاية سرد النماذج (/v1/models)

استعلم عن نقطة نهاية النماذج للتحقق من الاتصال. أرسل طلب GET إلى /v1/models. تذكر الاستجابة قائمة بالنماذج المتاحة. سترى uncensored معرف النموذج المذكور هنا. يؤكد ذلك أن المصادقة الخاصة بك تعمل بشكل صحيح.

هذه نقطة النهاية مفيدة لتصحيح الأخطاء. إذا حصلت على خطأ 404 أو 500، فقد يكون عنوان URL الأساسي الخاص بك خاطئًا. استخدم هذا الاستدعاء للتأكد من أن عميلك يمكنه الوصول إلى خوادمنا قبل إرسال حمولات ثقيلة. تُرجع كائن قائمة بسيطًا يحتوي على تفاصيل النموذج.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.howmuchisdeepseekapi.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). تحتوي كل شريحة على نص جزئي. تتضمن الشريحة الأخيرة إحصائيات استخدام الرموز المميزة. يتيح لك ذلك عرض النص للمستخدمين في الوقت الفعلي.

يعد عدّ الرموز التعبيرية حاسمًا للفوترة. تدفع $0.15 مقابل كل 1M رمز تعبيري للإدخال و$0.50 مقابل كل 1M رمز تعبيري للإخراج. الأخطاء مجانية. تساعد بيانات الاستخدام في الجزء الأخير على تتبع التكاليف بدقة. يمكنك أيضًا تعيين max_tokens لتحديد المخرجات. إذا لم يُضبط، فإن الحد الأقصى هو 2,048 رمزاً.

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 عن طريق ضبط response_format إلى {"type": "json_object"}. يضمن ذلك أن يكون المخرج بيانات JSON صالحة.

معاملات مثل temperature و top_p التحكم في العشوائية. استخدم stop تسلسلات لإيقاف التوليد. يمكنك أيضاً ضبط presence_penalty و frequency_penalty لتقليل التكرار. تمنحك هذه الأدوات تحكمًا دقيقًا في سلوك النموذج.

المعلمات: درجة الحرارة وTop-p وتسلسلات التوقف

تعديل temperature للإبداع. تنتج القيم الأعلى مخرجات أكثر تنوعاً. اضبط top_p للتحكم في أخذ العينات النواة. استخدم stop التسseqs لإنهاء التوليد عند سلاسل محددة. تساعدك هذه المعلمات على ضبط النموذج لحالة الاستخدام الخاصة بك.

يمكنك أيضاً تعيين seed لإخراج حتمي. هذا مفيد لأغراض التصحيح. نافذة السياق هي 100,000 رمز للسياق والإكمال معاً. الحد الأقصى للإخراج هو 16,000 رمز لكل طلب. هذا يسمح بمحادثات طويلة دون فقدان السياق.