واجهة برمجة تطبيقات متوافقة مع OpenAI: غيّر عميلك في ثلاثة أسطر

المتطلبات المسبقة: تثبيت OpenAI SDK

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

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

الميزة الأساسية لخدمتنا هي أنك تحتاج فقط إلى تحديث قيمتي تكوين. وجّه عميلك إلى عنوان URL الأساسي الخاص بنا: https://api.openaicompatibleapi.com/v1. ثم، أنشئ مفتاح API الخاص بك في صفحة التسجيل؛ يظهر فوراً بعد التسجيل دون الحاجة إلى بطاقة ائتمان. اضبط base_url و api_key في تهيئة عميلك. هذا يجعلنا بديلاً مباشراً لواجهة برمجة تطبيقات GPT لمشاريعك الحالية دون إعادة كتابة المنطق.

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

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

Copycurl https://api.openaicompatibleapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

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

لتحسين تجربة المستخدم، فعّل البث المتدفق لتلقي الرموز (tokens) عند توليدها. اضبط stream=True في طلبك. سيقوم الـ SDK بإرجاع أجزاء البيانات مع وصولها، مما يتيح لك عرض النتائج الجزئية فوراً. هذا مفيد بشكل خاص لنافذة السياق التي تصل إلى 100,000 رمز. يعمل البث المتدفق بنفس طريقة عملاء OpenAI القياسيين، مما يحافظ على التوافق مع منطق معالجة الأخطاء الحالي لديك.

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 يدعم تنسيق استدعاء الدوال القياسي. إنها مثالية لبناء وكلاء أو أتمتة سير العمل دون إدارة وكيل LLM معقد.

Copyfrom openai import OpenAI

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

فحص النماذج المتاحة

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

Node.js

Copyimport OpenAI from "openai";

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