دمج routerapi في دقائق

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

تغيير base_url و api_key لتبديل المزودين فوراً. وجه SDK الخاص بك إلى HTTPS://api.routerapi.cc/v1 واستخدم المفتاح الذي تم إنشاؤه من لوحة التحكم الخاصة بك. لا توجد قواعد توجيه معقدة أو تكوين متعدد النماذج مطلوب. تظل الرؤوس وإعداد العميل الخاص بك متطابقة مع معايير OpenAI.

يظهر المفتاح مباشرة بعد التسجيل عبر Google أو البريد الإلكتروني. احفظه بأمان وتمريره كـ Bearer رمز في رأس المصادقة HTTP (Authorization header). يوجه هذا التغيير الوحيد جميع الطلبات إلى نموذجنا غير الخاضع للرقابة دون تغيير كود التطبيق الخاص بك.

إرسال طلب إكمال الدردشة

معايير POST طلب إلى /v1/chat/completions لتوليد النص. يقبل هذا الطرف النهائي نفس بنية JSON المستخدمة في OpenAI، مما يضمن عمل مطالباتك دون تعديل. استخدم معرف النموذج uncensored للوصول إلى نموذج اللغة الكبير الخاص بنا والمضبط للاستجابات غير المقيدة.

يستهلك كل طلب رموز من رصيدك المدفوع مسبقًا. الأخطاء والرفض لا تحاسب رصيدك، لذا يمكنك الاختبار بحرية. يوضح المثال التالي استدعاء أساسي لتوليد النص باستخدام الحزمة الرسمية (SDK).

Copycurl https://api.routerapi.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Summarize this 1000 word article in three sentences."}]
  }'

يُرجع الرد النص المولد في choices[0].message.content الحقل. يمكنك ضبط معاملات مثل temperature أو top_p للتحكم في الإبداع. لا تتوفر نقاط نهاية للتضمين أو توليد الصور؛ يركز هذا الخدمة حصرياً على إكمال النص.

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

فعّل البث عن طريق تعيين stream: true في جسم الطلب الخاص بك. تُعيد الواجهة البرمجية (API) أحداث الإرسال من الخادم (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)

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

باستخدام الأدوات واستدعاء الوظائف

مرر تعريفات الأدوات في الـ tools معامل لتمكين استدعاء الوظائف. يعيد النموذج استدعاءات الأدوات الهيكلية في الاستجابة بدلاً من النص العادي. حدد tool_choice لفرض استخدام النموذج لوظيفة محددة أو الاختيار التلقائي. تعمل هذه الميزة بنفس طريقة تنسيق استدعاء الوظائف في OpenAI.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.routerapi.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 ومررها في الطلب. تتعامل واجهة برمجة التطبيقات مع التوجيه بين توليد النص واستدعاء الأداة. استخدم response_format parameter مع {"type": "json_object"} لإخراج JSON صارم عندما لا تكون الأدوات مطلوبة. هذا يضمن بيانات هيكلية متسقة لخدمات الخلفية الخاصة بك.

تعيين وضع JSON للإخراج المهيكل

فرض النموذج على إخراج JSON صالح عن طريق تعيين response_format إلى {"type": "json_object"}. هذا ضروري لتحليل البيانات في سير العمل الآلي أو وكلاء الذكاء الاصطناعي. سيحاول النموذج إغلاق جميع الأقواس والالتزام بالمخطط المطلوب. قد تحدث أخطاء إذا أصبح المخرج طويلاً جداً بالنسبة لنافذة السياق.

Copyimport OpenAI from "openai";

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

ادمج وضع JSON مع temperature تعيين إلى 0 لأقصى درجة من الحتمية. استخدم هذا لاستخراج الكيانات، أو تنسيق البيانات، أو توليد ملفات التكوين. يتعامل النموذج غير الخاضع للرقابة مع الهياكل المتداخلة المعقدة بشكل جيد. تحقق دائمًا من الإخراج في الكود الخاص بك قبل المعالجة.

فهم حدود الرموز والتكاليف

يدعم نافذة السياق 100,000 رمز موزعة بالتساوي بين النص التوجيهي والإكمال. يمكن لكل طلب إخراج ما يصل إلى 16,000 رمز، أو 2,048 إذا max_tokens غير مُضبط. الأسعار هي $0.15 لكل مليون رمز إدخال و$0.50 لكل مليون رمز إخراج. الرصيد لا ينتهي صلاحيته والأخطاء مجانية.

راقب استخدامك عبر لوحة التحكم أو رؤوس الاستجابة. الطلبات محدودة بحجم جسم يبلغ 8 ميجابايت. يمكنك الإضافة باستخدام USDT (TRC20) أو USDC (Base) بدءاً من $20. يزيد الرصيد الإضافي مع الودائع الأكبر: +5% عند $50، و+10% عند $100، و+15% عند $200. لا توجد رسوم اشتراك.