دليل الدمج: مفتاح API الخاص بـ deepseek coder

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

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

احفظ المفتاح في متغير بيئة باسم DEEPSEEK_API_KEY أو مررها مباشرة إلى عميل SDK الخاص بك. تقبل نقطة النهاية الرؤوس القياسية، لذا يمكنك تبديل المزودين بتغيير عنوان URL الأساسي وقيمة المفتاح فقط. يعمل هذا النهج مع Cursor، وإضافات VS Code، وأدوات التطوير المحلية التي تتوقع واجهة متوافقة مع OpenAI.

يفشل المصادقة بحالة 401 إذا كان المفتاح مفقوداً أو غير صالح. استخدم

Copycurl https://api.deepseekcoderapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Convert this SQL query to python pandas syntax"}]
  }'

مثال للتحقق من الاتصال قبل الدمج في منطق التطبيق الخاص بك.

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

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

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

Copyfrom openai import OpenAI

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

مقتطف لرؤية كيفية هيكلة طلب دردشة قياسي باستخدام مكتبة OpenAI الرسمية لـ Python.

تعيد الأخطاء مثل عدم كفاية الرصيد رمز حالة 402، بينما تعيد الطلبات غير الصحيحة رمز 400. تحقق من جسم الاستجابة للحصول على رسائل خطأ مفصلة لتصحيح هيكل الحمولة الخاص بك بسرعة.

Models Endpoint (GET)

استعلم عن النماذج المتاحة بإرسال GET /v1/models طلب. تعيد هذه النقطة قائمة كائنات النموذج، بما في ذلك uncensored معرف النموذج. يمكنك استخدام نقطة هذه التحقق من أن مفتاح API الخاص بك صالح وأن الخدمة متصلة قبل إجراء طلبات الاستخدام الثقيلة.

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

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

استجابات البث (SSE)

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

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

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)

مثال يوضح كيفية التعامل مع التدفق في JavaScript.

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

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

استخدم استدعاء الوظائف للسماح للنموذج باستدعاء أدوات خارجية. عرّف وظائفك في tools السماح وحدد tool_choice للتحكم في توقيت استخدام النموذج للأدوات. تدعم الواجهة تعريفات الأدوات القياسية، مما يتيح لك التكامل مع خدمات الخلفية الخاصة بك.

للمخرجات المهيكلة، فعّل وضع JSON عن طريق ضبط response_format إلى json_object. يفرض هذا على النموذج إرجاع JSON صالح، وهو مفيد لتحليل بيانات التكوين أو استجابات واجهة برمجة التطبيقات. ال

Copyimport OpenAI from "openai";

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

يوضح المقتطف كيفية تكوين وضع JSON في Node.js.

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

حدود المعدلات والقيود

مفتاح API الخاص بك محدود بـ 300 طلب في الدقيقة و8 طلبات متزامنة. حجم أقصى لواجهة الطلب هو 8 ميجابايت. إذا تجاوزت هذه الحدود، يعيد API خطأ 429 Too Many Requests. نفذ زيادة الأسي في عميلك للتعامل مع حدود المعدل بسلاسة.

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

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