دليل البدء السريع لواجهة برمجة تطبيقات نموذج لغوي كبير غير خاضع للرقابة

المتطلبات الأساسية: تثبيت حزمة تطوير OpenAI

ابدأ بتثبيت مكتبة OpenAI الرسمية للغتك المفضلة. تتولى مكتبة العميل المصادقة والتسلسل تلقائياً. أنت بحاجة فقط إلى المكتبة القياسية؛ لا توجد تبعيات إضافية مطلوبة لتوليد النصوص الأساسي.

تأكد من أن بيئتك تدعم إصدارات حديثة من Python أو JavaScript. تقوم SDK بتجريد تفاصيل HTTP حتى تتمكن من التركيز على هندسة الأوامر.

تهيئة العميل باستخدام base_url

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

ستستخدم مفتاح API الفريد الخاص بك للمصادقة. يضمن عنوان URL الأساسي أن تطبيقك يتواصل مباشرة مع خوادمنا دون الوكيل عبر مورد آخر.

• عنوان URL الأساسي: HTTPS://api.openrouteropenaicompatible.com/v1
• معرف النموذج: uncensored

Copyfrom openai import OpenAI

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

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

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

Copycurl https://api.openrouteropenaicompatible.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list all installed npm packages in current directory"}]
  }'

Copyimport OpenAI from "openai";

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

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

تعيين stream: true لتلقي الرموز أثناء توليدها. يقلل هذا من زمن الاستجابة المُدرَك للمخرجات الطويلة. تحتوي كل قطعة على نص جزئي وإحصائيات الاستخدام في الحدث الأخير.

يرسل الخادم أحداث الإرسال من الخادم (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)

تكوين وضع JSON للبيانات المهيكلة

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

تفعيل json_object لضمان أن الاستجابة هي JSON صالح. هذا حاسم للتكامل البرمجي مع خدمات الخلفية الخاصة بك.

تطبيق استدعاء الوظائف

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

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

عالج استخدام الرموز والحدود

راقب استخدامك لتجنب انقطاعات الخدمة. تدعم نافذة السياق 100,000 رمز للمطالبة والإكمال معاً. الإخراج محدود بـ 16,000 رمز لكل طلب.

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