الرئيسية/التوثيق
توثيق Uncensored API: دليل البدء السريع
ابدأ باستخدام API بدون رقابة عبر المصادحة بمفتاحك وإرسال الطلبات إلى نقطة النهاية chat-completions. يغطي هذا الدليل عنوان URL الأساسي، وتكامل SDK، والبث المتدفق، وحدود النموذج بدون رقابة.
https://api.uncensoredapis.com/v1uncensored
عنوان URL الأساسي والمصادقة
تواصل مع واجهة برمجة تطبيقات LLM غير الخاضعة للرقابة باستخدام عنوان URL الأساسي المتوافق مع OpenAI: https://api.uncensoredapis.com/v1. تتم المصادقة عبر رأس Authorization. يجب أن تتضمن مفتاح API الخاص بك كرمز حامل. يتم إنشاء المفتاح مباشرة بعد تسجيل حسابك في صفحة الحصول على مفتاح API. احفظ هذا المفتاح بأمان؛ يمكن تجديده في أي وقت، مما يلغي المفتاح القديم. لا حاجة لبطاقة ائتمان للبدء، ويتوفر رصيد تجريبي مجاني للحسابات الجديدة.
curl https://api.uncensoredapis.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."}]
}'يجب أن يستهدف كل طلب نقطة النهاية /v1/chat/completions. هذا API للنصوص فقط. لا توجد نقاط نهاية للتضمين أو الصور أو الصوت أو الفيديو. يظل عنوان URL الأساسي ثابتًا بغض النظر عن خطتك. استخدم رؤوس HTTP القياسية لنوع المحتوى والمصادقة. يعمل هذا الإعداد مع أي عميل متوافق مع OpenAI من خلال تحديث تكوين عنوان URL الأساسي فقط.
معرف النموذج والطلب الأول
حدد معرف النموذج على أنه uncensored في جسم الطلب. هذا النموذج هو نموذج لغة كبير مفتوح الأوزان يعمل على خوادم GPU الخاصة بنا، ومضبط للإجابة دون رفض المحتوى للاستخدام القانوني للبالغين. إنه ليس GPT أو Claude أو أي نموذج من مورد آخر. تبلغ نافذة السياق 100,000 رمز (token)، وتغطي كلًا من الموجّه والإكمال. تدعم هذه النافذة الكبيرة حالات الاستخدام الخاصة بـ API LLM للبالغين التي تتطلب الاحتفاظ بالسياق الطويل.
from openai import OpenAI
client = OpenAI(base_url="https://api.uncensoredapis.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)يقبل API معايير إكمال الدردشة القياسية. أرسل رسائلك بتنسيق قائمة. يعيد الاستجابة النص المولد. لا يوجد توجيه للنماذج؛ نحن نقدم نموذجًا مخصصًا واحدًا. يضمن ذلك سلوكًا متسقًا. تحقق من صفحة الأسعار لمعرفة تكلفة الرموز (token). يتعامل النموذج مع المواضيع المثيرة للجدل أو للبالغين دون رفض قياسي، باستثناء الحد الصارم على المحتوى الجنسي الذي ينطوي على قاصرين.
استجابات البث المتدفق (SSE)
فعّل البث المتدفق عن طريق تعيين stream: true في طلبك. تدعم نقطة النهاية أحداث الإرسال من الخادم (SSE) لتسليم الرموز في الوقت الفعلي. هذا مفيد لواجهات الدردشة حيث تريد عرض النص أثناء إنشائه. لا تُرجع واجهة برمجة التطبيقات غير الخاضعة للرقابة بيانات البث المتدفق افتراضيًا في المكالمة المتزامنة؛ يجب أن تطلبها صراحةً. يعمل البث المتدفق مع نفس معرف النموذج والمصادقة. إنه فعال لتطبيقات واجهة برمجة التطبيقات للذكاء الاصطناعي NSFW التي تحتاج إلى نتائج جزئية فورية. راقب تدفق البيانات لمعرفة متى ينتهي الرد.
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 وعنوان URL الأساسي كما هما. تنطبق حدود المعدل على إجمالي حجم الطلب، وليس فقط حجم استجابة البث المتدفق.
دعم استدعاء الأدوات/الدوال
يدعم API استدعاء الأدوات/الدوال للإخراجات المهيكلة. عرّف الأدوات في جسم الطلب مع أسماءها ووصفها ومخططات المعاملات. يعيد النموذج بيانات JSON المهيكلة جنبًا إلى جنب مع النص عندما يقرر استخدام أداة. هذا يختلف عن استجابات النص الخام. استخدم المعلمة tools في نقطة النهاية chat-completions. أعد تمرير مخرجات الأدوات إلى النموذج في الدوران اللاحق. يمكّن ذلك سير العمل المعقد دون منطق تحليل خارجي. يتعامل النموذج بدون رقابة مع تعريفات الدوال بشكل موثوق.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.uncensoredapis.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);هيكل تعريفات الأدوات وفقًا لمخطط OpenAI. يعيد API حجج استدعاء الأداة بتنسيق JSON. قم بتحليل هذه الحجج في كودك لتنفيذ الدالة المطلوبة. ثم أرسل النتيجة مرة أخرى إلى النموذج. يستمر هذا الدورة حتى يولد النموذج استجابة نصية نهائية. هذه الميزة متاحة في خطة رصيد مسبق الدفع نفسها. لا رسوم إضافية لاستخدام الأدوات.
حدود المعدل وحجم الجسم
يُقتصر كل مفتاح API على 300 طلب في الدقيقة. الحد الأقصى لحجم جسم الطلب هو 8 ميجابايت. يؤدي تجاوز هذه الحدود إلى إرجاع رموز حالة HTTP محددة. يشير خطأ 401 إلى مفتاح API غير صالح أو مفقود. يعني خطأ 402 أن رصيدك المسبق للدفع غير كافٍ. يشير خطأ 429 إلى أنك تجاوزت حدّ المعدل. قلل من وتيرة طلباتك أو انتظر حتى يتم إعادة تعيين النافذة. تنطبق هذه الحدود على كل مفتاح، وليس على الحساب. قم بتجديد مفتاحك للحصول على بداية جديدة إذا لزم الأمر.
تبلغ نافذة السياق 100,000 رمز (token). تأكد من أن الموجّه والإكمال المجمعين يتناسبان ضمن هذا الحد. قد يتم اقتصاص المدخلات الكبيرة أو رفضها إذا تجاوزت حد حجم الجسم. راقب استخدامك في لوحة التحكم. يعني نموذج رصيد مسبق الدفع أنك تدفع فقط مقابل ما تستخدمه. لا رسوم شهرية أو اشتراكات. لا تنتهي صلاحية الرصيد أبدًا.
الأسعار والرصيد
تستخدم واجهة برمجة التطبيقات غير الخاضعة للرقابة نموذج رصيد مسبق الدفع بسيط. تكلف الرموز المدخلة 0.25 دولار لكل مليون رمز. تكلف الرموز المخرجة 1.00 دولار لكل مليون رمز. لا توجد رسوم شهرية أو اشتراكات. لا تنتهي صلاحية الرصيد المدفوع. يمكنك شحن الرصيد من 10 دولارات باستخدام العملات المشفرة (USDT أو USDC). تتوفر رصيد تجريبي مجاني إضافي: +5% للطلبات التي تزيد عن 50 دولارًا و+10% للطلبات التي تزيد عن 100 دولار. تتلقى الحسابات الجديدة 0.50 دولار كرصيد تجريبي مجاني لمدة 7 أيام، دون الحاجة إلى بطاقة. هذا النموذج مثالي لحالات الاستخدام عالية الحجم لواجهة برمجة التطبيقات للذكاء الاصطناعي NSFW.
تحقق من رصيدك في لوحة التحكم. يتم خصم الرصيد تلقائيًا مع كل طلب. غالبًا ما تستخدم بدائل نماذج openrouter بدون رقابة أسعارًا مختلفة؛ يقدم نموذجنا المباشر تكاليف متوقعة. استخدم مفتاح API للمصادقة على جميع الطلبات. يظل عنوان URL الأساسي نفسه لجميع الفئات. لا رسوم خفية للبث المتدفق أو استدعاء الأدوات. تتبع استخدامك لتجنب الرسوم غير المتوقعة.
المواصفات التقنية
كل الحدود والميزات الفعلية للـ API في مكان واحد — راجعها قبل شحن الرصيد.
| البند | القيمة |
|---|---|
| صيغة API | متوافق مع OpenAI: يعمل أي SDK من OpenAI بتغيير base URL والمفتاح فقط |
| معرّف النموذج | uncensored |
| نقاط النهاية | POST /v1/chat/completions · GET /v1/models |
| Base URL | https://api.uncensoredapis.com/v1 |
| المصادقة | Authorization: Bearer YOUR_KEY |
| استدعاء الدوال | نعم — tools و tool_choice؛ الرد يتضمن tool_calls حتى أثناء البث؛ تُرسل النتائج كرسالة role: tool |
| أقصى مخرجات | حتى ما تبقى من نافذة 100,000 رمزًا؛ max_tokens اختياري (بلا حد منفصل) |
| البث المتدفق | نعم — server-sent events؛ آخر جزء يتضمن استهلاك الرموز |
| نافذة السياق | 100,000 رمز (المدخلات والمخرجات معاً) |
| وضع JSON | response_format: {"type": "json_object"} |
| المعاملات | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| حدّ المعدل | 300 طلب في الدقيقة لكل مفتاح |
| الطلبات المتزامنة | حتى 8 في الوقت نفسه لكل مفتاح |
| حجم الطلب | حتى 8 MB |
| ترويسات الرد | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| رصيد تجريبي مجاني | $0.50 لمدة 7 أيام، بدون بطاقة · مفتاح تجريبي: طلبان متوازيان، 60 طلبًا في الدقيقة؛ الحدود الكاملة (8 و300) بعد أول شحن |
| شحن الرصيد | USDT (TRC20) أو USDC (Base)، أي مبلغ صحيح من $20 إلى $500 |
| الفوترة | رصيد مسبق الدفع حسب الاستهلاك الفعلي؛ الأخطاء والرفض مجانية |
| الصلاحية | الرصيد المدفوع لا تنتهي صلاحيته، بدون اشتراك |
| مكافأة | +5% من $50، +10% من $100، +15% من $200 |
| السعر | $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 | النموذج مشغول — أعد المحاولة بعد ثوانٍ |
أسئلة وأجوبة
ما هو حجم نافذة السياق؟
تبلغ نافذة السياق 100,000 رمز (token)، وتغطي كلًا من الموجّه والإكمال. يتيح ذلك إجراء محادثات طويلة أو معالجة مستندات ضخمة ضمن طلب واحد.
هل يدعم API بدون رقابة البث المتدفق؟
نعم، يدعم البث المتدفق عبر أحداث Server-Sent Events (SSE). يجب ضبط المعلمة stream على true في طلبك. يمكّن ذلك تسليم الرموز (token) في الوقت الفعلي لواجهات الدردشة.
ماذا يحدث إذا نفد رصيدك؟
ستتلقى رمز حالة HTTP 402 يشير إلى عدم وجود رصيد. قم بشحن الرصيد من لوحة التحكم لاستئناف الاستخدام. لا تنتهي صلاحية الرصيد أبدًا، لذا يمكنك إضافة الأموال عند الحاجة.
مفتاحك على بُعد نموذج واحد
أنشئ حسابًا، وانسخ المفتاح، وغير عنوان URL الأساسي. هذا هو الإعداد الكامل.