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

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

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

تدفق المصادقة بسيط. تولد مفتاحاً من لوحة التحكم لدينا وتمرره كعنوان (header). تشير الأخطاء مثل 401 إلى مفتاح غير صالح، بينما يعني 402 أن رصيدك المسبق قد استنفد. يمكنك الشحن عبر USDT أو USDC في أي وقت، ولا ينتهي رصيدك. يضمن هذا النموذج المسبق أنك تدفع فقط مقابل التوكنات التي تستخدمها فعلياً، بدون رسوم خفية أو حدود للطبقات.

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

أرسل طلبك الأول إلى /v1/chat/completions نقطة النهاية باستخدام معرف النموذج uncensored. تتعامل نقطة النهاية هذه مع تفاعلات النص إدخالاً ومخرجاً بدون أي رقابة محتوى مدمجة. يمكنك التحكم في أسلوب الاستجابة باستخدام معلمات مثل temperature و top_p. يدعم النموذج نافذة سياق بحجم 100,000 رمز، مما يسمح بحفظ تاريخ محادثات واسع أو معالجة مستندات في طلب واحد. الحد الأقصى للمخرجات مقيد بـ 16,000 رمز لكل طلب، أو 2,048 إذا تركت الحد مفتوحاً.

• استخدام response_format مع json_object لمخرجات البيانات المُهيّأة.
• تعيين stream: true للتسليم الفوري للرموز.
• تمرير stop تسلسلات لإيقاف التوليد عند علامات محددة.

هذه نقطة النهاية هي جوهر واجهة API الخاصة بنا، ومصممة للمطورين الذين يحتاجون إلى مخرجات نموذج خام وغير مصفاة. لا تقدم التضمينات أو توليد الصور، مما يبقي الخدمة مركزة وفعالة من حيث التكلفة. تدفع $0.15 لكل مليون رمز مخصص (token) مدخل و $0.50 لكل مليون رمز مخصص مخرج. لا تستهلك الأخطاء رصيدك، لذا يمكنك الاختبار بحرية دون القلق بشأن ضياع الأموال.

استخدام الرموز والبث

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

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

استدعاء الوظائف ووضع JSON

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

يدعم استدعاء الوظائف استخدام أدوات متعددة في طلب واحد. يقرر النموذج الأداة المناسبة بناءً على سياق الإدخال. يُعد وضع JSON مفيدًا عندما تحتاج إلى هياكل بيانات متوقعة للمعالجة اللاحقة. تتوفر الميزتان بنفس السعر الأساسي البالغ $0.15 لكل مليون رمز إدخال. يجعل هذا المرونة واجهة برمجة التطبيقات (API) الخاصة بنا مناسبة للتطبيقات المعقدة التي تتطلب تنسيقًا دقيقًا للإخراج.

الحدود وأفضل الممارسات

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

تشمل أفضل الممارسات ضبط max_tokens حد للتحكم في التكاليف وتجنب التوليد اللانهائي. استخدم stop التسseqs لمنع النموذج من التمدد. راقب استهلاك رموزك عبر نقطة النهاية البث للبقاء ضمن رصيدك المدفوع مسبقًا. نظرًا لأن الرصيد لا ينتهي صلاحيته، يمكنك إضافته في أي وقت يناسبك. النموذج غير الخاضع للرقابة لا يرفض المحتوى البالغ القانوني، لكنه سيحجب المحتوى الجنسي الذي يتضمن قاصرين. ينطبق هذا الحد الصارم بغض النظر عن فئة حسابك.

أمثلة العملاء

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

cURL

Copycurl https://api.deepseekapidiscount.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Check server status for uptime reliability and latency metrics"}]
  }'

Python

Copyfrom openai import OpenAI

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