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

البدء السريع: التكامل مع Python

الخطوة الأولى هي تثبيت مكتبة OpenAI SDK الرسمية وتكوين عنوان URL الأساسي. يضمن ذلك توجيه عميلك للطلبات إلى نقطة نهاية LLM غير الخاضعة للرقابة دون تعديل منطقك الحالي.

• ثبّت الحزمة عبر pip.
• اضبط مفتاح API وعنوان URL الأساسي.
• أرسل طلب إكمال محادثة قياسي.

يعمل هذا لكل من السكربتات المحلية وخوادم الإنتاج.

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

مفتاح واجهة برمجة التطبيقات الخاص بك يصادق على كل طلب موجه إلى عنوان URL الأساسي HTTPS://api.chatbotsemfiltro.com/v1. يتم إنشاء المفتاح فورًا عند التسجيل ويبقى ساريًا حتى تقوم بإلغائه.

احفظ المفتاح في متغير بيئة لتجنب تثبيت الأسرار في الكود. يتعامل SDK مع حقن الرؤوس تلقائياً.

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

يقبل النقطة النهائية (endpoint) الأساسية طلبات POST إلى /v1/chat/completions. يتوقع جسم JSON يحتوي على الرسائل ومعلمات النموذج.

• عرّف الدور (النظام، المستخدم، المساعد).
• حدد النموذج كـ "uncensored".
• استلم مخرجات نصية.

يعكس هذا الهيكل تنسيق OpenAI القياسي، مما يضمن التوافق.

الدفق واستدعاء الوظائف

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

يدعم استدعاء الوظائف عبر معلمة tools. يعيد النموذج استدعاءات الأدوات بتنسيق JSON، والتي يمكنك تحليلها وتنفيذها.

المعلمات: درجة الحرارة وTop P

اضبط درجة الحرارة للإبداع أو الحتمية. تتحكم القيم بين 0 و2 في العشوائية. يصفّم Top P الكلمات بناءً على الاحتمال التراكمي.

ادمج هذه المعاملات لضبط نمط الإخراج. استخدم seed للحصول على نتائج قابلة للتكرار أثناء الاختبار.

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

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

حدود معدل الطلبات هي 300 طلب في الدقيقة. يؤدي تجاوز هذا إلى خطأ 429. أدر الطلبات المتزامنة لتجنب التقييد.

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

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

يتم احتساب استهلاك الرموز بدقة. الأخطاء لا تستهلك الرصيد. راقب الاستخدام عبر لوحة التحكم.

cURL

Copycurl https://api.chatbotsemfiltro.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top ten libraries for Rust async programming"}]
  }'

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

التدفق

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)