كيف إلى دمج واجهة برمجة تطبيقات DeepSeek

المتطلبات الأساسية: إعداد البيئة

ابدأ بتأكد من أن بيئة التطوير الخاصة بك تحتوي على مكتبة SDK المثبتة اللازمة. تحتاج إلى بيئة تشغيل اللغة مثل Python أو Node.js وطريقة لتخزين بيانات اعتماد واجهة برمجة التطبيقات (API) الخاصة بك بأمان. هذا الإعداد متطابق مع استخدام أي خدمة متوافقة مع OpenAI.

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

تثبيت الحزمة البرمجية (SDK) الرسمية

ثبّت الحزمة الرسمية (SDK) الخاصة بلغتك المفضلة للتعامل مع المصادقة والتسلسل. بالنسبة لـ Python، استخدم pip install openai. بالنسبة لـ Node.js، قم بتشغيل npm install openai. تدير هذه المكتبة اتصالات HTTP الأساسية.

يُجريد SDK التعقيد الخاص ببناء حمولات JSON. يمكنك التركيز على تحديد مطالبتك (prompt) ومعالجة الرمز المسترجع. يعني هذا التوحيد القياسي أنه يمكنك تبديل المزودين لاحقاً بتغيير عنوان URL الأساسي فقط.

Copyfrom openai import OpenAI

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

تكوين عنوان URL الأساسي والمفتاح

وجّه عميل SDK الخاص بك إلى عنوان URL الوكيل وأدرج مفتاح API الخاص بك. توجه خطوة التكوين هذه حركة المرور بعيدًا عن خوادم OpenAI القياسية. يجب عليك ضبط base_url إلى https://api.deepseekpago.com/v1.

مرر مفتاحك عبر api_key المعلمة. يتم إنشاء هذا المفتاح عند تسجيلك في الموقع. يقوم بمصادقة طلباتك وتتبع استخدام رصيدك المدفوع مسبقًا. بدون هذا الإعداد، ستفشل طلباتك بخطأ 404 أو 401.

إجراء أول طلب

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

يحتوي جسم الطلب على messages مصفوفة و model identifier. The response contains the generated text in the content الحقل. يؤكد ذلك أن تكاملك يعمل بشكل صحيح مع النموذج غير الخاضع للرقابة.

Copycurl https://api.deepseekpago.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a list of top five open source llms"}]
  }'

تمكين استجابات التدفق

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

تعامل مع التدفق من خلال التكرار عبر القطع. تحتوي القطعة الأخيرة على إجمالي استخدام الرموز. يتيح لك ذلك مراقبة التكاليف في الوقت الفعلي دون انتظار اكتمال الاستجابة.

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)

باستخدام الأدوات واستدعاء الوظائف

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

تعمل هذه الميزة تمامًا مثل واجهة برمجة تطبيقات استدعاء الوظائف في OpenAI. يمكنك دمجها في منطق تطبيقك لتنفيذ التعليمات البرمجية أو تحديث قواعد البيانات. تدعم الوكيل هذا البروتوكول القياسي دون أي تعديلات.

Copyimport OpenAI from "openai";

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

فرض النموذج على إرجاع JSON صالح عن طريق تعيين response_format إلى {"type": "json_object"}. هذا مفيد لتحليل البيانات في تطبيقك. يقلل من الحاجة إلى أنماط التعبيرات العادية (regex) للمعالجة اللاحقة.

النموذج يلتزم بهذا القيد بدقة. إذا لم يكن المخرج JSON صالحًا، قد يفشل الطلب. يضمن ذلك بقاء خط أنابيبك قويًا عند التكامل مع الأنظمة الآلية. يمكنك أيضًا ضبط درجة الحرارة وtop_p للتحكم في الإبداع.

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

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

تُعاد الأخطاء ككائنات JSON قياسية تحتوي على رمز خطأ ورسالة. تعامل معها بسلاسة في كودك. يُنصح بمنطق إعادة المحاولة مع زيادة أسيّة للأخطاء العابرة مثل استجابات 429 أو 503.

مراقبة استخدام الرموز

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

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