دليل تكامل API لشخصيات الذكاء الاصطناعي

لماذا تستبدل Character AI بواجهة برمجة تطبيقات؟

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

غالباً ما ترفض المنصات الخاصة المحتوى الذي هو قانوني تماماً. قد تقطع قصة بسبب كلمة حساسة. مع واجهة برمجة التطبيقات (API) للدردشة غير المقيدة، أنت من يقرر ما هو مسموح. تحصل على نقطة نهاية واحدة وموثوقة لتوليد النص. هذه الموثوقية حاسمة عندما تبني منتجاً يعتمد على سلوك شخصيات متسق. أنت لست رهينة لفريق الرقابة التعسفي للمنصة.

الخطوة 1: الحصول على مفتاح API الخاص بك

ابدأ بإنشاء حساب على لوحة تحكم المزوّد. يمكنك تسجيل الدخول باستخدام حسابك على Google أو باستخدام بريدك الإلكتروني وكلمة المرور. لا نطلب رقم هاتفك. بعد التسجيل، انتقل إلى قسم مفتاح واجهة برمجة التطبيقات (API key). يولّد النظام مفتاحًا فريدًا على الفور. انسخ هذا المفتاح واحفظه بأمان في متغيرات البيئة الخاصة بك.

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

الخطوة 2: تكوين عنوان URL الأساسي

تتوقع معظم عملاء الذكاء الاصطناعي الحديث واجهة متوافقة مع OpenAI. تحتاج إلى توجيه مكتبة SDK الخاصة بك إلى عنوان URL الأساسي الصحيح. بالنسبة لهذه الخدمة، نقطة النهاية هي https://api.uncutlyai.com/v1. يعكس هيكل هذا الرابط واجهة OpenAI API القياسية. يعني ذلك أنه يمكنك استخدام المكتبات الموجودة دون تغييرات كبيرة في الكود.

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

الخطوة 3: إرسال أول إكمال للدردشة

قم بإنشاء طلب إلى /v1/chat/completions النقطة النهائية. يجب أن يحتوي الجسم على قائمة من الرسائل. لكل رسالة دور مثل "system"، "user"، أو "assistant". تحدد رسالة النظام شخصية الشخصية. تقود رسائل المستخدم المحادثة.

إليك كيفية هيكلة الطلب:

Copycurl https://api.uncutlyai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Show me the API endpoint for text generation"}]
  }'

أرسل هذا الطلب لرؤية استجابة النموذج. يعالج الخادم الرموز ويعيد إكمال النص. يمكنك تعيين معلمات مثل temperature للتحكم في الإبداع. تجعل القيم الأعلى الشخصية أكثر عدم قابلية للتنبؤ. تجعل القيم الأقل الشخصية أكثر اتساقاً. يتيح لك هذا المرونة ضبط الصوت بدقة.

الخطوة 4: التعامل مع استجابات التدفق

تبدو تطبيقات الدردشة بطيئة إذا كان الانتظار ينتظر الاستجابة الكاملة حتى النهاية. الحل هو التدفق. اضبط stream parameter إلى true. يرسل الخادم سلسلة من أحداث الإرسال من الخادم (SSE). يحتوي كل حدث على قطعة صغيرة من النص.

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

Copyfrom openai import OpenAI

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

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

الخطوة 5: إدارة الرموز المميزة والتكاليف

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

نموذج الدفع المسبق هذا شفاف. تقوم بإضافة رصيد باستخدام العملات المشفرة. الحد الأدنى للإضافة هو 20 دولارًا. يمكنك إضافة 500 دولار في كل مرة. لا توجد اشتراكات شهرية. لا تنتهي صلاحية رصيدك. يساعدك هذا القدر من التنبؤ في تخطيط تكاليف التطوير. أنت تعرف بالضبط تكلفة كل محادثة.

الخطوة 6: تنفيذ استدعاء الوظائف

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

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

Copyimport OpenAI from "openai";

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

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

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

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

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

الخطوة 8: توسيع نطاق تكاملك

مع نمو قاعدة مستخدميك، سيزيد استخدام واجهة برمجة التطبيقات الخاصة بك. راقب استهلاك الرموز الخاصة بك عن كثب. استخدم بيانات الاستخدام من استجابات البث لتتبع التكاليف. إذا لاحظت تكاليف عالية، ففكر في تحسين مطالباتك. يمكن للمطالبات النظامية الأقصر أن تقلل من رموز الإدخال.

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