دليل الدمج للمطورين

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

ابدأ بتوجيه عميلك إلى عنوان URL الأساسي الخاص بنا وتزويد مفتاح API الخاص بك في رأس المصادقة. هذا يعمل مع أي SDK متوافق مع OpenAI لأننا نلتزم بالبروتوكول القياسي تمامًا. أنشئ مفتاحك فورًا عبر Google أو البريد الإلكتروني في صفحة الحصول على مفتاح API؛ لا يلزم رقم هاتف. احفظ مفتاحك بأمان واستخدم مفتاحًا نشطًا واحدًا لكل حساب، لأن إنشاء مفتاح جديد يستبدل القديم.

المصادقة بسيطة. أرسل مفتاحك في Authorization الرأس لكل طلب. يتحقق نظامنا من صحة المفتاح قبل معالجة الرموز، مما يضمن استهلاك الرصيد فقط من قبل الحسابات المصرح لها. ترجع الأخطاء مثل المفتاح المفقود حالة 401 فوراً.

الطلب الأول

أرسل طلب إكمال الدردشة القياسي لاختبار الاتصال وجودة الاستجابة. يتحقق هذا الاتصال البسيط من صحة المفتاح وائتمان حسابك بشكل صحيح. معرف النموذج هو uncensored, والذي يتناول إدخال وإخراج النص دون رفض المحتوى للاستخدام القانوني للبالغين. استبدل الحيز المؤقت بمفتاحك الفعلي ورسالة النظام.

Copycurl https://api.deepseekapicost.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "calculate total monthly cost for 1 million tokens"}]
  }'

يوضح أمر curl هذا الهيكل الأدنى المطلوب. يمكنك تعديل messages مصفوفة لتضمين السياق أو التعليمات. تُعيد الاستجابة النص المُولّد في content الحقل. تحقق من إحصائيات الاستخدام في رؤوس الاستجابة لمراقبة استهلاكك للرموز.

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

استخدم مكتبة بايثون الرسمية الخاصة بـ OpenAI لدمج واجهة برمجة التطبيقات الخاصة بنا في سكريبتاتك أو تطبيقاتك. قم بتعيين base_url و api_key السمات قبل إجراء المكالمات. هذا النهج يضمن التوافق مع قواعد الشفرة الموجودة التي تستخدم بالفعل نماذج OpenAI. يمكنك التبديل بين المزودين بتغيير سطرين فقط من التكوين.

Copyfrom openai import OpenAI

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

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

Node SDK

دمج واجهة برمجة التطبيقات الخاصة بنا في تطبيقات Node.js باستخدام openai npm package. Configure the client with our base URL and your API key just like you would for OpenAI. This allows you to use the same code structure for both testing and production. The SDK supports asynchronous operations for non-blocking requests.

Copyimport OpenAI from "openai";

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

يوضح هذا المثال بلغة Node.js كيفية إرسال طلب إكمال الدردشة. الـ await تضمن الكلمة الرئيسية استلام الاستجابة بالكامل قبل المضي قدماً. يمكنك معالجة الأخطاء باستخدام كتل try-catch لإدارة مشكلات الشبكة أو حدود واجهة برمجة التطبيقات بسلاسة. يحتوي كائن الاستجابة على النص المولد وتفاصيل استخدام الرموز.

التدفق

تمكين التدفق لتلقي استجابات رمزًا تلو الآخر لتجربة مستخدم أفضل في واجهات الدردشة. اضبط stream parameter إلى true في طلبك. تُعيد الـ API قطعًا من النص كما يتم إنشاؤها، مما يتيح لك عرض المخرجات في الوقت الفعلي. يقلل هذا من زمن الاستجابة المُدرَك للمستخدمين النهائيين بشكل كبير.

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)

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

حدود، أخطاء، ونافذة السياق

تفرض واجهة برمجة التطبيقات (API) لدينا حدودًا صارمة لضمان الاستخدام العادل واستقرار النظام. يُسمح لك بـ 300 طلبًا في الدقيقة و8 طلبات متزامنة لكل مفتاح. يجب ألا يتجاوز حجم كل طلب للجسم 8 ميجابايت. إذا تجاوزت هذه الحدود، تُرجع واجهة برمجة التطبيقات رمز حالة 429. انتظر بضع ثوانٍ وأعد محاولة طلبك. تُرجع الأخطاء مثل المفاتيح غير الصالحة 401، وعدم كفاية الرصيد 402.

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