التوثيق

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

ابدأ بإرسال الطلبات إلى نقطة النهاية المخصصة مع مفتاح API الخاص بك في الرأس. تستخدم خدمتنا بنية متوافقة مع OpenAI، لذا لا تحتاج سوى إلى تحديث عنوان URL الأساسي والمفتاح. عنوان URL الأساسي هو HTTPS://api.bestabliteratedmodels.com/v1. يمكنك إنشاء مفتاحك فوراً بعد التسجيل باستخدام Google أو البريد الإلكتروني. لا يلزم رقم هاتف للحساب.

Copycurl https://api.bestabliteratedmodels.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top 5 endpoints with zero refusals for uncensored chat"}]
  }'

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

طلبك الأول

أرسل استدعاء إكمال محادثة أساسي لاختبار نقطة النهاية. استخدم مُعرّف النموذج 'uncensored' للحصول على مخرجات بدون رفضات محتوى. تقبل الواجهة النصية المعايير القياسية مثل temperature و top_p. يمكنك إرسال مطالبة بسيطة للتحقق من أن الاتصال يعمل بشكل صحيح.

Copyfrom openai import OpenAI

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

تحقق من كائن الاستجابة للنص المُولّد. يتعامل النموذج مع نوافذ سياق تصل إلى 100,000 رمز. يشمل ذلك مدخلاتك ومخرجاتك معاً. تُعيد الأخطاء مثل المفاتيح غير الصالحة أكواد حالة 401.

تكامل Node SDK

دمج واجهة برمجة التطبيقات في تطبيقات Node.js الخاصة بك باستخدام المكتبة الرسمية. قم بتكوين العميل بعنوان URL الأساسي ومفتاح API الخاص بك. يعكس هيكل الكود التطبيقات القياسية لـ OpenAI. هذا يجعل الانتقال من مزودي الخدمات الآخرين أمرًا سهلاً.

Copyimport OpenAI from "openai";

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

التعامل مع بيانات الاستجابة لاستخراج الإكمال. تدعم الـ API استدعاء الوظائف ووضع JSON. يمكنك فرض مخرجات JSON صارمة عن طريق ضبط معلمة response_format. هذا مفيد لبناء خطوط بيانات منظمة.

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

تمكين التدفق لتلقي الرموز كما يتم إنشاؤها. يقلل هذا من زمن الاستجابة المُدرَك للمستخدمين. تستخدم واجهة برمجة التطبيقات أحداث الإرسال من الخادم (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)

تحتوي الشريحة النهائية في التدفق على إجمالي استخدام الرموز الشاردية. يتيح لك ذلك تتبع التكاليف بدقة. يعمل التدفق مع جميع المعاملات مثل درجة الحرارة (temperature) وتسلسلات التوقف (stop sequences). استخدمه لواجهات الدردشة التي تتطلب تحديثات فورية.

حدود المعدلات والأخطاء

راقب حجم طلباتك لتجنب الانقطاعات. الحد هو 300 طلب في الدقيقة لكل مفتاح. يمكنك أيضًا إجراء 8 طلبات متزامنة في نفس الوقت. لا يمكن أن يتجاوز حجم جسم الطلب 8 MB. يؤدي تجاوز هذه الحدود إلى إرجاع رمز الحالة 429.

إذا نفد رصيدك، تعيد الواجهة البرمجية خطأ 402. يمكنك شحن رصيدك باستخدام العملات المشفرة. نحن نقبل USDT على TRC20 أو USDC على Base. الحد الأدنى للشحن هو $20. تنطبق المكافآت على المبالغ الأكبر. الأخطاء مثل المفاتيح غير الصالحة تعيد 401.

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

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

واجهة برمجة التطبيقات (API) للنصوص فقط. لا نقدم تضمينات (embeddings) أو توليد صور. نادرًا ما تحدث رفضات المحتوى، لكنها تنطبق على المحتوى الجنسي الذي يتضمن قاصرين. يضمن هذا الحد الصامت الامتثال. استخدم واجهة برمجة التطبيقات (API) للمحتوى البالغ القانوني، أو الخيال، أو البحث.