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

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

توصيل إلى API LLM غير цензور الخاص بنا باستخدام عنوان URL الأساسي المتوافق مع OpenAI القياسي. يقوم مفتاح API الخاص بك بمصادقة كل طلب، لذا احتفظ به آمنًا ولكن في متناول تطبيقك. نستخدم رأسًا بسيطًا للتحقق، مما يضمن وصول مطالباتك إلى النموذج دون احتكاك.

Copycurl https://api.modelsaiuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list all available endpoint urls"}]
  }'

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

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

أرسل الرسائل إلى نموذج "uncensored" عبر نقطة نهاية إكمال الدردشة القياسية. تتعامل هذه النقطة مع تفاعلات النص الداخل/الخارجي مع نافذة سياق تتسع لـ 100,000 رمز. يمكنك تضمين تعليمات النظام لتحديد السلوك، أو فقط إرسال رسائل المستخدم للتفاعل المباشر.

Copyfrom openai import OpenAI

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

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

استجابات البث (SSE)

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

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)

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

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

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

Copyimport OpenAI from "openai";

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

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

حدود المعدلات والقيود

تفرض واجهة برمجة التطبيقات (API) لدينا حدودًا صارمة لضمان الاستقرار لجميع المستخدمين. يُسمح لك بـ 300 طلبًا في الدقيقة و8 طلبات متزامنة لكل مفتاح. يجب أن يكون حجم كل طلب للجسم أقل من 8 ميجابايت لمنع مشاكل الحمولات المفرطة. تنطبق هذه الحدود على كل مفتاح API، لذا وزع الحمل عبر المفاتيح إذا لزم الأمر.

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

حدود نافذة السياق والمخرجات

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

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