توثيق API للمطورين

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

ابدأ بتغيير عنوان URL الأساسي إلى نقطة النهاية المخصصة لدينا وإرسال مفتاح API الخاص بك في رأس المصادقة. لا نستخدم عنوان URL الأساسي القياسي لـ OpenAI؛ يجب أن توجه مكتبة SDK الخاصة بك إلى https://api.deepseektokenplan.com/v1. يضمن ذلك توجيه طلباتك عبر بنية نموذجنا غير الخاضع للرقابة بدلاً من وسيط من طرف ثالث. معرّف النموذج الذي تحددّه في جسم الطلب هو "uncensored"، مما يُفعّل أوزونة الضبط الدقيق المحددة على خوادمنا. يعتمد المصادقة على مخطط رمز حامل بسيط يعمل مع أي مكتبة عميل متوافقة مع OpenAI. يتم إنشاء مفتاحك فوراً عند التسجيل عبر Google أو البريد الإلكتروني، دون الحاجة إلى رقم هاتف. احفظ هذا المفتاح بأمان، فهو مرتبط مباشرة برصيد الرصيد المدفوع مسبقاً.

الطلب الأول

أرسل طلب إكمال محادثات قياسي باستخدام cURL للتحقق من إعدادك وتوفر النموذج. يوضح هذا الطلب POST البسيط كيف تقبل واجهة برمجة التطبيقات مطالبة النظام الخاصة بك ورسالة المستخدم. يمكنك ضبط معلمات درجة الحرارة و top_p للتحكم في الإبداع. يعيد الاستجابة النص المُولّد مع إحصائيات استخدام الرموز المميزة للشفافية في الفوترة. تأكد من أن جسم الطلب الخاص بك يتضمن معرف النموذج الصحيح ومفتاح واجهة برمجة التطبيقات الخاص بك في الرأس. تعمل هذه الطريقة لكل من توليد النصوص وسيناريوهات استدعاء الوظائف. استخدم هذا الأمر لتأكيد الاتصال قبل الدمج في تطبيقك. تدعم نقطة النهاية كلًا من وضعي التدفق وغير التدفق بشكل متساوٍ.

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

استخدم مكتبة بايثون الرسمية الخاصة بـ OpenAI للتفاعل مع واجهة برمجة التطبيقات الخاصة بنا عن طريق تكوين عنوان URL الأساسي ومفتاح واجهة برمجة التطبيقات. قم بتهيئة العميل باستخدام بيانات الاعتماد الخاصة بك واستدعاء طريقة إكمال الدردشة مع معرف النموذج المطلوب. يتيح لك هذا النهج الاستفادة من قواعد الشفرة البرمجية الحالية التي تم بناؤها لـ OpenAI دون إعادة الهيكلة الكبيرة. يمكنك تدفق الاستجابات أو تلقي النص الكامل دفعة واحدة. تتولى المكتبة التسلسل التلقائي لـ JSON وطلبات HTTP تلقائيًا. قم بتكوين إعدادات المهلة وإعادة المحاولة حسب الحاجة لحالة الاستخدام المحددة الخاصة بك. يعد هذا الأسلوب مثاليًا لخدمات الخلفية وخطوط أنابيب معالجة البيانات. تأكد من تحديث عنوان URL الأساسي ليشير إلى نقطة النهاية المحددة الخاصة بنا.

تكامل Node SDK

دمج واجهة برمجة التطبيقات في تطبيقات JavaScript أو TypeScript الخاصة بك باستخدام حزمة OpenAI Node. اضبط عنوان URL الأساسي ومفتاح API في تكوين العميل قبل إجراء أي طلبات. يتيح لك هذا الإعداد استخدام الأساليب المألوفة مثل chat.completions.create() مع نموذجنا غير الخاضع للرقابة. يمكنك تمرير معلمات مثل درجة الحرارة وتسلسلات التوقف لضبط المخرجات. تتعامل الحزمة مع استجابات التدفق بكفاءة للتطبيقات في الوقت الفعلي. استخدم هذا النهج لخوادم الويب أو أدوات سطر الأوامر. تأكد من استيراد الوحدات اللازمة وتكوين متغيرات البيئة بشكل صحيح. تدعم هذه الطريقة كلًا من أنماط الطلبات المتزامنة وغير المتزامنة.

التدفق والرموز

تمكين التدفق لتلقي استجابات جزئية أثناء توليدها، مما يحسن تجربة المستخدم لواجهات الدردشة. تستخدم واجهة برمجة التطبيقات أحداث Server-Sent (SSE) لتوصيل الرموز في الوقت الفعلي. يمكنك تتبع استخدام الرمز في الكتلة الأخيرة من التدفق للفوترة الدقيقة. تدعم هذه الميزة جميع مكتبات SDK الرئيسية ويمكن تنفيذها يدويًا إذا لزم الأمر. يقلل التدفق من زمن الاستجابة المُدرَك للاستجابات الطويلة. اضبط stream معامل إلى true في جسم الطلب. تعيد واجهة برمجة التطبيقات إحصائيات الاستخدام في الحدث الأخير، مما يسمح لك بخصم المبلغ الصحيح من رصيدك المدفوع مسبقًا. هذه الطريقة أساسية للتطبيقات التي تتطلب تغذية راجعة فورية.

الحدود ومعالجة الأخطاء

راقب حدود المعدل وتعامل مع الأخطاء بسلاسة لضمان اتصال مستقر. تسمح واجهة البرمجة (API) بـ 300 طلب في الدقيقة لكل مفتاح و8 طلبات متزامنة. يجب ألا يتجاوز حجم كل طلب بيانات 8 ميجابايت. إذا أرسلت مفتاحاً غير صالح، فستحصل على خطأ 401 غير مصرح به. يشير خطأ 402 إلى عدم كفاية الرصيد المدفوع مسبقاً، مما يتطلب منك الشحن عبر العملات المشفرة. يعني خطأ 429 أنك تجاوزت حد المعدل؛ انتظر وأعد المحاولة. نافذة السياق هي 100,000 رمز للمطالبة والإكمال معاً. الحد الأقصى للإخراج هو 16,000 رمز ما لم تحدد أقل max_tokens القيمة. تحقق دائماً من رمز الحالة وجسم الاستجابة للحصول على رسائل خطأ مفصلة.

cURL

Copycurl https://api.deepseektokenplan.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 50 million tokens"}]
  }'

Python

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

التدفق

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)