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

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

ابدأ كل طلب بمفتاح واجهة برمجة التطبيقات (API) الخاص بك في رأس المصادقة. يشير عنوان URL الأساسي الخاص بنا مباشرة إلى نقطة النهاية chat-completions، لذا يمكنك استبدال مفتاحك والبدء فوراً.

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

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

الطلب الأول

أرسل طلب POST إلى مسار الدردشة مع تعيين معرف النموذج الخاص بك إلى uncensored. هذا الهيكل البسيط يعمل مع أي عميل متوافق مع OpenAI.

• اضبط رأس المصادقة إلى Bearer YOUR_API_KEY.
• استهدف نقطة النهاية عند عنوان URL الأساسي الخاص بنا.
• أدرج مصفوفة الرسائل ومعرف النموذج.

النص يدخل، والنص يخرج. لا حاجة لإعدادات إضافية للاستخدام الأساسي.

Copycurl https://api.aiunrestricted.cc/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"}]
  }'

تكامل مكتبة Python

قم بتهيئة عميل OpenAI بعنوان URL الأساسي ومفتاحك. تتعامل حزمة Python مع التسلسل تلقائيًا، مما يتيح لك التركيز على المنطق الخاص بك.

مرر معرف النموذج uncensored للتأكد من أنك تضرب طبقة الاستدلال الخاصة بنا. يضمن هذا سلوكًا غير خاضع للرقابة متسقًا عبر جميع التوليدات.

Copyfrom openai import OpenAI

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

تكامل Node SDK

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

اضبط خصائص apiKey و baseURL بشكل صحيح. يدير SDK المكالمات HTTP، لذا عليك فقط انتظار الاستجابة.

Copyimport OpenAI from "openai";

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

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

فعّل البث عن طريق تعيين stream إلى true في جسم الطلب. ستتلقى أحداث الإرسال من الخادم (SSE) أثناء توليد الرمز.

قم بتحليل القطع المعروضة لعرض النص في الوقت الفعلي. تحتوي القطعة الأخيرة على إحصائيات استخدام الرمز المميز (Token)، مما يتيح لك تتبع التكاليف بدقة دون الحاجة إلى مكالمات إضافية.

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)

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

تتوقع خطأ 401 إذا كان مفتاحك غير صالح، وخطأ 402 إذا استنفد رصيدك المدفوع مسبقاً، وخطأ 429 عندما تصل إلى حد المعدل وهو 300 طلب في الدقيقة لكل مفتاح.

يمكنك تشغيل 8 طلبات متزامنة في وقت واحد. يجب أن تبقى أحجام الطلبات أقل من 8 ميجابايت. تعامل مع هذه الأخطاء بشكل لائق عن طريق إعادة المحاولة مع تراجع أسي أو طلب الشحن.

تدعم نافذة السياق 100,000 رمز موحّد للنص التوجيهي والإكمال معاً، مما يتيح الاحتفاظ العميق بالسياق في تطبيقاتك.