توثيق واجهة برمجة التطبيقات: النموذج غير الخاضع للرقابة

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

استخدم عنوان URL الأساسي المخصص لجميع الطلبات. تتعامل هذه النقطة النهائية مع توليد النص واسترداد البيانات الوصفية. يصادق مفتاح API الخاص بك على كل استدعاء.

تضمين المفتاح في Authorization الرأس. يتطلب التنسيق Bearer البادئة. المفاتيح غير الصالحة تعيد رمز حالة 401 على الفور. لا تخمن تنسيق الرمز. استخدم المفتاح المعروض بعد التسجيل.

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

أرسل الرسائل لتوليد استجابات نصية. تقبل نقطة النهاية حمولات JSON قياسية. عرّف أدوار النظام والمستخدم بوضوح.

هيكل طلبك مع model field مضبوطًا إلى uncensored. يعالج API المدخلات ويعيد النص المولد. تعيد الأخطاء حالة 402 إذا كان الرصيد غير كافٍ. تطلق حدود المعدل استجابة 429.

المعلمات المدعومة

تحكّم في سلوك التوليد باستخدام المعاملات القياسية. اضبط temperature للإبداع أو الحتمية. استخدم top_p لتصفية الرموز منخفضة الاحتمال. اضبط max_tokens لتحديد طول المخرجات. الحد الأقصى الافتراضي هو 2,048 رمزاً ما لم يُحدد خلاف ذلك.

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

البث وأحداث الإرسال الخادم (SSE)

تمكين المخرجات في الوقت الفعلي عن طريق ضبط stream إلى true. يرسل الخادم أحداث الحدث المرسلة من الخادم (SSE) بينما يتم توليد الرموز المميزة. يقلل هذا من زمن الاستجابة المُدرَك للاستجابات الطويلة.

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

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

عرّف الأدوات في طلبك لتمكين استدعاء الوظائف. يقرر النموذج متى يستدعي أداة بناءً على السياق. مرر تعريفات الأدوات مع name, description، و parameters.

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

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

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

تسمح حدود معدل الطلبات بـ 300 طلب في الدقيقة لكل مفتاح. الحد الأقصى للطلبات المتزامنة هو 8 لكل مفتاح. يعني الخطأ 401 أن مفتاحك غير صالح. يشير الخطأ 402 إلى عدم كفاية الرصيد المدفوع مسبقاً. يشير الخطأ 429 إلى تجاوز حد معدل الطلبات. انتظر قبل إعادة المحاولة.

cURL

Copycurl https://api.toolcallingllms.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate 200 tokens of safe text"}]
  }'

Python

Copyfrom openai import OpenAI

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