دليل البداية السريعة

المتطلبات الأساسية وتثبيت حزمة التطوير (SDK)

ثبّت الحزمة الرسمية (SDK) الخاصة بلغتك المفضلة قبل إرسال أي طلبات. يضمن ذلك التوافق مع عنوان URL الأساسي ورؤوس المصادقة.

• Python: pip install openai
• Node.js: npm install openai

تتعامل هذه المكتبات مع اتصال HTTP الأساسي وتحليل JSON لك.

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

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

حدد متغير البيئة OPENAI_API_KEY أو مررها مباشرة في تهيئة العميل الخاص بك.

يجب أن يشير عنوان URL الأساسي إلى https://api.llmuncensoredapi.com/v1 لضمان التوجيه الصحيح.

طلب إكمال النص الأساسي

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

يستجيب النموذج بنص خام، متجنباً الرفضات النموذجية الموجودة في النماذج الأخرى.

استخدم معرف النموذج uncensored لجميع الطلبات.

إليك مثال أساسي:

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

استجابات البث مع SSE

استخدم التدفق لتوليد الرموز في الوقت الفعلي. هذا مثالي لواجهات الدردشة أو توليد المحتوى طويل الشكل.

تعيين stream: true في جسم الطلب الخاص بك.

تعيد واجهة برمجة التطبيقات أحداث Server-Sent (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)

استدعاء الوظائف واستخدام الأداة

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

استخدام tool_choice للتحكم في توقيت استدعاء النموذج لوظيفة.

هذه الميزة حاسمة لعمليات أتمتة سير العمل.

مثال على Python:

Copyfrom openai import OpenAI

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

وضع JSON للمخرجات المهيكلة

فرض النموذج على إخراج JSON صالح باستخدام response_format معامل.

تعيين response_format إلى {"type": "json_object"}.

يضمن ذلك تحليلًا متسقًا للتطبيقات التي تعتمد على البيانات المستلمة.

مثال Node.js:

Copyimport OpenAI from "openai";

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

فهم الرموز والحدود

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

حدود المعدلات هي 300 طلب في الدقيقة لكل مفتاح.

تشمل الأخطاء 401 للمفاتيح غير الصالحة، و402 لقصور الرصيد، و429 لحدود معدل الطلب.

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