توثيق API LLM غير خاضع للرقابة - دردشة NSFW
دمج API LLM غير الخاضع للرقابة في تطبيق دردشة NSFW الخاص بك باستخدام دليل البدء السريع هذا. أرسل نصًا إلى نقطة النهاية chat-completions واحصل على استجابات النموذج الخام وغير المقيدة.
عنوان URL الأساسي والمصادقة
ابدأ بتوجيه عميلك المتوافق مع OpenAI إلى عنوان URL الأساسي https://api.nsfwchat.top/v1. قم بمصادقة كل طلب عن طريق تضمين مفتاح API الخاص بك في رأس Authorization كرمز Bearer. يمكنك إنشاء هذا المفتاح فورًا بعد تسجيل الدخول عبر Google أو البريد الإلكتروني في صفحة الحصول على مفتاح API. يظهر المفتاح مرة واحدة عند إنشائه، لذا احفظه بأمان. يرتبط هذا المفتاح الوحيد برصيدك المسبق الدفع وحدود الطلبات الخاصة بحسابك.
الطلب الأول
أرسل طلب chat-completions قياسي لاختبار الاتصال وجودة الاستجابة. استخدم معرف النموذج uncensored للوصول إلى نموذج مفتوح الأوزان المخصص للمحتوى البالغ. تقبل الواجهة النص المدخل وتُرجع نصًا كإخراج. تأكد من أن حمولة الطلب تتضمن مصفوفة messages والحقل model. يتحقق هذا الاتصال الأساسي من صحة مصادقتك وإعداد عنوان URL الأساسي قبل بناء منطق التطبيق الخاص بك.
تكامل SDK Python
استخدم مكتبة Python الرسمية لـ OpenAI للتفاعل مع API. اضبط متغيرات البيئة base_url و api_key أو مررها مباشرةً إلى مُنشئ العميل. استدعِ chat.completions.create باستخدام النموذج uncensored. تستفيد هذه الطريقة من أكواد المجتمع الموجودة لتطبيقات دردشة NSFW. تتعامل المكتبة مع التسلسل وتحليل الأخطاء، مما يتيح لك التركيز على هندسة الموجّه وإدارة سجل الرسائل في بيئة Python الخاصة بك.
تكامل SDK Node.js
لتطبيقات JavaScript أو TypeScript، قم بتهيئة عميل OpenAI بعنوان URL الأساسي ومفتاح API الخاص بك. تكون مكتبة Node.js غير متزامنة افتراضيًا، مما يعيد وعودات (promises) لجميع مكالمات API. استدعِ chat.completions.create لإرسال سجل محادثتك. هذا التكامل مثالي لخوادم الويب أو الخلفيات القائمة على Node.js للألعاب التي تتطلب I/O غير حظر. تعامل مع كائن الاستجابة لاستخراج رد المساعد وتحديث حالتك المحلية أو قاعدة البيانات.
استجابات البث عبر SSE
فعّل البث عن طريق تعيين stream: true في طلبك. يعيد API أحداث المستند المرسلة (SSE) بينما يولد النموذج النص. يحتوي كل جزء على أجزاء جزئية. يتضمن الجزء الأخير إحصائيات استخدام الرموز للطلب. تقلل هذه الطريقة من زمن الاستجابة المدرك للمستخدمين في واجهات دردشة NSFW من خلال عرض النص أثناء توليده. قم بمعالجة كل حدث في عميلك لتحديث واجهة المستخدم في الوقت الفعلي.
الحدود والأخطاء ونافذة السياق
تدعم نافذة السياق ما يصل إلى 100,000 رمز للموجّه والإكمال معًا. يجب ألا تتجاوز حمولة طلبك 8 ميجابايت. أنت مقيد بـ 300 طلب في الدقيقة و8 طلبات متزامنة لكل مفتاح. إذا استنفدت رصيدك المسبق الدفع، يرفض API المزيد من الطلبات. تعيد فشل المصادقة خطأ 401، وتؤدي حدود المعدل إلى استجابة 429. تأكد من معالجة تطبيقك لهذه الأخطاء بسلاسة للحفاظ على تجربة مستخدم سلسة أثناء فترات الازدحام.
cURL
curl https://api.nsfwchat.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.nsfwchat.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.nsfwchat.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)المواصفات التقنية
كل الحدود والميزات الفعلية للـ API في مكان واحد — راجعها قبل شحن الرصيد.
| البند | القيمة |
|---|---|
| صيغة API | متوافق مع OpenAI: يعمل أي SDK من OpenAI بتغيير base URL والمفتاح فقط |
| معرّف النموذج | uncensored |
| نقاط النهاية | POST /v1/chat/completions · GET /v1/models |
| المصادقة | Authorization: Bearer YOUR_KEY |
| Base URL | https://api.nsfwchat.top/v1 |
| المعاملات | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| نافذة السياق | 100,000 رمز (المدخلات والمخرجات معاً) |
| البث المتدفق | نعم — server-sent events؛ آخر جزء يتضمن استهلاك الرموز |
| استدعاء الدوال | نعم — tools و tool_choice؛ الرد يتضمن tool_calls حتى أثناء البث؛ تُرسل النتائج كرسالة role: tool |
| وضع JSON | response_format: {"type": "json_object"} |
| أقصى مخرجات | حتى ما تبقى من نافذة 100,000 رمزًا؛ max_tokens اختياري (بلا حد منفصل) |
| ترويسات الرد | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| حدّ المعدل | 300 طلب في الدقيقة لكل مفتاح |
| حجم الطلب | حتى 8 MB |
| الطلبات المتزامنة | حتى 8 في الوقت نفسه لكل مفتاح |
| شحن الرصيد | USDT (TRC20) أو USDC (Base)، أي مبلغ صحيح من $10 إلى $500 |
| رصيد تجريبي مجاني | $0.50 لمدة 7 أيام، بدون بطاقة · مفتاح تجريبي: طلبان متوازيان، 60 طلبًا في الدقيقة؛ الحدود الكاملة (8 و300) بعد أول شحن |
| الفوترة | رصيد مسبق الدفع حسب الاستهلاك الفعلي؛ الأخطاء والرفض مجانية |
| مكافأة | +5% من $50، +10% من $100 |
| السعر | $0.25 لكل مليون رمز مدخلات · $1.00 لكل مليون رمز مخرجات |
| الصلاحية | الرصيد المدفوع لا تنتهي صلاحيته، بدون اشتراك |
| المفاتيح | مفتاح نشط واحد لكل حساب؛ المفتاح الجديد يحل محل القديم |
| تسجيل الدخول | Google أو البريد الإلكتروني وكلمة المرور |
| المحتوى | محتوى البالغين مسموح؛ يُرفض أي محتوى جنسي يتعلق بالقاصرين |
رموز الأخطاء
تصل الأخطاء بصيغة JSON مع type ثابت؛ الطلبات الفاشلة أو المرفوضة لا تُحتسب.
| الرمز | النوع | المعنى |
|---|---|---|
400 | bad_request | JSON غير صالح أو رسائل فارغة أو معامل خاطئ أو تجاوز نافذة السياق |
401 | missing_key · invalid_key · key_revoked | لا يوجد مفتاح أو المفتاح خاطئ أو تم استبداله |
402 | no_credit | الرصيد فارغ — اشحن وتستأنف الطلبات فوراً |
403 | content_blocked | محتوى جنسي يتعلق بقاصرين — مرفوض دون احتساب |
404 | not_found | نقطة نهاية غير معروفة |
413 | request_too_large | جسم الطلب أكبر من 8 MB |
429 | rate_limited · concurrency | تجاوز 300 في الدقيقة أو 8 متزامنة — انتظر ثم أعد المحاولة |
503 | upstream_busy | النموذج مشغول — أعد المحاولة بعد ثوانٍ |
أسئلة وأجوبة
ما معرّف النموذج الذي يجب استخدامه؟
استخدم معرّف النموذج <code>uncensored</code>. هذا نموذج مفتوح الأوزان مستضاف على خوادمنا، ومختلف عن GPT أو Claude أو نماذج البائعين الآخرين.
هل يدعم API استدعاء الدوال؟
نعم، يدعم API استدعاء الدوال (الأدوات وtool_choice) بالإضافة إلى وضع JSON للمخرجات المهيكلة. يمكنك تعريف الأدوات في حمولة الطلب.
هل يوجد فلتر محتوى للبالغين؟
ينطبق حد محتوى صارم: يتم رفض الطلبات التي تحتوي على محتوى جنسي يتضمن قاصرين دائمًا، بغض النظر عن سياق الموجّه.
مفتاحك على بُعد نموذج واحد
أنشئ حسابًا، انسخ المفتاح، غيّر عنوان URL الأساسي. هذا هو الإعداد الكامل.