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

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

عنوان URL الأساسي هو HTTPS://api.webtheon.com/v1. مرر مفتاح API الخاص بك في ال Authorization الرأس. يظهر المفتاح فورًا بعد الإنشاء. استخدمه مع أي مكتبة SDK قياسية لـ OpenAI.

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

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

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

نقطة نهاية سرد النماذج

أرسل طلب GET على المسار /v1/models للتحقق من التوفر. يُرجي هذا المسار بيانات تعريفية حول النموذج غير المقيد. يؤكد ذلك معرّف النموذج والمعلمات المدعومة. استخدم هذا الأمر لتصحيح تكوينات العميل بسرعة.

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

استخدام الرموز في التدفق

فعّل البث عن طريق تعيين stream: true. تأتي الاستجابات كأحداث Server-Sent (SSE). تظهر تفاصيل استخدام الرموز في الشريحة الأخيرة من التدفق.

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

المعاملات والخيارات

يشمل درجة الحرارة، وtop_p، وتسلسلات التوقف، والبذرة، والعقوبات. يمكنك فرض وضع JSON عبر response_format. استدعاء الوظائف (الأدوات) مدعوم بالكامل.

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

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

حدود معدل الطلبات هي 300 طلب في الدقيقة. يتم تحديد الطلبات المتزامنة بـ 8 طلبات متزامنة لكل مفتاح. لا يمكن أن يتجاوز حجم جسم الطلب 8 ميجابايت.

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

cURL

Copycurl https://api.webtheon.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "what is the capital of france"}]
  }'

Python

Copyfrom openai import OpenAI

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