عنوان URL الأساسي والمصادقة
ابدأ كل طلب بتوجيه عميلك إلى عنوان URL الأساسي الصحيح. استخدم المفتاح الذي حصلت عليه أثناء التسجيل لإدخاله في Authorization الرأس. يقوم هذا الرأس بمصادقة حسابك وتتبع استخدام رصيدك المدفوع مسبقًا.
تم بناء البنية التحتية للمطورين الذين يريدون وصولاً مباشرًا دون رسوم توجيه وسيطة. تحصل على أداء متسق لأننا ندير خوادمنا الخاصة.
الطلب الأول
أرسل أول رسالة للتحقق من الاتصال واستجابة النموذج. استخدم نقطة نهاية إكمال الدردشة القياسية مع موجه النظام واستعلام المستخدم. يؤكد هذا أن مفتاحك يعمل ويظهر لك استجابة JSON الخام.
- اضبط
modelfield إلىuncensored. - تضمين رسالة مستخدم بسيطة لاختبار زمن الاستجابة.
- تحقق من
usageكائن لعدد الرموز.
واجهة برمجة تطبيقات Python
دمج بسرعة باستخدام مكتبة Python الرسمية. قم بتثبيت الحزمة وتهيئة العميل بعنوان URL الأساسي والمفتاح الخاص بك. يتعامل هذا النهج مع التسلسل وإعادة المحاولة تلقائياً.
عرّف سجل محادثتك كقائمة من الكائنات (قواميس). مرر هذه مباشرة إلى نقطة نهاية الدردشة. تُعيد المكتبة كائن استجابة مُهيكلاً يمكنك تحليله لاستخراج نص المساعد.
Node SDK
أنشئ منطقًا من جانب الخادم باستخدام عميل Node.js. قم باستيراد المكتبة وقم بتكوين مفتاح API وعنوان URL الأساسي. يعمل هذا الإعداد جيدًا لخدمات الخلفية التي تعالج مدخلات المستخدمين بشكل غير متزامن.
استدعاء طريقة الإكمال مع الرسائل. تتضمن الاستجابة النص المُولّد وإحصائيات الاستخدام. تعامل مع الأخطاء بلطف لتجنب تعطل التطبيق أثناء الأحمال العالية.
استجابات البث
استلم الرموز (Tokens) في الوقت الفعلي لتجربة مستخدم أكثر سلاسة. فعّل البث عن طريق تعيين العلم المناسب في طلبك. يرسل الخادم كتل البيانات بمجرد توليدها.
تجميع هذه الأجزاء على جانب العميل لعرض النص تدريجياً. يقلل هذا من زمن الاستجابة المدرك بشكل كبير. راقب الجزء الأخير لمعرفة إجمالي استخدام الرموز وبيانات الفوترة.
حدود، أخطاء والسياق
احترم حدود معدل الطلبات لتجنب الانقطاعات. يُسمح لك بـ 300 طلب في الدقيقة و8 اتصالات متزامنة لكل مفتاح. إذا تجاوزت هذا الحد، ستتلقى خطأ 429.
يشير خطأ 401 إلى أن مفتاح API الخاص بك غير صالح. يشير خطأ 402 إلى عدم كفاية الرصيد المدفوع مسبقاً. نافذة السياق الخاصة بك هي 100,000 رمز إجمالي. احتفظ بطلبك واستجابتك ضمن هذا الحد لضمان أداء موثوق.
cURL
curl https://api.deepseekapiaccess.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Calculate the total latency for three sequential API calls."}]
}'Python
from openai import OpenAI
client = OpenAI(base_url="https://api.deepseekapiaccess.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.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.deepseekapiaccess.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 = 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)