البدء السريع للتكامل

المصادقة وعنوان URL الأساسي

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

عنوان URL الأساسي لجميع الطلبات هو https://api.llmrouterapi.com/v1. هذا العنوان متوافق مع أدوات OpenAI SDK الرسمية وأي عميل قياسي متوافق مع OpenAI. فقط قم بتكوين عميلك للإشارة إلى هذا العنوان الأساسي واضبط رأس الطلب الخاص بك إلى Authorization: Bearer YOUR_API_KEY. لا حاجة لمنطق توجيه معقد؛ نحن نتولى البنية التحتية لك.

الطلب الأول: إكمال الدردشة

أرسل طلبك الأول إلى نقطة النهاية POST /v1/chat/completions. يجب أن تحدد معرف النموذج كـ "uncensored". هذا النموذج هو نموذج لغة كبير مفتوح الأوزان مضبوط للإجابة دون رفض المحتوى للاستخدام القانوني للبالغين. يدعم نافذة سياق بقدرة 100,000 رمز، تغطي كلًا من الموجّه والإكمال.

يوجد أدناه مثال أساسي باستخدام curl لتوضيح هيكلية حمولة JSON القياسية.

Copycurl https://api.llmrouterapi.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 SDK

لمطوري Python، تعمل الحزمة الرسمية openai مباشرة. قم بتكوين العميل لاستخدام عنوان URL الأساسي الخاص بنا ومفتاح API الخاص بك. يضمن ذلك عمل شيفرتك الحالية فورًا عن طريق تغيير عنوان URL الأساسي ومفتاح API فقط. يتولى العميل التعيين التلقائي وتحليل الأخطاء.

تأكد من تحديد النموذج كـ uncensored في التهيئة أو الطلب. يلغي هذا النهج احتكاك التكامل ويسمح لك بالاستفادة من النظام البيئي القوي لأدوات LLM الموجودة.

Copyfrom openai import OpenAI

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

يمكن لمطوري Node.js استخدام حزمة npm openai أو أي عميل يعتمد على fetch. اضبط baseURL إلى نقطة النهاية الخاصة بنا وقم بتوفير مفتاحك في الرؤوس. هذه الطريقة مثالية لتطبيقات الخادم أو الوظائف الطرفية حيث تحتاج إلى تحكم برمجي في دورة حياة الطلب.

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

Copyimport OpenAI from "openai";

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

يحتوي كل جزء على محتوى جزئي، مما يتيح لك عرض النص تدريجيًا. تعمل هذه الميزة بسلاسة مع عملاء البث المتدفق المتوافقين مع 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)

الحدود، الأخطاء، وقائمة النماذج

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

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