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

البدء السريع: التوصيل في 3 أسطر

تعمل واجهة برمجة التطبيقات (API) لدينا تماماً مثل واجهة chat-completions القياسية التي تعرفها بالفعل. ببساطة وجه عميلك إلى عنوان URL الأساسي الخاص بنا وقم بتوفير مفتاح API الخاص بك. لا توجد توجيهات معقدة أو غرائب خاصة بالبائع. نحن نتولى الباقي.

عنوان URL الأساسي لجميع الطلبات هو https://api.toolsaiuncensored.com/v1. يمكنك استخدام أي واجهة برمجة تطبيقات (SDK) رسمية أو مكتبة متوافقة عن طريق تحديث تكوين عنوان URL الأساسي. يعتمد المصادقة على رمز حامل (bearer token) واحد يتم توفيره عبر Authorization الرأس. يضمن هذا التكامل السلس مع البنية التحتية الحالية الخاصة بك.

Copycurl https://api.toolsaiuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "run unit tests on the legacy auth module"}]
  }'

نقاط النهاية: إكمال الدردشة والنماذج

نكشف فقط عن نقاط النهاية الأساسية لتوليد النص. ال POST /v1/chat/completions نقطة النهاية تعالج نصوصك الداخلة وتعيد النص المُولّد. استخدم GET /v1/models للتحقق من معرف النموذج المتاح. لا نقدم خدمات التضمين (Embeddings)، أو توليد الصور، أو معالجة الصوت، أو ضبط النماذج (Fine-tuning). حافظ على بنية البنية التحتية الخاصة بك بسيطة.

معرف النموذج الذي يجب إرساله هو uncensored. هذا نموذجنا الخاص ذو الأوزان المفتوحة والمُضبط، وليس نسخة GPT أو Claude مُعاد بيعها. يجيب مباشرة دون فلاتر محتوى للاستخدام البالغ القانوني. تحقق من وثائق نقطة النهاية للهياكل المحددة للحمل (payload structures).

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.toolsaiuncensored.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 والبذلة

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

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

Copyimport OpenAI from "openai";

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

التدفق و  وضع JSON

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

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

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)

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

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

مرر تعريفات الدوال في الـ messages مصفوفة. سيستدعي النموذج الأداة المناسبة بناءً على سياق تلميحك. يمكنك بعد ذلك تنفيذ الوظيفة محليًا وإرجاع النتيجة إلى المحادثة. يدعم هذا أنماط الأتمتة المتقدمة.

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

يتيح مفتاح واجهة برمجة التطبيقات الخاصة بك 300 طلب في الدقيقة. يمكنك تشغيل 8 طلبات متزامنة في آن واحد. الحد الأقصى لحجم جسم الطلب هو 8 ميجابايت. كل مفتاح مرتبط بحساب واحد؛ فإن إنشاء مفتاح جديد يستبدل المفتاح القديم.

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