توثيق واجهة برمجة التطبيقات غير الخاضعة للرقابة

البدء السريع: أرسل طلبك الأول

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

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

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

تعتمد المصادقة على مفتاح API واحد يُمرر في الرأس. عنوان URL الأساسي هو HTTPS://api.unzensierte.cc/v1. يعمل هذا العنوان مع مكتبات OpenAI الرسمية عن طريق ضبط معلمة base_url. يحدد مفتاحك حسابك ويتتبع استخدام الرموز المميزة. أنشئ مفتاحًا من صفحة احصل على مفتاح API. يظهر فورًا بعد التسجيل عبر Google أو البريد الإلكتروني. استخدم هذا المفتاح في كل طلب. تُرجع المفاتيح غير الصالحة خطأ 401. تُرجع المفاتيح منتهية الصلاحية أو غير الكافية للرصيد خطأ 402.

احفظ مفتاحك بأمان. مفتاح واحد نشط لكل حساب. يستبدل المفتاح الجديد المفتاح القديم. لا يتطلب التسجيل إدخال رقم الهاتف. مفتاح API هو الاعتماد الوحيد المطلوب للوصول.

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

النقطة النهائية الأساسية هي POST /v1/chat/completions. تقبل حمولات JSON مع النموذج، الرسائل، والمعلمات. معرف النموذج هو "uncensored". تتطلب الرسائل دورًا وسلسلة نصية للمحتوى. يستجيب النظام بنص مُولد في مصفوفة الاختيارات (choices). يمكنك ضبط درجة الحرارة (temperature)، و top_p، وتسلسلات التوقف (stop sequences). تتحكم هذه المعلمات في الإبداع وطول المخرجات. تعيد الـ API استخدام الرموز (tokens) في الاستجابة. تشمل الأخطاء رسالة ونوعًا. استخدم هذه النقطة النهائية لجميع مهام توليد النص. إنها النقطة النهائية الوحيدة للنص. لا توجد هنا استخلاص للبيانات (embeddings) أو توليد صور.

الاستجابات التدفقية والاستخدام

فعّل التدفق عن طريق تعيين stream إلى true. ترسل واجهة برمجة التطبيقات أحداث الإرسال من الخادم (SSE). يحتوي كل جزء على نص جزئي. يتضمن الجزء الأخير بيانات استخدام الرمز. يتيح ذلك العرض الفوري للنص المُولَّد. قم بتخزين الأجزاء في تطبيقك. ادمجها لتشكيل الاستجابة الكاملة. يقلل التدفق من زمن الاستجابة المُدرَك للمخرجات الطويلة. استخدمه لواجهات الدردشة أو معالجة البيانات المباشرة. يظهر كائن الاستخدام فقط في الجزء الأخير. تتبع رموز الإدخال والإخراج للفوترة. لا تزال الأخطاء أثناء التدفق تُرجع كائن الخطأ في جزء.

استدعاء الوظائف ووضع JSON

استخدم استدعاء الوظائف لتكامل الأدوات الخارجية. عرّف الأدوات في جسم الطلب. يعيد النموذج استدعاءات الأدوات مع المعاملات. قم بتحليل هذه المعاملات لتنفيذ دوالك. اضبط tool_choice على auto أو أسماء دوال محددة. يفرض وضع JSON المخرجات كـ JSON صالح. اضبط response_format على json_object. هذا يضمن بيانات منظمة للتحليل. استخدم هذه الميزات لسير العمل الآلي. اجمع بينها لسلوكيات الوكلاء المعقدة. يدعم النموذج تنسيقات الأدوات القياسية من OpenAI. تحقق من مطابقة تعريفات أدواتك للمخطط المتوقع.

الحدود ومعالجة الأخطاء

حدود المعدلات هي 300 طلب في الدقيقة لكل مفتاح. التزامن محدود بـ 8 طلبات متزامنة. يجب أن تكون أحجام الطلبات أقل من 8 ميجابايت. تشمل الأخطاء أكوادًا محددة مثل 401 للمفاتيح غير الصالحة. يشير 402 إلى عدم كفاية الرصيد المدفوع مسبقًا. يشير 429 إلى تجاوز حد المعدل. نافذة السياق هي 100,000 رمز إجماليًا. الحد الأقصى للمخرجات هو 16,000 رمز لكل طلب. تعيد الأخطاء JSON مع تفاصيل الخطأ. تعامل مع إعادة المحاكمة لأخطاء 429. تحقق من رصيد الائتمان قبل الاستخدام الثقيل. لا تتوفر استرداد الأموال للرصيد المستنفد.

cURL

Copycurl https://api.unzensierte.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List 5 common Linux commands for file management"}]
  }'

Python

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

التدفق

Copystream = 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)