توثيق واجهة برمجة التطبيقات
ابدأ باستخدام واجهة برمجة التطبيقات (API) لنماذج اللغة الكبيرة (LLM) غير المقيدة عبر نقاط نهاية متوافقة مع OpenAI. يوجهك هذا الدليل السريع خلال المصادقة، وإجراء الطلبات الأساسية، والاستجابة المتدفقة.
المصادقة وURL الأساسي
استخدم مفتاح API الخاص بك مع عنوان URL الأساسي https://api.rankingmodeliai.com/v1. سجّل عبر Google أو البريد الإلكتروني للحصول على مفتاح فورًا. لا حاجة لرقم الهاتف. المصادقة هي المفتاح الذي يوثق جميع الطلبات لخدمة الذكاء الاصطناعي غير الخاضعة للرقابة.
تضمين الرأس Authorization: Bearer YOUR_API_KEY في كل مكالمات. لا يتم استخدام مطالباتك للتدريب. يعمل هذا الإعداد مع أي عميل متوافق مع OpenAI.
الطلب الأول
أرسل طلب POST إلى /v1/chat/completions باستخدام معرف النموذج uncensored. يتعامل عنوان URL الأساسي مع جميع عمليات التوجيه. يمكنك تدفق النتائج أو الحصول عليها جميعًا في وقت واحد.
- تعيين
modelإلىuncensored. - مرر رسائلك في
messagesمصفوفة. - استلم مخرجات نصية مباشرة.
تضمن هذه النهج توافقاً مع الأدوات الموجودة.
curl https://api.rankingmodeliai.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "List the top five factors affecting model latency scores."}]
}'
تكامل واجهة برمجة تطبيقات Python
ثبّت حزمة بايثون الرسمية من OpenAI. قم بتكوين عنوان URL الأساسي ليشير إلى خوادمنا. استخدم uncensored معرف النموذج لجميع عمليات الإكمال. تبسط هذه الطريقة التكامل في تطبيقات Python الخاصة بك.
يتعامل SDK مع إعادة المحاولة والتنسيق تلقائياً. يمكنك تعديل المعلمات مثل temperature أو top_p حسب الحاجة. تدعم واجهة برمجة التطبيقات الخاصة بنا سلوكيات OpenAI القياسية.
from openai import OpenAI
client = OpenAI(base_url="https://api.rankingmodeliai.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)
إعداد Node SDK
استيراد عميل OpenAI Node.js. اضبط baseURL نقطة النهاية. قم بتهيئة العميل بمفتاح API الخاص بك. يتيح هذا التكامل السلس في بيئات Node.js.
استدعاء chat.completions.create مع المعلمات المطلوبة. يحتوي الاستجابة على النص المولد. يمكنك تحليل JSON أو معالجة الأخطاء كما هو معتاد.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.rankingmodeliai.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);
استجابات البث
فعّل البث عن طريق تعيين stream: true. تُعيد الـ API الرموز عبر أحداث الإرسال من الخادم (SSE). يقلل هذا من زمن الاستجابة المُدرَك للمخرجات الكبيرة. يمكنك معالجة الرموز عند وصولها.
يحتوي كل جزء على نص جزئي. يتضمن الجزء الأخير إحصائيات استخدام الرموز. تعد هذه الميزة مثالية لواجهات الدردشة. توفر تجربة مستخدم أكثر سلاسة.
stream = 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)
حدود، أخطاء، والسياق
نافذة السياق هي 100,000 رمز إجمالاً. الحد الأقصى للإخراج هو 16,000 رمز لكل طلب. الأخطاء والرفض مجانية. حدود المعدل هي 300 طلب في الدقيقة. تعني خطأ 401 مفتاحاً غير صالح. يشير خطأ 402 إلى عدم كفاية الرصيد. يشير خطأ 429 إلى تجاوز حد المعدل. يضمن نموذجنا المدفوع مسبقاً تكاليف شفافة.
الأسئلة الشائعة
ما هو عنوان URL الأساسي لواجهة برمجة التطبيقات (API) لترتيب النماذج AI؟
عنوان URL الأساسي هو HTTPS://api.rankingmodeliai.com/v1. هذا الطرف متوافق مع أدوات SDK والعملاء القياسيين لـ OpenAI. كل ما عليك فعله هو تغيير عنوان URL الأساسي وتقديم مفتاح API الخاص بك.
كيف أتعامل مع المصادقة للنموذج اللغوي الكبير غير المقيد؟
تضمين الرأس Authorization: Bearer YOUR_API_KEY في كل طلب. يمكنك التسجيل عبر Google أو البريد الإلكتروني للحصول على مفتاح على الفور. لا يلزم رقم هاتف للحساب.
ماذا يحدث إذا تجاوزت حد معدل الطلب؟
ستتلقى خطأ 429 Too Many Requests. الحد هو 300 طلب في الدقيقة لكل مفتاح. يمكنك أيضاً إجراء 8 طلبات متزامنة. الأخطاء والرفض لا تُحتسب ضد رصيدك.
أنشئ مفتاحك
سجّل الدخول، وانسخ المفتاح الخاص بك، وحدّث عنوان URL الأساسي الخاص بك. هذا كل ما في الأمر.