البدء السريع في واجهة برمجة التطبيقات

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

ابدأ بتوجيه عميلك إلى عنوان URL الأساسي الخاص بنا وإرسال مفتاحك في الرأس. نستخدم مخطط المصادقة القياسي، لذا فإن أي SDK متوافق مع OpenAI أو عميل متوافق يعمل على الفور. لا تحتاج إلى إدارة تدفقات OAuth المعقدة أو الانتظار للحصول على الموافقة. فقط سجل باستخدام Google أو البريد الإلكتروني، وانسخ المفتاح، وستكون جاهزًا. نقطة النهاية هي https://api.aiohnezensur.com/v1 ويقبل Authorization: Bearer YOUR_API_KEY الرأس في كل طلب.

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

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

Copycurl https://api.aiohnezensur.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list 5 free open source image generators"}]
  }'

يشمل الرد النص المُولّد وإحصائيات استخدام الرموز. إذا حصلت على رد، فإن تكاملك يعمل بشكل صحيح. يمكنك الآن المضي قدمًا في بناء تفاعلات أكثر تعقيدًا أو التبديل إلى عملاء برنامجيين.

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

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

Copyfrom openai import OpenAI

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

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

تكامل Node SDK

دمج واجهة برمجة التطبيقات في تطبيقات JavaScript أو TypeScript الخاصة بك باستخدام مكتبة Node SDK. قم بتكوين عنوان URL الأساسي ومفتاح API كما في مثال Python. يعمل هذا النهج بشكل جيد للعرض من جانب الخادم أو الخدمات المصغرة الخلفية. تجريد المكتبة لطبقة الشبكة، مما يتيح لك التركيز على منطق النص.

Copyimport OpenAI from "openai";

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

قم بتشغيل هذا الكود لرؤية استجابة النموذج لإدخالك. يمكنك التكرار بسرعة عن طريق تغيير محتوى الأمر. هيكل الاستجابة يتطابق مع التنسيق القياسي لـ OpenAI، مما يضمن التوافق مع الأدوات الأخرى في مجموعة أدواتك.

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

تمكين التدفق لتلقي الرموز كما يتم إنشاؤها، مما يقلل من زمن الاستجابة المُدرَك. هذا أمر بالغ الأهمية لواجهات المستخدم التي تعرض النص في الوقت الفعلي. اضبط stream المعامل إلى true في طلبك. ترسل الـ API سلسلة من أحداث الإرسال من الخادم (SSE) بدلاً من كائن 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)

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

حدود المعدلات والقيود

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