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

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

يصادق مفتاح API الخاص بك على كل طلب موجه إلى نقطة النهاية المستضافة لدينا. استخدم عنوان URL الأساسي https://api.coderdeepseek.cc/v1 مع أي SDK أو عميل HTTP من OpenAI. مُعرّف النموذج صارم uncensored. يعمل هذا على خوادمنا الخاصة وليس إعادة بيع لنموذج من بائع آخر. تتلقى مفتاح API فوريًا عند التسجيل عبر Google أو البريد الإلكتروني. احفظ هذا المفتاح بأمان لأنه يتحكم في رصيدك المدفوع مسبقًا.

المصادقة تعتمد على Authorization الرأس. مرر مفتاحك كرمز Bearer. يجب أن يتضمن كل طلب هذا الرأس لتجنب 401 خطأ. لا نستخدم معاملات الاستعلام للمصادقة. يضمن ذلك نظافة الرؤوس وتوافقها مع البرمجيات الوسيطة القياسية.

إرسال الطلبات: إكمال الدردشة

تعالج نقطة نهاية إكمال الدردشة مطالباتك وتعيد مخرجات نصية. أرسل طلب POST إلى /v1/chat/completions. قم بتضمين اسم النموذج، ومصفوفة الرسائل، والمعلمات التي تريدها. يعالج النظام النص ويُرجعه نصاً. يمكنك التحكم في تنسيق الإجابة ومعايير التوقف. يعمل هذا لكل من الاستعلامات البسيطة ومهام البرمجة المعقدة.

استخدم أمر curl التالي لاختبار اتصالك. استبدل YOUR_API_KEY مع المفتاح الفعلي الخاص بك. يستخدم الطلب uncensored معرف النموذج. هذا يؤكد أن مصادقتك ورصيدك نشطان.

Copycurl https://api.coderdeepseek.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "what is the current version of the library"}]
  }'

تحقق من أن الاستجابة تحتوي على choices مصفوفة. كل خيار يتضمن رسالة مع المحتوى المُولّد. تحقق من usage كائن لعدد الرموز. يساعدك ذلك على مراقبة إنفاقك بدقة.

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

قم بدمج واجهة برمجة التطبيقات في مشاريع Python الخاصة بك باستخدام حزمة OpenAI الرسمية. اضبط عنوان URL الأساسي على نقطة النهاية الخاصة بنا. قم بتهيئة العميل باستخدام مفتاح API الخاص بك. يتيح لك ذلك استخدام الأساليب المألوفة مثل chat.completions.create. يتعامل مكتبة البرمجيات (SDK) مع تسلسل JSON وطلبات HTTP تلقائيًا.

قم بتكوين النموذج إلى uncensored. مرر رسائلك بالتنسيق القياسي. تدعم مكتبة SDK جميع ميزاتنا بما في ذلك استدعاء الوظائف ووضع JSON. يمكنك تعيين معاملات مثل درجة الحرارة و top_p مباشرة. يسهل هذا الانتقال من مزودي الخدمات الآخرين.

Copyfrom openai import OpenAI

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

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

تكامل Node SDK

استخدم حزمة Node.js OpenAI للتكامل مع مشاريع JavaScript أو TypeScript الخاصة بك. قم بتثبيت الحزمة وقم بتكوين عنوان URL الأساسي. يحافظ هذا على التوافق مع بنية التعليمات البرمجية الحالية. يمكنك استخدام نفس الأساليب كما في Python. تدعم الحزمة كلًا من CommonJS وES modules.

حدد النموذج إلى uncensored. مرر رسائلك ومعاملاتك. تتعامل مكتبة SDK مع طلبات التدفق وغير التدفق. يمكنك التقاط الأخطاء وتسجيلها بشكل مناسب. يضمن هذا بقاء تطبيقك مستقرًا تحت الحمل.

Copyimport OpenAI from "openai";

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

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

استجابات البث واستهلاك الرموز

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

تحليل أحداث SSE لاستخراج المحتوى. اجمع الشظايا لتشكيل الاستجابة الكاملة. راق الـ usage كائن في القطعة الأخيرة. يمنحك هذا عد رموز دقيق للفوترة. التدفق مثالي للتطبيقات في الوقت الفعلي.

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)

التعامل مع انقطاعات الشبكة بسلاسة. أعد الاتصال إذا انقطع التدفق. لا تعيد الـ API إرسال القطع السابقة. يجب عليك إعادة بناء النص الكامل من جانب العميل. يوفر هذا تجربة مستخدم سلسة.

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

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

نافذة السياق تتسع لـ 100,000 رمز. ويشمل ذلك كلًا من النص التوجيهي والإكمال. الحد الأقصى للإخراج هو 16,000 رمز لكل طلب. إذا لم تضبط max_tokens, الافتراضي هو 2,048. A 401 خطأ يعني أن مفتاحك غير صالح. A 402 خطأ يعني أنك لا تملك رصيداً. قم بالشحن عبر العملات المشفرة للمتابعة في استخدام الخدمة.