دليل الدمج

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

الواجهة البرمجية (API) متوافقة مع OpenAI وتعاكس هيكل Chat Completions. ترسل النص وتستقبل نصاً. لا توجد نقاط نهاية إضافية للتضمين أو الصوت لتثقل سير عملك. ابدأ بتوجيه عميلك إلى عنوان URL الأساسي الخاص بنا.

• عنوان URL الأساسي: HTTPS://api.filtrosemia.com/v1
• معرف النموذج: "uncensored"

استبدل عنوان URL الأساسي الحالي في تكوين SDK الخاص بك. تتعامل نقطة النهاية مع كل شيء من لعب الأدوار إلى الترجمة دون الفلاتر المعتادة.

Copycurl https://api.filtrosemia.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "check balance"}]
  }'

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

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

• رأس: Authorization: Bearer YOUR_API_KEY
• لا تحتاج إلى إدارة تدفقات OAuth أو رموز التحديث.

حافظ على أمان مفتاحك. يمنحك الوصول المباشر إلى رصيدك المدفوع مسبقًا. الأخطاء مثل 401 Unauthorized تعني أن المفتاح مفقود أو غير صالح.

Copyfrom openai import OpenAI

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

نقطة نهاية إكمال الدردشة

أرسل الرسائل إلى POST /v1/chat/completions. يدعم النموذج المعلمات القياسية مثل temperature, top_p، و stop التسseqs. إنه نموذج غير خاضع للرقابة ومضبط للمحتوى البالغ والإبداعي.

• يدعم json_object تنسيق الاستجابة.
• يقبل تعريفات الأدوات لاستدعاء الوظائف.

تُعالج الطلبات بشكل تسلسلي ضمن حدود معدل الطلبات الخاصة بك. تأكد من أن حملك يبقى أقل من 8 ميجابايت.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.filtrosemia.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 في طلبك.
• قم بتحليل تدفق SSE في العميل الخاص بك.

يعمل البث بنفس سلوك مكتل SDK القياسي من 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)

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

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

• الإخراج الأقصى الافتراضي: 2,048 رمزاً.
• حد معدل الطلبات: 300 طلب في الدقيقة.

تجاوز الحدود يؤدي إلى 429 Too Many Requests خطأ. اضبط التزامن للبقاء ضمن الحدود المسموح بها. يُسمح بـ 8 طلبات متزامنة لكل مفتاح.

معالجة الأخطاء والتوكن

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

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

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