البدء السريع: توصيل الكود الخاص بك

الإعداد والتكوين

يصادق مفتاح واجهة برمجة التطبيقات (API) على طلباتك. أنشئ واحدًا فورًا عبر لوحة التحكم باستخدام Google أو البريد الإلكتروني وكلمة المرور. لا يلزم رقم هاتف. احفظ المفتاح في متغيرات البيئة الخاصة بك. يمنح الوصول إلى النموذج غير الخاضع للرقابة الوحيد. يمكنك استبدال مفتاح إذا لزم الأمر، لكن واحدًا فقط يبقى نشطًا في كل مرة. يوجه عنوان URL الأساسي حركة المرور إلى خوادمنا. يعمل مع أي مكتبة عميل متوافقة مع OpenAI. غيّر base_url معامل لتشير إلى هنا. يلغي ذلك منطق الوكيل أو التوجيه المعقد. يتم احتساب طلباتك واستجاباتك ضد رصيدك المدفوع مسبقًا. الأخطاء لا تستهلك الرموز. يضمن ذلك دفعك فقط مقابل التوليد الفعلي.

إجراء أول إكمال للدردشة

أرسل طلب POST إلى /v1/chat/completions مع معرف النموذج الخاص بك. استخدم "uncensored" كقيمة النموذج. ضمّن رسائل النظام والمستخدم في messages مصفوفة. تعيد واجهة برمجة النص المُولّد. لا تحجب مرشحات المحتوى مواضيع البالغين القانونيين. يمكنك ضبط المعلمات مثل temperature أو top_p. تتحكم هذه الإعدادات في العشوائية والإبداع. اضبط max_tokens لتحديد طول المخرجات. الحد الأقصى الافتراضي هو 2,048 رمزاً ما لم يُحدد خلاف ذلك. يمكنك تمديد هذا الحد ليصل إلى 16,000 رمز. يدعم نافذة السياق إجمالي 100,000 رمز. يتيح ذلك لعب الأدوار الطويل والمفصل. حافظ على طلباتك دون 8 ميجابايت. يضمن هذا الحد أداءً مستقماً للحزم الكبيرة.

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

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

استخدام استدعاء الوظائف والأدوات

عرّف الأدوات في طلبك لتمكين استدعاء الوظائف. يمكن للنموذج إرجاع بيانات مهيكلة لتطبيقك. حدد tool_choice للتحكم في سلوك الاستدعاء. استخدم "auto" للاختيار التلقائي. مرر تعريفات الأدوات في tools مصفوفة. يستجيب النموذج باستدعاءات الوظائف عند الاقتضاء. تنفذ الوظيفة وترسل النتيجة مرة أخرى. يستمر النموذج في المحادثة بناءً على الإخراج. يدعم هذا المنطق المعقد في روبوهات لعب الأدوار. يمكنك تعريف أدوات متعددة لأجراءات مختلفة. تتعامل واجهة برمجة التطبيقات مع التحليل والتوجيه. تأكد من أن مخططات الأدوات الخاصة بك صالحة بصيغة JSON. يمنع ذلك الأخطاء أثناء عملية استدعاء الوظائف.

فرض وضع JSON

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

حدود، أخطاء، ونافذة السياق

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

cURL

Copycurl https://api.restrictionsnoai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List three spicy dialogue lines for a vampire character"}]
  }'

Python

Copyfrom openai import OpenAI

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