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

المتطلبات الأساسية: احصل على مفتاح API الخاص بك

ابدأ بتأمين اعتماد الوصول الخاص بك على لوحة التحكم. يمكنك تسجيل الدخول باستخدام Google أو استخدام البريد الإلكتروني وكلمة المرور. لا يلزم رقم هاتف لهذا الإعداد البسيط للحساب. بمجرد التسجيل، يظهر مفتاح API الفريد الخاص بك على الفور. تحتاج فقط إلى مفتاح نشط واحد لكل حساب، لأن إنشاء مفتاح جديد يستبدل القديم. يضمن هذا النهج المباشر أن تتمكن من البدء في التكامل دون احتكاك إداري أو خطوات تحقق غير ضرورية التي غالبًا ما تؤخر سير عمل المطورين.

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

قم بتكوين العميل ليشير إلى نقطة النهاية المحددة الخاصة بنا. استخدم https://api.aisenzalimitietici.com/v1 كعنوان URL الأساسي. مرر مفتاحك في Authorization رأس مع Bearer البادئة. يضمن هذا التنسيق القياسي التوافق مع الأدوات الحالية. لا تحتاج إلى تعديل منطق التوجيه المعقد. فقط قم بتحديث عنوان URL الأساسي في تكوين SDK الخاص بك وأدرج مفتاحك. يسمح لك هذا الإعداد البسيط بالاستفادة من نفس مكتبات العملاء التي تثق بها بالفعل للنماذج الأخرى.

Copycurl https://api.aisenzalimitietici.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the capital of France?"}]
  }'

إرسال طلبك الأول

نفّذ إكمال محادثة قياسي للتحقق من الاتصال. أرسل طلب POST إلى /v1/chat/completions باستخدام معرف النموذج uncensored. قم بتضمين مطالبة النظام لتحديد السلوك. سيعيد النموذج استجابة بدون الرفضات المؤسسية المعتادة. يمكنك إرسال نص واستلام نص على الفور. يؤكد هذا التفاعل المباشر أن مفتاحك صالح والاتصال مستقر. تحقق من content field في الاستجابة لرؤية النص المولد.

Copyfrom openai import OpenAI

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

استجابات البث (SSE)

فعّل البث عن طريق تعيين stream: true في طلبك. تُعيد الـ API تدفقًا بأحداث الإرسال من الخادم بدلاً من كائن 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)

معلمات متقدمة (درجة الحرارة، Top-p)

تحكم في إبداع وحتمية المخرجات. اضبط temperature لتغيير العشوائية. تنتج القيم الأقل نتائج أكثر اتساقاً. تشجع القيم الأعلى على الاستجابات المتنوعة والإبداعية. استخدم top_p للتحكم في أخذ العينات النووية. اضبط response_format إلى json_object if you need structured data. You can also use stop تسلسلات لإيقاف التوليد. تمنحك هذه المعلمات تحكماً دقيقاً في كيفية بناء النموذج لإجاباته.

معالجة الأخطاء والحدود

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

Node.js

Copyimport OpenAI from "openai";

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