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

البدء السريع: طلبك الأول

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

• استخدم POST /v1/chat/completions.
• حدد النموذج إلى uncensored.
• أدرج رسائل النظام والمستخدم.

يحتوي الرد على النص المُولّد وتفاصيل استخدام الرموز. يمكنك التحقق من الاتصال بإرسال مطالبة بسيطة والتحقق من الإخراج.

Copycurl https://api.chatsemfiltro.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Show me the current time in Tokyo"}]
  }'

المصادقة & الرؤوس

مرر مفتاح API الخاص بك في الـ Authorization رأس المصادقة لكل طلب. أنشئ هذا المفتاح فوراً بعد التسجيل عبر Google أو البريد الإلكتروني. يحدد المفتاح حسابك ويتتبع استهلاك رصيدك المدفوع مسبقاً. احفظه بأمان، إذ يمنحك وصولاً مباشراً إلى رصيد الفواتير.

• رأس: Authorization: Bearer YOUR_API_KEY.
• لا يلزم رقم هاتف للتسجيل.
• مفتاح نشط واحد لكل حساب؛ استبدله إذا ضاع.

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

Copyfrom openai import OpenAI

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

المعاملات & الضوابط

تحكّم في سلوك النموذج باستخدام المعايير القياسية مثل درجة الحرارة وtop_p وتسلسلات الإيقاف. تتيح لك هذه الإعدادات ضبط الإبداع وطول المخرجات. يحترم النموذج غير الخاضع للرقابة هذه القيود مع الحفاظ على طبيعته الخالية من الرفض. استخدم response_format لإجبار إخراج JSON للمهام المتعلقة بالبيانات المهيكلة.

• تعيين temperature للعشوائية.
• استخدام stop لوقف التوليد عند محفزات محددة.
• تفعيل json_object لتنسيق صارم.

يضبط كل معلمة كيفية تفسير النموذج لمطالبتك. جرب القيم للعثور على التوازن بين الاتساق والتنوع في استجاباتك.

Copyimport OpenAI from "openai";

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

التدفق و  SSE

فعّل البث عن طريق تعيين stream: true لتلقي الرموز في الوقت الفعلي عبر أحداث Server-Sent. يقلل هذا من زمن الاستجابة المُدرَك للمستخدمين النهائيين ويسمح بالمعالجة الفورية للنص المولد. تحتوي القطعة الأخيرة على إحصائيات استخدام الرمز الكاملة لدقة الفوترة.

• تعيين 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 القياسية لإدارة استخدام واجهة برمجة التطبيقات بسلاسة. يشير رمز الحالة 401 إلى مفتاح API غير صالح أو منتهي الصلاحية، مما يتطلب منك تجديد بيانات الاعتماد. يشير خطأ 402 إلى عدم كفاية الرصيد المدفوع مسبقًا، مما يستدعي إعادة الشحن بالعملات المشفرة عبر USDT أو USDC. تطلق حدود المعدل استجابة 429 عندما تتجاوز 300 طلب في الدقيقة.

• 401: تحقق من صلاحية مفتاح API الخاص بك.
• 402: أضف رصيداً عبر العملات المشفرة.
• 429: انتظر قبل إعادة طلباتك.

هذه الأخطاء قابلة للتنبؤ وموثقة. قم بتنفيذ منطق إعادة المحاكمة مع التخفيف الأسي للتعامل مع الأعطال المؤقتة بسلاسة.

الحدود & نافذة السياق

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

• السياق: 100,000 رمز إجمالاً.
• الإخراج الأقصى: 16,000 رمز.
• الطلبات المتزامنة: 8 لكل مفتاح.

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