البدء السريع: دمج بوابة LLM بدون رقابة

المتطلبات المسبقة

تحتاج إلى مفتاح API لمصادقة الطلبات. سجّل حسابًا جديدًا في صفحة الحصول على مفتاح API باستخدام البريد الإلكتروني وكلمة المرور فقط. لا يلزم بطاقة ائتمان للبدء؛ تحصل الحسابات الجديدة على رصيد تجريبي بقيمة $0.50 صالح لمدة 7 أيام. احصل على هذا الرصيد بنقرة واحدة في صفحة مفتاح API الخاص بك. يظهر مفتاح API الخاص بك فورًا بعد التسجيل.

المتطلبات المسبقة: مفتاح API نشط وبيئة لغة برمجة مدعومة. تقبل البوابة عملاء متوافقين مع OpenAI القياسية، لذا فمن المرجح أن تكون لديك الأدوات اللازمة مثبتة بالفعل.

تثبيت حزمة SDK

بينما يمكنك استخدام طلبات HTTP الخام، فإن استخدام حزمة SDK يبسط التعامل مع حمولات JSON والاستجابات المتدفقة. نوصي باستخدام حزمة Python الرسمية openai أو حزمة Node.js openai.

• بايثون: pip install openai
• نود.جي إس: npm install openai

تتعامل هذه المكتبات مع المصادقة وتنسيق الطلبات تلقائيًا عند تكوينها بشكل صحيح.

تكوين عنوان URL الأساسي

الميزة الأساسية لهذه بوابة llm هي التوافق التام. لا تحتاج إلى تغيير منطق الكود الخاص بك، فقط التكوين. وجّه عميل SDK الخاص بك إلى عنوان URL الأساسي الخاص بنا وقم بتوفير مفتاح API.

عنوان URL الأساسي: https://api.openllmgateway.com/v1

معرف النموذج: uncensored

تدعم نقطة النهاية هذه تنسيق chat/completions القياسي. من خلال تغيير هاتين القيمتين فقط، يمكن لتطبيقاتك الحالية توجيه الطلبات عبر نموذجنا بدون رقابة دون قفل المزود.

إرسال إكمال المحادثة

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

تأكد من أن جسم الطلب لا يتجاوز 8 MB. يدعم النموذج نافذة سياق بحجم 100,000 رمز لكل من الموجّه والإكمال معًا.

إليك مثال أساسي باستخدام cURL:

نسخcurl https://api.openllmgateway.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."}]
  }'

استبدل $OPENLLM_API_KEY بمفتاحك الفعلي. سيتم إرجاع الاستجابة بتنسيق JSON مع النص المولد في choices[0].message.content.

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

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

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

مثال باستخدام حزمة SDK لـ Python:

نسخfrom openai import OpenAI

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

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

استخدام استدعاء الأدوات

يدعم الـ API استدعاء الدوال، مما يسمح للنموذج بقرار متى يستدعي الأدوات الخارجية بناءً على الموجّه. عرّف دوالك في المعلمة tools.

عندما يحدد النموذج أن الأداة يجب استخدامها، فإنه يُرجع مصفوفة tool_calls في الاستجابة. تقوم بتنفيذ الدالة وإرسال النتيجة مرة أخرى إلى النموذج في رسالة لاحقة.

مثال باستخدام حزمة SDK لـ Node.js:

نسخimport OpenAI from "openai";

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

هذا يمكّن سير العمل المعقد للوكلاء دون الخروج عن واجهة OpenAI المتوافقة القياسية.

التحقق من النماذج المتاحة

استعلم عن نقطة النهاية GET /v1/models للتحقق من النماذج المتاحة وبياناتها الوصفية. هذا مفيد لتصحيح الأخطاء أو اختيار النماذج ديناميكيًا.

نسخstream = 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)

ستُدرج الاستجابة النموذج uncensored. لاحظ أن هذا البوابة لا يوفر التضمينات، أو توليد الصور، أو معالجة الصوت. إنه حصرياً واجهة برمجة لإكمال الدردشة النصية.

الحدود والأخطاء والنافذة السياقية

حدود المعدل: أنت مقيد بـ 300 طلب في الدقيقة لكل مفتاح API. إذا تجاوزت هذا، ستحصل على خطأ 429 Too Many Requests.

المصادقة: يشير خطأ 401 Unauthorized إلى مفتاح API غير صالح أو مفقود. أعد إنشاء مفتاحك في لوحة التحكم إذا لزم الأمر.

الفوترة: يحدث خطأ 402 Payment Required عندما ينفد رصيدك المسبق الدفع. تبدأ عمليات شحن الرصيد بمبلغ $20، مع رصيد إضافي للإيداعات الأكبر.

نافذة السياق: يدعم النموذج 100,000 رمز. أدِر طول الموجّه والإكمال للبقاء ضمن هذا الحد. سيتم رفض الطلبات التي تتجاوز 8 MB.