البدء السريع لواجهة برمجة التطبيقات ia غير الخاضعة للرقابة

الإعداد والتثبيت

ثبّت الحزمة الرسمية (SDK) الخاصة بلغتك المفضلة. تعمل واجهة برمجة التطبيقات الخاصة بنا مع أي عميل متوافق مع OpenAI القياسي، لذا يمكنك استخدام المكتبات التي تثق بها بالفعل. لا تتطلب عملية الإعداد تكوينًا خاصًا بخلاف إضافة التبعية إلى بيئة مشروعك.

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

التكوين: base_url والمفتاح

وجّه عميلك إلى عنوان URL الأساسي واضبط رأس مفتاح واجهة برمجة التطبيقات (API). استخدم نقطة النهاية المحددة المقدمة في لوحة التحكم. يضمن هذا أن تذهب طلباتك مباشرة إلى النموذج غير الخاضع للرقابة دون أي غموض في التوجيه. عنوان URL الأساسي هو HTTPS://api.iasemsensura.com/v1.

اضبط Authorization الرأس إلى Bearer YOUR_API_KEY. يصادق هذا الرأس على كل طلب ترسله. بدون المفتاح الصحيح، سترفض واجهة برمجة التطبيقات إدخالك بخطأ 401. تحقق دائماً من أن مفتاحك يطابق المفتاح الذي يظهر أثناء التسجيل.

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

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

إليك مثال أساسي باستخدام cURL للبدء. استبدل الحقل المؤقت بمفتاح API الخاص بك. ترسل هذه الأمرة مطالبة قصيرة وتتوقع استجابة مباشرة.

Copycurl https://api.iasemsensura.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate 200 words of dark fantasy lore"}]
  }'

معالجة استجابات التدفق

تمكين التدفق لتوليد الرمز في الوقت الفعلي. يعد هذا أمرًا حاسمًا للتطبيقات التي تعرض النص أثناء توليده. تعيد واجهة برمجة التطبيقات الأحداث عبر أحداث Server-Sent (SSE). تتلقى كتلًا من النص عندما تصبح متاحة.

استخدم حزمة Python SDK للتعامل مع التدفق بكفاءة. تدير المكتبة الاتصال وتولد الرموز المميزة عند وصولها. يقلل هذا النهج من زمن الاستجابة المدرك للمستخدمين النهائيين. كما يسمح بالعرض الفوري للنتائج الجزئية.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.iasemsensura.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 يحتوي على المعاملات المطلوبة. تعمل هذه الميزة جنبًا إلى جنب مع توليد النص القياسي.

تمكين وضع JSON لفرض إخراج بتنسيق محدد. اضبط response_format إلى {"type": "json_object"}. يضمن ذلك أن تكون الاستجابة بيانات JSON صالحة. استخدم مكتبة Node SDK للتكامل السهل مع بيئات JavaScript.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.iasemsensura.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 طلبًا في الدقيقة لكل مفتاح. يتم تحديد التزامن بحد أقصى 8 طلبات متزامنة. إذا تجاوزت هذه الحدود، ستتلقى خطأ 429. تُحتسب استجابات التدفق ضمن هذه الحدود أيضًا. استخدم حقل الاستخدام في الجزء الأخير لتتبع الاستهلاك.

التدفق

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)