المصادقة: ضبط مفتاح API الخاص بك
مفتاح واجهة برمجة التطبيقات الخاص بك يصادق على كل طلب. تتلقى هذا المفتاح فورًا بعد التسجيل باستخدام Google أو عنوان بريد إلكتروني. احتفظ به بأمان، فهو يمنح الوصول إلى رصيدك المدفوع مسبقًا. يعمل المفتاح كمعرف وحيد لكحدود معدل الاستخدام والفواتير. قم بتدويره يدويًا عبر لوحة التحكم إذا لزم الأمر، مع ملاحظة أن المفتاح الجديد يستبدل المفتاح القديم فورًا.
هيكل عنوان URL الأساسي ونقطة النهاية
عنوان URL الأساسي هو HTTPS://api.chatunfiltered.com/v1. يضمن هذا الهيكل التوافق مع مكتبات OpenAI القياسية. تحتاج فقط إلى التفاعل مع نقطة إكمال المحادثات. التضميمات، وتوليد الصور، ومعالجة الصوت غير متوفرة. حافظ على عنوان URL الأساسي متسقاً عبر جميع تكوينات العميل لتجنب أخطاء التوجيه.
curl https://api.chatunfiltered.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Check server status"}]
}'إجراء أول طلب POST
أرسل طلب POST إلى /v1/chat/completions لتوليد النص. قم بتضمين مفتاح API الخاص بك في رأس Authorization. اضبط النموذج على "uncensored" للوصول إلى نموذج اللغوي غير الخاضع للرقابة المخصص. يجب أن يحتوي جسم الطلب على مصفوفة messages تحتوي على Prompt الخاص بك. تعود الاستجابات باستخدام الرموز والمحتوى المولد. يقلل هذا النهج المباشر من زمن الاستجابة مقارنة بالوكلاء متعددي النماذج.
from openai import OpenAI
client = OpenAI(base_url="https://api.chatunfiltered.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)فهم تنسيقات الاستجابة والتدفق
استلم الاستجابات بتنسيق JSON القياسي أو قم ببثها عبر أحداث الإرسال من الخادم. يتيح لك البث معالجة الرموز المميزة أثناء توليدها، مما يحسن زمن الاستجابة المُدرَك للمخرجات الطويلة. تحتوي الشريحة النهائية في البث على إجمالي استخدام الرمز المميز للفواتير الدقيقة. يمكنك أيضًا فرض وضع JSON للمخرجات ذات البيانات المهيكلة. اختر الطريقة التي تناسب بنية تطبيقك بشكل أفضل.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.chatunfiltered.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);تكوين المعلمات: درجة الحرارة، Top-P، والأدوات
اضبط درجة الحرارة وtop_p للتحكم في عشوائية الردود. استخدم tool_choice لقدرات استدعاء الوظائف. يدعم النموذج وضع JSON الصارم عبر response_format. يمكنك أيضاً تعيين تسلسلات التوقف لإيقاف التوليد عند نقاط محددة. تتيح هذه المعلمات تحكماً دقيقاً في سلوك النموذج غير الخاضع للرقابة دون طبقات توجيه خارجية.
stream = 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)معالجة الأخطاء وتتبع استخدام التوكن
عالج أخطاء 401 للمفاتيح غير الصالحة وأخطاء 402 لعدم كفاية الرصيد. تعيد حدود معدل الطلبات 429 عندما تتجاوز 300 طلب في الدقيقة. تمتد نافذة السياق الخاصة بك إلى 100,000 رمز للمطالبة والإكمال معاً. الأخطاء والرفض لا تستهلك رصيدك المدفوع مسبقاً. تتبع استخدام الرموز في شريحة البث الأخيرة لإدارة التكاليف بدقة.
