ثبّت الحزمة البرمجية (SDK) الخاصة بك
ابدأ بتثبيت المكتبة الرسمية للغتك. ندعم حزم SDK القياسية الخاصة بـ OpenAI التي يستخدمها معظم المطورين. قم بتثبيت الحزمة عبر طرفية الأوامر (Terminal) للتحضير للخطوات التالية.
تكوين عنوان URL الأساسي والمفتاح
وجّه عميلك إلى نقطة النهاية لدينا وحدد بيانات الاعتماد الخاصة بك. استخدم https://api.openrouterlimits.com/v1 كعنوان URL الأساسي. استبدل YOUR_API_KEY باستخدام المفتاح الذي أنشأته في صفحة "مفتاح API". يعمل هذا الإعداد مع أي عميل متوافق مع OpenAI من خلال تغيير base_url ومفتاح API.
أرسل أول إكمال
أرسل طلبًا لتوليد النص. استخدم مُعرّف النموذج uncensored للوصول إلى نموذجنا مفتوح الوزن المضبط. لا يرفض النموذج المحتوى البالغ القانوني أو المواضيع المثيرة للجدل. أرسل طلب POST إلى /v1/chat/completions مع رسائلك.
curl https://api.openrouterlimits.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Process 5000 records in under 2 seconds"}]
}'
التعامل مع استجابات التدفق
تمكين التدفق لتلقي الرموز في الوقت الفعلي. اضبط stream إلى true في جسم الطلب الخاص بك. ستتلقى أحداث مُرسلة من الخادم (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)
استخدم الأدوات ووضع JSON
دمج استدعاء الوظائف أو مخرجات JSON صارمة. استخدم tools المعامل لاستدعاء الوظائف. اضبط response_format إلى {"type": "json_object"} لوضع JSON. المعاملات المدعومة تشمل temperature, top_p, stop, seed, presence_penalty، و frequency_penalty.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.openrouterlimits.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);
راقب استخدام الرموز (Tokens)
تتبع استخدامك وتعامل مع الأخطاء برفق. تحصل على 300 طلب في الدقيقة و 8 طلبات متزامنة لكل مفتاح. نافذة السياق هي 100,000 توكن. تعامل مع الأخطاء مثل 401 (مفتاح غير صالح)، و 402 (لا يوجد رصيد)، و 429 (حد معدل الطلب). الأخطاء والرفضات مجانية. لا ينتهي صلاحية الائتمان.
from openai import OpenAI
client = OpenAI(base_url="https://api.openrouterlimits.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)