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

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

يصادق مفتاح واجهة برمجة التطبيقات (API) على كل طلب. أنشئه عبر لوحة التحكم باستخدام بيانات اعتماد Google أو البريد الإلكتروني. مرره في Authorization رأس الصفحة كرمز حامل (Bearer token).

• URL الأساسي: https://api.unrestrictedlocalaimodels.com/v1
• رأس: Authorization: Bearer YOUR_API_KEY

لا ينطبق إرهاق الاشتراكات أو دورات الفواتير الشهرية. الرصيد مدفوع مسبقاً ولا ينتهي.

نقطة نهاية /v1/chat/completions

أرسل طلب محادثة قياسي لتوليد النص دون منطق رفض المحتوى.

تقبل نقطة النهاية نفس هيكل JSON الخاص بـ OpenAI. اضبط model إلى uncensored. يعالج النظام مدخلاتك ويعيد المخرجات الخام.

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

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

استخدم مكتبة بايثون الرسمية من OpenAI. وجهها إلى عنوان URL الأساسي الخاص بنا.

يتيح لك الاستفادة من الأكواد الموجودة. تتعامل المكتبة مع تسلسل JSON تلقائياً.

تعيين api_key مفتاحك. اضبط base_url نقطة النهاية. مرر model="uncensored" في طلبك.

تكامل SDK Node.js

قم بتهيئة عميل OpenAI بعنوان URL الأساسي الخاص بنا. يعمل هذا مع أي حزمة SDK متوافقة.

قم بتكوين كائن العميل. مرر مفتاح API الخاص بك. تدير المكتبة دورة حياة الطلب.

استدعاء chat.completions.create(). تعيين معرف النموذج. استلم كائن الاستجابة الذي يحتوي على النص المُولّد.

استجابات البث واستهلاك الرموز

فعّل البث عن طريق تعيين stream: true. يرسل الخادم أحداث الحدث المرسلة من الخادم.

يظهر بيانات استهلاك الرموز في الشريحة الأخيرة. هذا يسمح بتتبع الفوترة بدقة.

تعامل مع التحديثات الجزئية. حدّث واجهة المستخدم الخاصة بك في الوقت الفعلي. ينتهي دفق SSE بشكل نظيف.

معالجة الأخطاء وحدود المعدل

تُطبق حدود المعدلات لكل مفتاح. يمكنك إرسال 300 طلب في الدقيقة. التزامن محدود بـ 8 طلبات متزامنة.

يشير رمز الحالة 401 إلى مفتاح غير صالح. يشير رمز الحالة 402 إلى عدم كفاية الرصيد. يشير رمز الحالة 429 إلى تحديد معدل الطلبات.

نافذة السياق هي 100,000 رمز. الإخراج محدود بـ 16,000 رمز. يجب أن تبقى أحجام طلبات الجسم أقل من 8 ميجابايت.

cURL

Copycurl https://api.unrestrictedlocalaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the three main dependencies for this rust crate"}]
  }'

Python

Copyfrom openai import OpenAI

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