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

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

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

Copycurl https://api.unsecureapikeys.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the three main dependencies for this python script"}]
  }'

نقطة نهاية إكمال الدردشة

أرسل بيانات نصية إلى POST /v1/chat/completions نقطة النهاية لاستقبال الاستجابات المولدة. هذه هي الواجهة الأساسية لتكاملاتك، وتدعم نافذة سياق بحجم 100,000 رمز لكل من المطالبة والإكمال. معرف النموذج الذي يجب تحديده في حمولتك هو دائماً uncensored. لا داعي للقلق بشأن توجيه النماذج المعقد أو إصداراتها، حيث نقدم نموذجًا واحدًا مفتوح الوزن مضبوط للإخراج غير المفلتر. إذا تجاوزت حد حجم جسم الطلب البالغ 8 ميجابايت، تُرجع واجهة برمجة التطبيقات (API) خطأ. يمكنك أيضًا التحقق من النماذج المتاحة عبر GET /v1/models للتحقق من الاتصال قبل المهام الثقيلة.

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

فعّل توليد الرمز الفوري عن طريق تعيين stream: true في حمولة الطلب الخاصة بك. تُعيد واجهة برمجة التطبيقات أحداث مُرسلة من الخادم (SSE) لعرض منخفض زمن الاستجابة في تطبيقاتك. تظهر إحصائيات استخدام الرموز في الشريحة الأخيرة من التدفق، مما يتيح لك تتبع التكاليف بدقة. هذه الطريقة مثالية لروبوتات الدردشة أو الواجهات التفاعلية حيث يتوقع المستخدمون تغذية راجعة فورية. لاحظ أن الحد الأقصى للمخرجات لكل طلب يصل إلى نافذة 100,000 رمز كاملة؛ max_tokens اختياري. يعمل التدفق بسلاسة مع مكتبات OpenAI القياسية عند تحديث عنوان URL الأساسي بشكل صحيح.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.unsecureapikeys.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 أو قدرات استدعاء الوظائف. اضبط response_format إلى {"type": "json_object"} لإجبار إخراج JSON متسق لمحللاتك. يمكنك أيضًا تعريف الأدوات وتحديد tool_choice لسير العمل المعقد للوكلاء. يدعم النموذج غير الخاضع للرقابة هذه الميزات دون حواجز الحماية الصارمة المعتادة التي غالبًا ما تكسر مخططات الوظائف في مقدمي الخدمات الآخرين. هذا يجعلها موثوقة لخطوط الأنابيب الآلية التي تتطلب استخراج بيانات دقيق. تأكد من أن تعريفات الأدوات الخاصة بك صالحة لتجنب أخطاء التحليل من جانب العميل.

Copyimport OpenAI from "openai";

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

المعاملات & الحدود

تحكّم في سلوك التوليد باستخدام معاملات قياسية مثل temperature, top_p, stop، و seed. يسمح ضبط هذه القيم بالتحكم في التوازن بين الإبداع والحتمية في مخرجاتك. أنت مقيد بـ 300 طلب في الدقيقة لكل مفتاح، مع قدرة على تنفيذ 8 طلبات متزامنة. يُسمح بمفتاح نشط واحد فقط لكل حساب؛ واستبدال المفتاح الحالي بآخر جديد يلغي القديم. يعتمد نموذج الرصيد المسبق على دفع $0.15 مقابل كل مليون رمز إدخال و$0.50 مقابل كل مليون رمز إخراج. لا تستهلك الأخطاء رصيدك، مما يضمن دفعك فقط مقابل الإتمامات الناجحة.

معالجة الأخطاء

التعامل مع استجابات API الشائعة بسلاسة للحفاظ على استقرار التطبيق. يشير خطأ 401 إلى مفتاح API غير صالح أو منتهي الصلاحية. يعني خطأ 402 عدم كفاية رصيدك المدفوع مسبقاً، مما يتطلب شحن الرصيد عبر العملات المشفرة مثل USDT أو USDC. يؤدي تجاوز حد المعدل (300 طلب في الدقيقة) إلى استجابة 429. لا تُعيد الواجهة البرمجية تضمينات أو بيانات صور، لذا قد يؤدي طلب هذه التنسيقات إلى حدوث أخطاء. تحقق دائماً من رمز الحالة قبل تحليل جسم 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)