البدء السريع: توصيل مكتبة OpenAI الخاصة بك

المتطلبات الأساسية: حزمة التطوير (SDK) والبيئة

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

التكوين: base_url ومفتاح API

وجّه حزمة تطوير البرمجيات (SDK) الخاصة بك إلى نقطة النهاية المحددة لدينا بدلاً من المضيف الافتراضي لـ OpenAI. استخدم عنوان URL الأساسي المقدم في لوحة التحكم الخاصة بك وعين مفتاحك المولد لرأس المصادقة القياسي. يضمن ذلك توجيه جميع الطلبات بشكل صحيح إلى بنية نموذجنا غير الخاضع للرقابة دون الحاجة إلى رؤوس مخصصة.

إرسال أول إكمال دردشة لك

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

Copycurl https://api.mistralopenaicompatibleapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list top 5 linux commands for disk cleanup"}]
  }'

يؤكد الرد أن النموذج قد processed مدخلاتك ضمن نافذة السياق المسموح بها. يمكنك الآن دمج هذا المنطق في سير عمل تطبيقاتك.

تطبيق مكتبة Python

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

Copyfrom openai import OpenAI

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

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

تطبيق Node SDK

تهيئة العميل باستخدام عنوان URL الأساسي ومفتاح API الصحيحين في بيئة Node.js الخاصة بك. تدعم مكتبة SDK كلًا من الأنماط المتزامنة وغير المتزامنة لحالات الاستخدام المختلفة. قم بتعيين معرف النموذج إلى "uncensored" للحصول على نتائج متسقة.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.mistralopenaicompatibleapi.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 من نفس هيكل تسعير الرمز وحدود المعدل مثل مستخدمي Python. راقش لوحة الاستخدام الخاصة بك لتتبع استهلاك رصيد ما قبل الدفع بدقة.

الاستجابات التدفقية والحدود

تمكين التدفق لتلقي الرموز تدريجياً، مما يقلل من زمن الانتظار المُدرَك للمخرجات الطويلة. تدعم واجهة برمجة التطبيقات الخاصة بنا أحداث الإرسال الخادم (SSE) لتوليد النص في الوقت الفعلي، وهو مثالي لواجهات الدردشة. انتبه لحدود معدل الطلب (429) وقيود الرموز أثناء الاستخدام عالي الحجم.

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 رمز. تشير الأخطاء مثل 401 إلى بيانات اعتماد غير صالحة، بينما تشير 402 إلى عدم كفاية الرصيد المدفوع مسبقًا. حافظ على الطلبات دون 8 ميجابايت لتجنب رفض الحمولة.