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

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

ابدأ بتوجيه حزمة SDK الخاصة بك إلى عنوان URL الأساسي الخاص بنا وتمرير مفتاحك في رأس المصادقة. نقدم خدمة مباشرة لنموذج واحد دون رسوم توجيه الوكيل. استخدم المعيار Authorization: Bearer scheme للمصادقة على الطلبات. يتم إنشاء مفتاحك على الفور بعد التسجيل عبر Google أو البريد الإلكتروني. تأكد من استبدال مفتاح الحجز في تكوين العميل بالمفتاح المعروض على لوحة التحكم. عنوان URL الأساسي هو https://api.uncensoredmodelsollama.com/v1. تدعم نقاط النهاية هذه العملاء المتوافقين مع OpenAI، مما يتيح لك تغيير المزودين دون إعادة كتابة منطق التطبيق. احفظ مفتاحك بأمان، فهو يمنحك الوصول إلى رصيد الرصيد المدفوع مسبقاً.

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

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

استجابات البث

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

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

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

المعاملات وحدود معدل الطلب

اضبط سلوك التوليد باستخدام معلمات مثل temperature, top_p، و seed. تعيين max_tokens لتقييد طول المخرجات، مع افتراض 2,048 إذا لم يتم تحديدها. تفرض واجهة برمجة التطبيقات حدًا للسرعة قدره 300 طلب في الدقيقة لكل مفتاح. يتم تقييد الطلبات المتزامنة بـ 8 لكل مفتاح. إذا تجاوزت هذه الحدود، تُرجع واجهة برمجة التطبيقات رمز الحالة 429. تُحسب الطلبات بناءً على استخدام الرموز الفعلي، مع كون الأخطاء والرفض مجانيًا. لا تنتهي صلاحية الرصيد، والمبالغ المدفوعة مسبقًا شفافة. أدر مفاتيحك بعناية، حيث يدعم كل حساب مفتاحًا نشطًا واحدًا فقط في الوقت نفسه.

حدود، أخطاء، والسياق

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

cURL

Copycurl https://api.uncensoredmodelsollama.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List all available models in the ollama library."}]
  }'

Python

Copyfrom openai import OpenAI

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