بوابة الذكاء الاصطناعي: غيّر عميلك في ثلاثة أسطر

المتطلبات المسبقة: ثبّت SDK المفضل لديك

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

الخطوة 1: اضبط عنوان URL الأساسي ومفتاح API

تعمل نقطة النهاية بوابة الذكاء الاصطناعي لدينا على عنوان URL أساسي مميز. تحتاج إلى استرداد مفتاح API الخاص بك من لوحة التحكم وتكوين عميل SDK الخاص بك للإشارة إلى https://api.openaigatewayapi.com/v1. يضمن ذلك تجاوز جميع الطلبات للبنية التحتية القياسية لـ OpenAI وتوجيهها مباشرة إلى خوادم النموذج بدون رقابة. لا تحتاج إلى تغيير اسم النموذج؛ فقط اضبط عنوان URL الأساسي وقم بتوفير مفتاحك.

الخطوة 2: أرسل طلب إكمال دردشة قياسي

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

الخطوة 3: فعّل البث المتدفق باستخدام أحداث الإرسال من الخادم

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

الخطوة 4: استخدم استدعاء الدوال لدمج الأدوات

تدعم نقطة النهاية استدعاء الدوال، مما يتيح لك تعريف الدوال والسماح للنموذج بأن يقرر متى يستدعيها. يتيح هذا سير عمل معقدة من خلال دمج واجهات برمجة التطبيقات أو مصادر البيانات الخارجية مباشرةً في منطق LLM الخاص بك. عرّف أدواتك في المعلمة tools، وسيعيد النموذج إخراج JSON مُهيكّل عند الاقتضاء. تعمل هذه الميزة بنفس الطريقة التي تعمل بها في التنسيق القياسي لـ OpenAI، مما يسهل تبديل المزوّدين دون إعادة كتابة منطق تكامل الأدوات الخاص بك.

الخطوة 5: تعامل مع الأخطاء وحدود المعدل

راقب استخدام مفتاح API الخاص بك وتعامل مع الأخطاء المحتملة بسلاسة. إذا كان المفتاح غير صالح، ستتلقى خطأ 401. إذا استنفدت رصيدك المسبق الدفع، يشير خطأ 402 إلى أنك بحاجة إلى شحن الرصيد. يفرض النظام حدًا قدره 300 طلب في الدقيقة لكل مفتاح؛ سيؤدي تجاوز هذا إلى تشغيل خطأ حد المعدل 429. بالإضافة إلى ذلك، حافظ على حجم جسم الطلب أقل من 8 MB لتجنب الرفض. تدعم نافذة السياق ما يصل إلى 100,000 رمز لكل من الموجّه والإكمال معًا.

cURL

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

Python

نسخfrom openai import OpenAI

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

Node.js

نسخimport OpenAI from "openai";

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