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

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

أرسل أول إكمال (completion) فوراً باستخدام حزمة SDK الرسمية. يربط هذا الإعداد بعنوان URL الأساسي الخاص بنا ويتعامل مع فواتير الرموز المميزة (tokens) تلقائياً. لا تحتاج سوى إلى مفتاح API الخاص بك ومعرف النموذج.

• ثبّت الحزمة عبر pip.
• حدد متغير البيئة.
• نفّذ توليد نصوص بسيط.

Copyfrom openai import OpenAI

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

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

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

Copycurl https://api.bestuncensoredaillm.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list 5 linux commands to kill a process"}]
  }'

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

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

استخدام POST /v1/chat/completions لجميع توليد النصوص. معرف النموذج هو دائمًا uncensored. تكلف الرموز المدخلة $0.15 لكل مليون؛ تكلف الرموز المخرجة $0.50 لكل مليون. يُخصم الرصيد فقط عند نجاح التوليد.

Copyimport OpenAI from "openai";

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

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

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

تحكم في الإبداع باستخدام temperature و top_p. تنتج القيم المرتفعة مخرجات أكثر تنوعاً. استخدم tools للاستدعاء الوظيفي. هذا يسمح باستخراج البيانات الهيكلية أو تشغيل واجهات برمجة التطبيقات الخارجية. اضبط response_format إلى json_object لإخراج JSON صارم.

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)

تعمل هذه المعلمات تمامًا مثل مواصفات OpenAI. يمكنك إعادة استخدام منطق التكوين الحالي الخاص بك.

استجابات البث (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)

لا يؤثر التدفق على فواتير الرموز. تدفع مقابل إجمالي الرموز المولدة، بغض النظر عن كيفية تسليمها.

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

يتيح كل مفتاح 300 طلب في الدقيقة. يمكنك تشغيل 8 طلبات متزامنة. إذا تجاوزت هذا، تحصل على خطأ 429. تُرجع المفاتيح غير الصالحة 401. الرصيد الفارغ يُرجع 402. تتسع نافذة السياق لـ 100,000 رمز إجمالاً. يشمل ذلك كل من السياق والإكمال.

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)

راقب استخدامك عبر لوحة التحكم. لا تنتهي صلاحية الرصيد، لذا يمكنك إيقاف الاستخدام دون فقدان الأموال.