البدء السريع: واجهة برمجة تطبيقات نموذج غير مقيد

المتطلبات الأساسية وعنوان URL الأساسي

تعمل واجهة برمجة التطبيقات (API) لدينا مع أي عميل متوافق مع OpenAI القياسي عن طريق تحديث عنوان URL الأساسي ومفتاح API. وجه SDK الخاص بك إلى https://api.modeluncensored.com/v1 وأرسل طلبات إلى المعيار /v1/chat/completions endpoint. لا تحتاج إلى تثبيت مكتبات مملوكة؛ تعمل الأدوات الموجودة مثل SDK OpenAI الرسمي لـ Python أو Node.js فوراً. فقط قم بتكوين عنوان URL الأساسي لتوجيه حركة المرور عبر خوادمنا بدلاً من بنية OpenAI الافتراضية.

المصادقة تعتمد على مفتاح API واحد يتم إنشاؤه أثناء التسجيل. مرر هذا المفتاح في Authorization رأس الصفحة كرمز حامل (Bearer token). معرف النموذج ثابت عند uncensored لضمان سلوك متسق عبر جميع الطلبات. يوفر كل حساب مفتاحاً نشطاً واحداً يحل محل أي مفتاح سابق عند تجديده.

المصادقة باستخدام مفتاح API الخاص بك

تضمين مفتاح API الخاص بك في Authorization الرأس من كل طلب للتحقق من هويتك. استخدم التنسيق Authorization: Bearer YOUR_API_KEY للمصادقة على الطلبات على الفور. إذا كان المفتاح مفقودًا أو غير صالح، فإن واجهة برمجة التطبيقات تُرجع خطأ 401 غير مصرح به على الفور. يضمن ذلك أن الحسابات الصالحة فقط هي التي يمكنها استهلاك الرموز المميزة من رصيدك المدفوع مسبقًا.

يمكنك إنشاء أو تجديد مفتاحك عبر لوحة التحكم بعد تسجيل الدخول باستخدام Google أو البريد الإلكتروني. يظهر المفتاح على الفور عند الإنشاء. احفظه بأمان، لأنه يوفر وصولاً مباشراً إلى رصيد حسابك. لا توجد حاجة للتحقق من رقم الهاتف للتسجيل، مما يجعل العملية سريعة وبسيطة.

إرسال أول إكمال دردشة لك

أجرِ طلب POST إلى /v1/chat/completions مع رسائلك ومعرف النموذج لاستقبال استجابة. يقبل النموذج مدخلات النص ويعيد مخرجات النص بدون رفضات ناعمة للمحتوى البالغ القانوني. يمكنك تحديد معرف النموذج كـ uncensored لضمان استخدام نموذج الذكاء الاصطناعي غير الخاضع للرقابة المحدد لدينا. تدعم نقطة النهاية هذه كلًا من الاستجابات المتزامنة والمتدفقة للمرونة.

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

معالجة استجابات التدفق (SSE)

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

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

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

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

يدعم النموذج المعلمات القياسية مثل stop sequences و presence_penalty للتحكم المتقدم. يمكنك دمج هذه الإعدادات لتحقيق النبرة والهيكل المطلوبين. جرب قيمًا مختلفة للعثور على التوازن الأمثل بين الإبداع والتماسك لتطبيقك.

باستخدام الأدوات ووضع JSON

تمكين استدعاء الوظائف بتقديم tools مصفوفة في طلبك للسماح للنموذج بإخراج بيانات مهيكلة. يمكن للنموذج استدعاء الدوال بناءً على سياق المحادثة، مما يتيح عمليات عمل معقدة. استخدم response_format: {"type": "json_object"} لفرض إخراج النموذج بصيغة JSON صالحة. هذا مثالي للتكامل مع أنظمة الخلفية أو استخراج المعلومات المهيكلة من النص.

يضمن وضع JSON أن تكون الاستجابة قابلة للتحليل، مما يقلل من الحاجة إلى منطق تحليل إضافي في العميل. يمكنك تعريف أدوات متعددة وتحديد الأداة التي يجب أن يستدعيها النموذج. تعزز هذه الميزة فائدة النموذج للمهام الآلية واستخراج البيانات. تتعامل الـ API مع توجيه استدعاءات الأدوات بسلاسة.

cURL

Copycurl https://api.modeluncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Return the current system time in ISO format"}]
  }'

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

التدفق

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)