دليل البدء السريع لـ Uncensored-llm.vercel.app

المتطلبات الأساسية: مفتاح API وعنوان URL الأساسي

ابدأ بالحصول على مفتاح API واحد من لوحة التحكم. ندعم تسجيل الدخول عبر Google أو التسجيل بالبريد الإلكتروني دون التحقق من الهاتف. يقوم مفتاحك بمصادقة جميع الطلبات الموجهة إلى عنوان URL الأساسي: HTTPS://api.uncensoredllmvercelapp.com/v1. تعمل نقطة النهاية هذه مع أي مكتبة عميل متوافقة مع OpenAI. لا تحتاج إلى إدارة نقاط نهاية متعددة لأنواع نماذج مختلفة.

إرسال طلبك الأول

أجرِ طلب POST إلى /v1/chat/completions بمعرف النموذج "uncensored". يقبل النظام المعاملات القياسية مثل درجة الحرارة وtop_p. يمكنك إرسال ما يصل إلى 8 طلبات في وقت واحد لكل مفتاح. يجب أن يبقى جسم كل طلب أقل من 8 ميجابايت. الأخطاء لا تستهلك رصيدك المسبق.

Copycurl https://api.uncensoredllmvercelapp.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"}]
  }'

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

استجابات التدفق عبر أحداث الإرسال عبر الخادم (SSE)

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

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)

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

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

استخدم معلمة tools لقدرات استدعاء الوظائف. تدعم واجهة برمجة التطبيقات tool_choice والمخرجات المهيكلة بتنسيق JSON عبر response_format. اضبط response_format على json_object للامتثال الصارم لـ JSON. يضمن ذلك التحليل الموثوق في تطبيقاتك. يمكنك تعريف وظائف متعددة لعمليات سير العمل المعقدة.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.uncensoredllmvercelapp.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 مفيد لمهام استخراج البيانات. يتيح استدعاء الوظائف للنموذج إرجاع بيانات مهيكلة. تعمل الميزتان في نافذة السياق غير المقيدة (uncensored). تحتفظ بالتحكم الكامل في تنسيق مخرج النموذج.

التعامل مع الرموز والحدود

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

Copyfrom openai import OpenAI

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

تسمح حدود معدل الطلبات بـ 300 طلب في الدقيقة لكل مفتاح. تأكد من أن تطبيقك يتعامل مع حدود معدل الطلبات بسلاسة. يساعد حساب الرموز في التنبؤ بالتكاليف بدقة. النظام يشحن فقط مقابل الإكمال الناجح.

معالجة الأخطاء والرفض

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

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