Uncensored Model API Quickstart

المتطلبات الأساسية: مفتاح API وعنوان URL الأساسي

سجّل واحصل على مفتاح API الخاص بك فوراً عبر Google أو البريد الإلكتروني دون التحقق من الهاتف. عنوان URL الأساسي هو HTTPS://api.apimodel.cc/v1، وهو متوافق مع أي عميل قياسي متوافق مع OpenAI من خلال تحديث معلمة base_url. تتلقى مفتاحاً نشطاً واحداً لكل حساب يستبدل المفتاح السابق عند إنشائه.

تأكد من أن لديك رصيد كريبتو مدفوع مسبقاً أو استخدم رصيد التجربة بقيمة $0.50 الصالح لمدة 7 أيام. ستحتاج إلى هذا المفتاح لمصادقة طلباتك على API النموذج غير الخاضع للرقابة.

إرسال طلبك الأول إلى واجهة برمجة تطبيقات النموذج

أرسل طلب POST إلى /v1/chat/completions مع ضبط معرف النموذج على "uncensored". تقبل هذه النقطة إدخال النص وتُرجع مخرجات نصية دون رفض المحتوى للمحتوى البالغ القانوني. يمتلك النموذج نافذة سياق بحجم 100,000 رمز، مما يسمح بأحجام كبيرة للسياق.

Copycurl https://api.apimodel.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the capital of Australia?"}]
  }'

يشمل الرد النص المُولّد في مصفوفة الخيارات. يتم احتساب الرسوم عليك فقط مقابل استخدام الرموز الحقيقي، مع كون الأخطاء والرفض مجانيًا. يضمن هذا النهج المباشر فواتير متوقعة بدون رسوم اشتراك مخفية.

تكوين المعلمات: درجة الحرارة، Top P، والبذرة

عدّل درجة الحرارة للتحكم في العشوائية، وtop_p للعينة النووية، والبذرة للحصول على مخرجات قابلة للتكرار. تتيح هذه المعلمات ضبط سلوك النموذج غير الخاضع للرقابة بدقة لحالات استخدام محددة مثل البرمجة أو الكتابة الإبداعية. يضمن تحديد قيمة للبذرة الحصول على نتائج متسقة عبر الطلبات المتعددة، وهو أمر حاسم أثناء تصحيح الأخطاء.

تدعم واجهة برمجة التطبيقات معاملات قياسية مثل presence_penalty وfrequency_penalty. استخدمها للتحكم في التكرار وضبق بقاء النموذج في الموضوع. قم بتكوين هذه الإعدادات في جسم الطلب لضبط نمط الاستجابة بدقة.

تمكين التدفق وقراءة استخدام الرموز

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

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)

عالج أحداث التدفق في كود العميل لتحديث واجهة المستخدم تدريجياً. يوفر API النموذج غير الخاضع للرقابة النص باستمرار، مما يحسن تجربة المستخدم لتطبيقات الدردشة. التدفق اختياري ولكن يوصى به للتطبيقات التفاعلية.

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

استخدم استدعاء الوظائف مع معلمة الأدوات لتمكين النموذج من توليد بيانات مهيكلة. تدعم هذه الميزة tool_choice وتسمح للنموذج بتنفيذ إجراءات محددة بناءً على المدخلات. يضمن وضع JSON عبر response_format json_object إخراج JSON صارم لسهولة التحليل.

Copyimport OpenAI from "openai";

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

عرّف مخططات الدوال الخاصة بك في الطلب لتوجيه هيكل إخراج النموذج. هذهCapability ضرورية لبناء سير عمل وكيلي أو التكامل مع واجهات برمجة التطبيقات الخارجية. يتعامل النموذج غير الخاضع للرقابة مع تعريفات الأدوات المعقدة دون رفضات محتوى.

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

راقب رموز حالة HTTP للأخطاء الشائعة: 401 للمفاتيح غير الصالحة، و402 لعدم كفاية الرصيد، و429 لحدود المعدل. تفرض واجهة برمجة التطبيقات 300 طلب في الدقيقة لكل مفتاح و8 طلبات متزامنة. يجب أن يكون جسم كل طلب أقل من 8 ميجابايت.

الحد الأقصى للإخراج هو 16,000 رمز مميز لكل طلب، مع افتراضي قدره 2,048 إذا لم يتم تعيين max_tokens. الأخطاء مجانية، لذا لا تستهلك الطلبات الفاشلة رصيدك المسبق الدفع. استخدم هذه الحدود لتصميم منطق إعادة المحاولة القوي لتطبيقك.

Python

Copyfrom openai import OpenAI

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