توثيق واجهة برمجة التطبيقات: إكمال الدردشة

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

عنوان URL الأساسي هو https://api.routeria.cc/v1. مرر مفتاح API الخاص بك في Authorization رأس. الأخطاء والرفضات مجانية، لذا تدفع فقط مقابل الرموز المولدة.

• GET /v1/models يعرض النماذج المتاحة.
• POST /v1/chat/completions يتعامل مع توليد النص.

المصادقة صارمة. يعني خطأ 401 أن مفتاحك غير صالح أو مفقود. يشير خطأ 402 إلى عدم كفاية الرصيد المدفوع مسبقاً. يمكنك الشحن باستخدام USDT (TRC20) أو USDC (Base).

الطلب الأول باستخدام cURL

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

يجب تعيين Content-Type الرأس إلى application/json. يتضمن جسم الطلب معرف النموذج ومصفوفة الرسائل الخاصة بك.

لا تستهلك الأخطاء رصيدك. يمكنك التحقق من مفتاحك عن طريق استدعاء نقطة نهاية النماذج أولاً.

Copycurl https://api.routeria.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "explain how the router handles packet loss"}]
  }'

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

استخدم مكتبة Python SDK الرسمية من OpenAI. اضبط عنوان URL الأساسي إلى https://api.routeria.cc/v1 وتوفير مفتاح API الخاص بك. يبقى معرف النموذج uncensored.

يُبقي هذا النهج الكود الموجود لديك سليمًا. أنت تغير فقط كائن التكوين. يتعامل SDK مع تسلسل JSON ومنطق إعادة المحاولة تلقائيًا.

يتم دعم البث المباشر عبر stream المعلمة. تتلقى أجزاء من النص كما يتم إنشاؤها.

Copyfrom openai import OpenAI

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

استخدام Node SDK

تهيئة العميل باستخدام عنوان URL الأساسي ومفتاح API الصحيحين. مرر معرف النموذج uncensored في استدعاءات الإكمال الخاصة بك.

يعكس SDK لـ Node التنفيذ الخاص بـ Python. يمكنك تدفق الاستجابات أو الانتظار حتى الاكتمال الكامل. يتم الإبلاغ عن استخدام الرموز في الشريحة الأخيرة.

تأكد من تخزين المفتاح في متغيرات البيئة بأمان. يتم عرض مفتاح API فوراً عند التسجيل عبر Google أو البريد الإلكتروني.

Copyimport OpenAI from "openai";

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

استخدام الرموز والبث

فعّل البث عن طريق تعيين stream: true في طلبك. تتلقى أحداث الإرسال من الخادم (SSE) لكل رمز.

تحتوي القطعة الأخيرة على إحصائيات استخدام الرموز الكاملة. يتم شحن الرموز المدخلة بسعر $0.15 لكل مليون رمز. تكلف الرموز المخرجة $0.50 لكل مليون رمز.

يقلل البث من زمن الاستجابة المُدرَك. يمكنك عرض النص بمجرد وصوله. تدعم نافذة السياق 100,000 رمز إجماليًا.

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)

استدعاء الوظائف ووضع JSON

تمكين استدعاء الوظائف مع tools معامل. يدعم النموذج tool_choice للتحكم الدقيق. استخدم response_format: {"type": "json_object"} لمخرجات مُهيّأة.

يضمن ذلك تحليلًا متسقًا في تطبيقك. النموذج مُحسّن لاستجابات واضحة ومهيكلّة.

يمكنك دمج الأدوات مع التدفق. سيقوم النموذج باستدعاء الوظائف عند الحاجة. جميع المعلمات مثل temperature و top_p مدعومة.

المعلمات: درجة الحرارة وTop-P وStop

تعديل temperature للإبداع. تجعل القيم الأقل المخرجات أكثر حتمية. top_p يتحكم في أخذ العينات النواة (nucleus sampling). اضبط stop تسلسلات لإيقاف التوليد.

تشمل المعلمات المدعومة الأخرى seed, presence_penalty، و frequency_penalty. تتيح هذه الخيارات ضبط أسلوب الإخراج.

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

الحدود والحصص

يُقتصر كل مفتاح API على 300 طلب في الدقيقة. يمكنك إجراء 8 طلبات متزامنة لكل مفتاح. حجم جسم الطلب محدود بـ 8 ميجابايت.

يشير خطأ 429 إلى أنك تجاوزت حد المعدل. انتظر قبل إعادة المحاثة. لكل حساب مفتاح نشط واحد؛ يستبدل المفتاح الجديد المفتاح القديم.

معرف النموذج هو دائماً uncensored. إنه ليس GPT أو Claude أو أي نموذج بائع آخر. إنه نموذج مفتوح المصدر يعمل على خوادمنا.