توثيق واجهة برمجة التطبيقات

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

مفتاح واجهة برمجة التطبيقات الخاص بك يصادق على كل طلب. استخدم عنوان URL الأساسي https://api.modelsaiunrestricted.com/v1 لجميع المكالمات. قم بإنشاء مفتاحك في صفحة Get API Key عبر Google أو البريد الإلكتروني. يرفض النظام المفاتيح غير الصالحة بخطأ 401. احتفظ بمفتاحك بأمان.

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

أرسل الرسائل إلى uncensored عبر POST /v1/chat/completions. تتعامل نقطة النهاية هذه مع إدخال النص وتعيد إخراج النص. وهي متوافقة تماماً مع OpenAI.

Copyfrom openai import OpenAI

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

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

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

استلم الرموز (Tokens) في الوقت الفعلي باستخدام أحداث الإرسال من الخادم (SSE). فعّل البث عن طريق تعيين 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)

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

المعلمات: درجة الحرارة وTop P

تحكم في الإبداع باستخدام temperature والتنوع مع top_p. القيم الأقل تجعل المخرجات أكثر حتمية. القيم الأعلى تقدم المزيد من التنوع.

درجة الحرارة الافتراضية هي 1.0. top_p الافتراضي هو 0.9. عدل هذه القيم لألعاب الأدوار أو المهام الواقعية. يمكنك أيضاً تعيين seed لإنتاج نتائج قابلة لإعادة الإنتاج. استخدم stop تسلسلات لإيقاف التوليد مبكراً.

ترجع المعلمات غير الصالحة خطأ 400. تحقق من المخطط للمدى الصحيح.

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

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

Copyimport OpenAI from "openai";

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

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

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

حدود المعدلات هي 300 طلب في الدقيقة لكل مفتاح. التزامن محدود بـ 8 طلبات متزامنة. يجب أن تبقى أحجام الطلبات أقل من 8 ميجابايت. يؤدي تجاوز هذه الحدود إلى خطأ 429.

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

cURL

Copycurl https://api.modelsaiunrestricted.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top five open source models for local inference."}]
  }'