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

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

أرسل طلبات إلى https://api.uncensoredaicharacter.com/v1 مع مفتاح API الخاص بك في Authorization الرأس. يتم إصدار المفتاح فورًا عند التسجيل عبر Google أو البريد الإلكتروني. استخدم معرف النموذج uncensored لجميع الإكمالات.

Copycurl https://api.uncensoredaicharacter.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the current server uptime status"}]
  }'

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

الطلب الأول: مكتبة Python SDK

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

Copyfrom openai import OpenAI

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

يمكنك تعديل المعلمات مثل temperature للتحكم في العشوائية. تُعيد الواجهة واجهة JSON أو نصاً اعتماداً على إعداداتك. تُعيد الأخطاء رموز حالة HTTP القياسية. تحقق من رمز الحالة للتعامل مع المشكلات بسلاسة.

الطلب الأول: مكتبة Node SDK

قم بتكوين عميل Node لاستخدام نقطة النهاية الخاصة بنا. اضبط apiKey و baseURL الخصائص بشكل صحيح. اتصل chat.completions.create() باستخدام معرف النموذج. تتعامل المكتبة مع التسلسل وإعادة المحاولة تلقائيًا.

Copyimport OpenAI from "openai";

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

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

استجابات البث

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

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)

يقلل التدفق من زمن الاستجابة المُدرَك للمستخدمين النهائيين. يمكنك معالجة الرموز في الوقت الفعلي دون انتظار الاستجابة الكاملة. يتم التعامل مع التخزين المؤقت بواسطة مكتبة العميل. راقب عدد الرموز للبقاء ضمن رصيدك المدفوع مسبقاً.

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

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

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

التكوين والقيود

عيّن معلمات مثل top_p, seed، و stop التسلسلات لتشكيل المخرجات. استخدم response_format لوضع JSON. يدعم استدعاء الوظائف عبر الأدوات. تتبع جميع المعاملات المخطط القياسي لـ OpenAI. يسهل هذا الانتقال للمشاريع القائمة.

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