البدء السريع لمستخدمي OpenRouter NSFW

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

استبدل Base URL الخاص بمزود الخدمة الحالي بـ https://api.openrouternsfw.com/v1. يستخدم المصادقة رأس Authorization: Bearer <key> القياسي. تحصل على مفتاحك فورًا بعد تسجيل الدخول عبر Google أو البريد الإلكتروني في صفحة Get API key. لا يلزم رقم هاتف، والمفتاح يظهر مرة واحدة فقط، لذا انسخه قبل مغادرة الصفحة.

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

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

نقطة نهاية إكمال الدردشة

توفر الوظيفة الأساسية عبر نقطة النهاية POST /v1/chat/completions. تقبل نقطة النهاية جسم JSON يحتوي على اسم النموذج، ومصفوفة الرسائل، والمعلمات الاختيارية. تعيد كائن JSON يحتوي على النص المولد، وإحصائيات استخدام الرموز، وسبب الانتهاء. هذا الهيكل متوافق مع SDKs الرسمية لـ OpenAI ومعظم مكتبات العملاء المتوافقة مع OpenAI.

لا تحتاج إلى كتابة عملاء HTTP مخصصين إذا كنت تفضل استخدام SDK. ومع ذلك، يجب عليك تحديث التكوين للإشارة إلى Base URL الخاص بنا. يوضح المثال التالي طلب إكمال قياسي باستخدام cURL. يرسل هذا الطلب موجّهًا إلى النموذج بدون رقابة ويتوقع استجابة نصية.

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

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

تكامل SDK Python

يسهل SDK Python عملية الدمج. قم بتهيئة العميل مع Base URL الصحيح ومفتاح API الخاص بك. تتعامل المكتبة مع طلبات HTTP وتحليل JSON لك. يمكنك تحديد معرف النموذج كـ uncensored للتأكد من استخدام النموذج المحدد الخاص بنا.

نسخfrom openai import OpenAI

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

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

SDK Python هو مجرد خيار واحد. يمكنك استخدام أي لغة تدعم طلبات HTTP. يظل هيكل نقطة النهاية نفسه بغض النظر عن العميل الذي تختاره. يسمح لك هذا المرونة بدمج النموذج بدون رقابة في أي سير عمل موجود دون تغييرات كبيرة في التعليمات البرمجية.

استخدام SDK لـ Node

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

نسخimport OpenAI from "openai";

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

يمكن لمطوّري Node.js دمج هذا الـAPI بسهولة في مشاريعهم الحالية. يتعامل الـSDK مع تسلسل وفك تسلسل بيانات JSON. يمكنك أيضاً تحديد معلمات إضافية مثل temperature أو top_p للتحكم في عشوائية المخرجات.

تأكد من التعامل مع الطبيعة غير المتزامنة للطلبات بشكل صحيح. استخدم async/await أو سلاسل الوعود لإدارة بيانات الاستجابة. هذا يضمن بقاء تطبيقك مستجيبًا أثناء انتظار النموذج لتوليد النص. Node SDK هو خيار موثوق لبناء خدمات توليد النصوص القابلة للتوسع.

استجابات البث المتدفق

تمكين البث المتدفق عن طريق تعيين المعلمة stream إلى true في طلبك. سيرسل الخادم سلسلة من أحداث Server-Sent Events (SSE) بدلاً من استجابة JSON واحدة. يحتوي كل حدث على جزء جزئي من النص المولد.

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

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

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

حدّ المعدل ونافذة السياق

يُقتصر كل مفتاح API على 300 طلب في الدقيقة و8 طلبات متزامنة. حجم جسم الطلب محدود بـ 8 MB. إذا تجاوزت هذه الحدود، تُعيد الخوادم رمز الحالة 429. هذا رمز حالة HTTP قياسي يشير إلى أنك أرسلت عددًا كبيرًا من الطلبات في نافذة زمنية محددة. يجب عليك تنفيذ آلية التخلف الأسي في عميلك للتعامل مع هذه الأخطاء بسلاسة.

تدعم نافذة السياق ما يصل إلى 100,000 رمز للموجّه والمكمل مجتمعين. لا يوجد حد منفصل للمخرجات. إذا لم تحدد المعلمة max_tokens، يمكن أن يمتد الرد إلى نهاية النافذة. يمكنك تحديد طول المخرجات عن طريق تعيين max_tokens إلى قيمة أقل.

راقب استهلاك الرموز (tokens) لإدارة رصيدك المسبق الدفع بفعالية. لا تستهلك الأخطاء والرفض الرموز، لذا لا تُ charged للطلبات الفاشلة. يضمن ذلك أن تدفع فقط مقابل توليد النص الناجح. راقب حدّ المعدل لتجنب انقطاع الخدمة.