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

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

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

• URL الأساسي: https://api.routeropen.cc/v1
• رأس المصادقة: Authorization: Bearer YOUR_API_KEY

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

الطلب الأول

أرسل أول موجه باستخدام المعيار chat/completions النقطة النهائية. معرف النموذج ببساطة uncensored. هذا يرسل النص ويعيد النص كخرج، بدون مرشحات محتوى للاستخدام القانوني للبالغين.

Copycurl https://api.routeropen.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list all files in current directory"}]
  }'

يُظهر هذا الطلب الهيكل الأساسي. يمكنك تعديل المعاملات مثل temperature أو top_p للتحكم في الإبداع. تتضمن الاستجابة إحصائيات استخدام الرموز للفواتير الشفافة.

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

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

Copyfrom openai import OpenAI

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

تتعامل المكتبة مع تسلسل JSON والتدفق تلقائيًا. يمكنك تكوين منطق إعادة المحاكمة وفترات الانتظار حسب الحاجة. يدعم طرف الاتصال الخاص بنا المعايير القياسية، مما يجعل الانتقال من مزودي الخدمات الآخرين أمرًا سهلاً.

تكامل Node SDK

للمطورين الذين يستخدمون JavaScript، يعمل Node SDK مع تغييرات قليلة. اضبط baseURL نقطة النهاية وقدم المفتاح. يتيح لك هذا الحفاظ على سير عمل التطوير الحالي مع الوصول إلى النماذج غير الخاضعة للرقابة.

Copyimport OpenAI from "openai";

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

يمكن لمستخدمي Node الاستفادة من أنماط async/await للحصول على كود نظيف. تتطابق بنية الاستجابة مع معايير OpenAI، مما يضمن التوافق مع المفسرات الموجودة. يمكنك تبديل النماذج أو مقدمي الخدمة بتغيير متغيرين فقط.

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

فعّل البث عن طريق تعيين stream: true في طلبك. نعيد أحداث الإرسال من الخادم (SSE) لتسليم الرموز في الوقت الفعلي. هذا يقلل من زمن الاستجابة المُدرَك للمستخدمين النهائيين.

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)

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

حدود، أخطاء & السياق

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

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