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

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

استخدم مفتاح API الخاص بك مع https://api.routerllm.cc/v1 عنوان URL الأساسي. اشترك باستخدام Google أو بريد إلكتروني وكلمة مرور للحصول على مفتاحك على الفور. لا حاجة لرقم الهاتف. يقوم المفتاح بمصادقة جميع الطلبات إلى نقطة نهاية chat-completions.

Copycurl https://api.routerllm.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top five python libraries for web scraping."}]
  }'

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

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

أرسل نصوصاً إلى POST /v1/chat/completions النقطة النهائية. معرف النموذج هو uncensored. إنه نموذج مفتوح المصدر مضبوط للاستخدام القانوني للبالغين، وليس نموذج مورد مثل GPT أو Claude.

Copyfrom openai import OpenAI

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

نطاق السياق هو 100,000 رمز للسياق والإكمال معاً. تحصل على 16,000 رمز إخراج افتراضياً، أو 2,048 إذا حذفت max_tokens.

البث مع أحداث الخادم (SSE)

فعّل البث عن طريق تعيين 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)

يقلل هذا الأسلوب من زمن الاستجابة المُدرَك للردود الطويلة. استخدمه عند بناء واجهات دردشة تستفيد من عرض النص تدريجياً.

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

مرر الأدوات في الـ tools مصفوفة. يدعم النموذج استدعاء الوظائف مع tool_choice خيارات. استخدم هذا لاستخراج البيانات المهيكلة أو سير العمل الآلي.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.routerllm.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 والمعاملات

تعيين response_format إلى {"type": "json_object"} لإخراج JSON صارم. تحكم في التوليد باستخدام temperature, top_p, stop، و seed. اضبط عقوبات الحضور والتكرار لتحسين أسلوب المخرجات.

استخدم هذه المعاملات لضبط الموثوقية. وضع JSON ضروري لتحليل الاستجابات التي يمكن للآلة قراءتها. يبقى النموذج غير خاضع للرقابة حتى مع التنسيق الصارم.

معالجة الأخطاء والحدود

تتوقع 401 للمفاتيح غير الصالحة، و402 لنقص الرصيد، و429 لحدود المعدل. الحد هو 300 طلب في الدقيقة و8 طلبات متزامنة لكل مفتاح. الحد الأقصى لحجم جسم الطلب هو 8 ميجابايت.

تحقق من رمز الحالة لتحديد السبب. قم بالشحن بـ USDT أو USDC للمتابعة. لا تنتهي صلاحية الرصيد، لذا يمكنك إيقاف الاستخدام مؤقتاً دون فقدان الأموال.

معلومات النموذج واستهلاك الرموز

استعلام GET /v1/models للتحقق من النماذج المتاحة. النموذج الوحيد هو uncensored. يقدم النص وارد والنص صادر. لا يدعم التضمينات أو الصور أو الصوت.

تتبع استخدام الرموز في رؤوس الاستجابة أو نهاية التدفق. التسعير شفاف: $0.15 لكل مليون رمز إدخال و $0.50 لكل مليون رمز إخراج. يغطي الرصيد المدفوع مسبقاً جميع الاستخدامات.