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

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

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

الطلب الأول باستخدام curl

أرسل طلب POST إلى /v1/chat/completions باستخدام معرف النموذج المحدد uncensored. تقبل نقطة النهاية حمولات JSON القياسية وتُرجِج استجابات نصية. استخدم هذا الأمر للتحقق من مفتاحك ورؤية النموذج في العمل فورًا.

Copycurl https://api.deepseekabliterated.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list available model endpoints for local deployment"}]
  }'

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

تكامل مكتبة Python

ثبّت حزمة OpenAI لـ Python وقم بتكوين عنوان URL الأساسي ليشير إلى خدمتنا. يتيح لك ذلك استخدام الكود الموجود دون تعديلات. تتعامل مكتلة SDK مع المصادقة وتنسيق الطلبات تلقائيًا. مرر مفتاح API الخاص بك كمتغير بيئة أو مباشرة في تهيئة العميل. يعمل هذا النهج مع أي عميل متوافق مع OpenAI، وليس فقط مع مكتبة SDK الرسمية. يمكنك استخدام استدعاء الوظائف، ووضع JSON، والمعلمات القياسية مثل temperature و top_p. يستجيب النموذج لتعريفات الأدوات ويعيد JSON منظم عند الطلب.

Copyfrom openai import OpenAI

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

يضمن هذا التوافق مع سير عملك الحالي. لا تدعم واجهة برمجة التطبيقات التضمينات أو الصور أو الضبط الدقيق، لذا التزم بإكمالات الدردشة. يتم احتساب استخدام الرموز لكل مليون رمز، مع إدخال بسعر $0.15 وإخراج بسعر $0.50. أرصدة العملات المشفرة المدفوعة مسبقًا لا تنتهي صلاحيتها، لذا يمكنك إيقاف الاستخدام دون فقدان الأموال.

تكامل Node SDK

استخدم حزمة Node.js SDK الخاصة بـ OpenAI لدمج النموذج غير الخاضع للرقابة في تطبيقات JavaScript أو TypeScript الخاصة بك. اضبط baseURL إلى https://api.deepseekabliterated.com/v1 وتوفير مفتاح API الخاص بك. يعكس هذا الإعداد إعداد Python، مما يضمن الاتساق عبر مجموعة التكنولوجيا الخاصة بك. تدعم واجهة برمجة التطبيقات (SDK) استجابات البث المباشر، التي توصل الرموز كما يتم توليدها. هذا يقلل من زمن الاستجابة المدرك للمخرجات الطويلة. يمكنك التعامل مع الأخطاء مثل 401 (مفتاح غير صالح) أو 402 (لا يوجد رصيد) باستخدام منطق إعادة المحاولة القياسي. تقيد واجهة برمجة التطبيقات الطلبات بـ 300 في الدقيقة لكل مفتاح، مع حد التزامن لـ 8 طلبات متزامنة. اضبط تنفيذك لاحترام هذه الحدود. يجب ألا تتجاوز أجسام الطلبات 8 ميجابايت. تنطبق هذه القيود على جميع المفاتيح والحسابات.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.deepseekabliterated.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 من نفس فوترة الرمز وخيارات تعبئة الرصيد بالعملة المشفرة. استخدم USDT على TRC20 أو USDC على Base للتعبئة، مع رصيد إضافي للمبالغ الأكبر.

استخدام الرموز في التدفق

فعّل البث عن طريق تعيين stream: true في طلبك. تُعيد واجهة برمجة التطبيقات أحداث الإرسال الخادم (SSE) مع تحديثات رموز مميزة تدريجية. تحتوي كل شريحة على النص المُولّد، وتشمل الشريحة الأخيرة تفاصيل استخدام الرموز المميزة. يتيح لك ذلك عرض المخرجات في الوقت الفعلي دون انتظار الاستجابة الكاملة. يعمل التدفق مع جميع المعاملات، بما في ذلك استدعاء الوظائف ووضع JSON. استخدم stop معامل للتحكم في طول المخرجات أو شروط التوقف. تدعم الواجهة البرمجية temperature, top_p, seed, presence_penalty، و frequency_penalty لضبط التوليد. يتم الإبلاغ عن استخدام الرموز في الشريحة الأخيرة، لذا يمكنك تتبع التكاليف بدقة. الأخطاء لا تستهلك الرموز، حتى أثناء البث.

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)

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

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

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