البدء السريع: قم بالتكامل في دقائق

1. قم بتثبيت SDK الخاص بك

ابدأ بتثبيت المكتبة الرسمية للغتك. يفضل معظم المطورين الحزمة القياسية لأنها تطابق الواجهة التي يعرفونها بالفعل. قم بتشغيل pip install openai لـ Python أو npm install openai لـ Node.js. تحتاج فقط إلى مكتبة SDK واحدة للتعامل مع جميع الطلبات.

2. اضبط عنوان URL الأساسي الخاص بك

قم بتكوين العميل ليشير إلى نقطة النهاية المحددة الخاصة بك. يجب عليك تجاوز عنوان URL الأساسي الافتراضي لتوجيه حركة المرور بشكل صحيح. استخدم https://api.unsencoredai.com/v1 كعنوان URL الأساسي. مرر مفتاح API الخاص بك في Authorization الرأس. يعمل هذا الإعداد مع أي عميل متوافق مع OpenAI قياسي.

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

3. أرسل طلبك الأول

أرسل طلب إكمال الدردشة القياسي لتوليد النص. معرف النموذج هو uncensored. يمكنك إرسال موجهات النظام لتوجيه السلوك. تُرجع واجهة برمجة التطبيقات (API) ردًا نصيًا مباشرًا. استخدم أمر curl أدناه لاختبار الاتصال فورًا. تحقق من استجابتك للحصول على choices مصفوفة.

Copycurl https://api.unsencoredai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "what is the version number"}]
  }'

4. معالجة استجابات البث

فعّل التدفق لانخفاض زمن الانتظار ومخرجات في الوقت الفعلي. اضبط stream: true في طلبك. ترسل واجهة برمجة التطبيقات (API) أجزاءً عبر أحداث خادم المراسلة. يمكنك معالجة كل رمز عند وصوله. هذا مثالي لواجهات الدردشة أو سيناريوهات لعب الأدوار. يحتوي الجزء الأخير على إحصائيات الاستخدام.

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)

5. تكوين المعاملات

تعديل temperature, top_p، و stop التسseqs. تؤثر هذه الضوابط على الإبداع وطول المخرجات. يمكنك أيضًا استخدام response_format لوضع JSON. يدعم نافذة السياق 100,000 رمز إجمالي. الحد الأقصى للإخراج هو 16,000 رمز لكل طلب. قم بضبط هذه الإعدادات الدقيقة لحالة الاستخدام المحددة الخاصة بك.

6. الحدود والأخطاء والسياق

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