عنوان URL الأساسي والمصادقة
تتبع واجهة API الخاصة بنا معيار توافق OpenAI، مما يعني أنه يمكنك استخدام حزم SDK الحالية بتغييرات بسيطة. عنوان URL الأساسي هو https://api.sdxlnsfw.top/v1. تقوم بالمصادقة باستخدام رمز Bearer في رأس Authorization. على عكس العديد من المنافسين، لا نطلب رقم هاتف للتسجيل؛ يمكنك إنشاء حساب عبر Google أو البريد الإلكتروني والحصول على مفتاحك فوراً.
يدعم كل حساب مفتاح API واحد نشط في كل مرة. إذا أنشأت مفتاحًا جديدًا، سيتم إلغاء سريان المفتاح القديم فورًا. تأكد من ضبط رأس Authorization على Bearer YOUR_API_KEY لجميع الطلبات. تتعامل نقطة النهاية هذه مع جميع معالجة النصوص، من توليد الموجّه إلى التسميات، دون التدخل في خطوط أنابيب الصور أو الصوت الخاصة بك.
إرسال طلبك الأول
ابدأ بإرسال طلب إكمال نصي بسيط للتحقق من الاتصال. معرف النموذج هو uncensored. هذا النموذج مُعد للإجابة بدون رفض المحتوى للاستخدام القانوني للبالغين، مما يجعله مثالياً لهندسة الموجّهات NSFW. يمكنك إرسال ما يصل إلى 100,000 رمز في نافذة السياق، دون وجود حد أقصى منفصل للإخراج لكل طلب.
يُظهر أدناه مثال cURL أساسي لاختبار نقطة النهاية. استبدل YOUR_API_KEY بمفتاحك. إذا تلقيت استجابة JSON تحتوي على محتوى، فإن تكاملك يعمل. تشير الأخطاء مثل 401 إلى مفتاح غير صالح، بينما يعني 402 أنك بحاجة إلى شحن رصيدك.
توليد الموجّهات لـ sdxl nsfw
استخدم واجهة API لتوليد موجّهات مفصلة لخطوط أنابيب SDXL NSFW الخاصة بك. يتعامل النموذج بدون رقابة مع العلامات المحددة، وأوصاف التشريح، والأساليب الفنية بدون تصفية. يمكنك تمرير موجّه نظامي لتحديد دور النموذج، مما يضمن مخرجات متسقة لسير عملك. على سبيل المثال، اطلب منه توسيع مفهوم بسيط إلى موجّه كامل مع تفاصيل الإضاءة والكاميرا.
واجهة API نصية فقط، لذا فهي لا تولد الصورة نفسها. فهي توفر البنية النصية التي تدعم خطوة التوليد الخاصة بك. هذا يضمن بقاء البيانات الوصفية والموجهات بدون رقابة، والحفاظ على النية الدقيقة لاتجاهك الإبداعي. استخدم المعلمة temperature للتحكم في الإبداع؛ تؤدي القيم الأعلى إلى توليد موجّهات أكثر تنوعاً.
استدعاء الدوال والأدوات
قم بدمج استخراج البيانات المهيكلة أو استخدام الأدوات في خط الأنابيب الخاص بك. تدعم واجهة API استدعاء الدوال، مما يسمح لك بتعريف الأدوات التي يمكن للنموذج استدعاؤها. هذا مفيد لتحليل النص غير المهيكل أو تشغيل إجراءات محددة في نصك البرمجي. اضبط tool_choice للتحكم في ما إذا كان يجب على النموذج استخدام أداة أو يمكنه الاختيار بحرية.
عرّف دوالك في مصفوفة tools. سيعيد النموذج استجابة تحتوي على استدعاءات للأدوات إذا كان ذلك مناسباً. هذه الميزة متاحة لجميع الطلبات، مما يتيح منطقاً معقداً في سير عمل تصنيف النصوص NSFW أو التسمية الخاصة بك. تأكد من أن تعريفات الدوال الخاصة بك هي JSON صالح لتجنب أخطاء التحليل.
استجابات البث المتدفق
لتطبيقات الوقت الفعلي، استخدم أحداث Server-Sent (SSE) لبث الاستجابات رمزاً تلو الآخر. هذا يقلل من زمن الاستجابة المتصور ويسمح لك بعرض التقدم أثناء توليد النموذج للنص. يتم تمكين البث المتدفق عن طريق ضبط stream: true في طلبك. يحتوي كل جزء على محتوى جزئي، ويشمل الجزء الأخير إحصائيات استخدام الرموز.
هذا مفيد بشكل خاص لتوليد الموجّهات الطويلة أو كتابة النصوص البرمجية. يمكنك معالجة الرموز عند وصولها، وبناء النص النهائي تدريجياً. تذكر أن الأخطاء أثناء البث المتدفق قد لا تزال تعيد جزءاً نهائياً يحتوي على تفاصيل الخطأ. تعامل مع انقطاعات الشبكة بسلاسة، حيث يمكن أن تنقطع اتصالات البث المتدفق.
وضع JSON للبيانات المهيكلة
تأكد من مخرجات متسقة لخطوط الأنابيب الآلية باستخدام وضع JSON. اضبط response_format على {"type": "json_object"} لإجبار النموذج على إرجاع JSON صالح. هذا أمر حاسم لتحليل الاستجابات في الكود الخاص بك دون الحاجة إلى تعابير منتظمة معقدة أو معالجة لاحقة. سيلتزم النموذج بالهيكل الذي تحدده في موجّه النظام أو أمثلة قليلة النقر.
استخدم هذا لتوليد البيانات الوصفية، استخراج العلامات، أو تنسيق الموجّهات للأدوات التالية. يضمن وضع JSON الموثوقية، مما يقلل من فرصة كسر خط الأنابيب الخاص بك بسبب استجابات غير صالحة. لاحظ أن وضع JSON قد يزيد قليلاً من زمن الاستجابة بسبب عبء التحقق. تحقق دائماً من الإخراج في الكود الخاص بك، حيث يمكن للنموذج لا يزال إنتاج JSON غير صالح في الحالات الحدية.
cURL
curl https://api.sdxlnsfw.top/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.sdxlnsfw.top/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.sdxlnsfw.top/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)