دمج واجهة برمجة التطبيقات في دقائق

الإعداد وعنوان URL الأساسي

قم بتكوين العميل ليشير إلى نقطة النهاية المتوافقة مع OpenAI لدينا على الفور.

تقع واجهة برمجة التطبيقات (API) الخاصة بنا على https://api.codedeepseek.cc/v1. تحتاج فقط إلى تغيير base_url وإمداد مفتاح API الخاص بك. هذا الإعداد يعمل مع حزم SDK الرسمية لـ Python وNode.js، مما يضمن بقاء الكود الحالي كما هو. لا حاجة لتوجيه معقد أو إعدادات بروكسي.

سجّل عبر Google أو البريد الإلكتروني للحصول على مفتاحك على الفور. لا يلزم رقم هاتف، ويظهر المفتاح على الشاشة فوراً. يتيح لك هذا البساطة للتركيز على التكامل بدلاً من العقبات الإدارية.

المصادقة

أدرج مفتاحك في Authorization الرأس لكل طلب. تنسيق الرأس هو: Authorization: Bearer YOUR_API_KEY. لا نستخدم معاملات الاستعلام للمصادقة، مما يبقي عناوين URL الخاصة بك نظيفة وآمنة.

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

إرسال طلبك الأول

أرسل طلبًا قياسيًا chat.completions مكالمة لتوليد النص من النموذج غير الخاضع للرقابة.

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

يوضح المثال التالي طلباً أساسياً باستخدام cURL. استبدل YOUR_API_KEY مع المفتاح الفعلي الخاص بك.

Copycurl https://api.codedeepseek.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix the null pointer in the java service class"}]
  }'

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

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

استجابات البث مع SSE

فعّل توليد الرمز الفوري عن طريق تعيين stream: true في طلبك.

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

Copyfrom openai import OpenAI

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

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

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

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

دمج الأدوات الخارجية من خلال تعريف الوظائف في حمولة الطلب الخاصة بك.

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

Copyimport OpenAI from "openai";

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

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

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

تأكد من أن تعريفات الأدوات الخاصة بك تطابق مخطط الإدخال المتوقع. يمكن أن تؤدي عدم التطابقات إلى أخطاء أو سلوك غير متوقع. اختبر تكامل الأدوات الخاص بك بعمق قبل النشر في بيئة الإنتاج.

وضع JSON للمخرجات المهيكلة

فرض النموذج على إخراج JSON صالح عن طريق تعيين response_format إلى {"type": "json_object"}.

هذه الحالة مثالية للتطبيقات التي تتطلب بيانات هيكلية، مثل ملفات التكوين أو استجابات API. سيحاول النموذج الامتثال لتركيب 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)

استخدم وضع JSON بالتزامن مع البث لتسليم البيانات المهيكلة في الوقت الفعلي. هذا المزيج قوي لبناء تطبيقات الويب الديناميكية التي تستهلك بيانات API.

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

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

المعلمات: درجة الحرارة وTop-P والبذلة

تحكّم في العشوائية وقابلية إعادة إنتاج المخرجات باستخدام المعايير القياسية.

تعيين temperature بين 0 و2 لتفاوت الإبداع. تنتج القيم الأقل نتائج أكثر حتمية، بينما تزيد القيم الأعلى من العشوائية. استخدم top_p للعينة النواة، والتي تحد من كتلة الاحتمال للرموز المدروسة.

The seed السماح بإنتاج مخرجات قابلة للتكرار. حدد قيمة بذرة (seed) محددة للحصول على نفس الاستجابة عبر مكالمات متعددة. هذا مفيد للاكتشاف والتجريب.

ادمج هذه المعاملات لضبط سلوك النموذج لحالة الاستخدام المحددة الخاصة بك. على سبيل المثال، استخدم درجة حرارة منخفضة وبذرة (Seed) ثابتة لتوليد الكود حيث يكون الاتساق أمراً أساسياً.

تجربة مع إعدادات مختلفة للعثور على التوازن الأمثل لتطبيقك. تدعم الواجهة جميع المعايير القياسية لـ OpenAI، مما يضمن التوافق مع الأدوات الموجودة.