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