البدء السريع لواجهة برمجة التطبيقات غير الخاضعة للرقابة
احصل على مفتاح API الخاص بك وابدأ بإرسال الطلبات إلى نقطة النهاية الخاصة بنا غير المقيدة والمتوافقة مع GDPR. يغطي هذا الدليل استدعاءات OpenAI المتوافقة الأساسية التي تحتاجها للدمج بسرعة.
المتطلبات الأساسية: مفتاح API الخاص بك
استرجع بيانات الاعتماد الخاصة بك على الفور بعد التسجيل. انتقل إلى احصل على مفتاح API صفحة والمصادقة عبر متابعة باستخدام Google أو عن طريق إدخال بريدك الإلكتروني وكلمة المرور. يعرض النظام مفتاحك الفوري على الفور، ولا يلزم رقم هاتف لهذه الخطوة. يمكنك إعادة توليد مفتاح في أي وقت، لكن القيام بذلك يبطل المفتاح السابق، لذا احفظه بأمان. يصادق هذا المفتاح الوحيد على جميع طلباتك على واجهة برمجة التطبيقات.
عنوان URL الأساسي والرؤوس
وجّه عميلك إلى نقطة النهاية الصحيحة لضمان الاتصال السليم. استخدم عنوان URL الأساسي https://api.openroutergdpr.com/v1 لجميع التفاعلات. اضبط Authorization الرأس إلى Bearer YOUR_API_KEY والـ Content-Type إلى application/json. يعمل هذا الإعداد مع أي SDK قياسي لـ OpenAI أو عميل HTTP دون الحاجة إلى محولات مخصصة. ندعم المعلمات القياسية مثل temperature و top_p للتحكم في تنوع الاستجابات.
إرسال طلبك الأول
نفّذ إكمالاً أساسياً للتحقق من صحة تكوينك. أرسل طلب POST إلى /v1/chat/completions باستخدام المعرف uncensored. يؤكد ذلك أن مفتاحك يعمل والنموذج يستجيب لإدخالات النص كما هو متوقع. يتعامل النموذج مع المواضيع غير المقيدة للاستخدام البالغ القانوني دون الرفض القياسي. انظر المثال أدناه للهيكل JSON الأدنى المطلوب.
curl https://api.openroutergdpr.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "List the GDPR articles applicable to cross-border data transfers."}]
}'
معالجة استجابات التدفق
استلم تحديثات تلو الأخرى لتأخير أقل وتجربة مستخدم أفضل. فعّل البث عن طريق تعيين stream: true في جسم الطلب الخاص بك. يرسل الخادم أحداث الإرسال من الخادم (SSE) التي تحتوي على استجابات جزئية. تتضمن الشريحة النهائية إحصائيات استخدام الرموز الكاملة لدقة الفواتير. هذا الأسلوب مثالي لواجهات الدردشة حيث يتوقع المستخدمون توليد النص فوراً. راق delta الحقول لإعادة بناء الرسالة الكاملة.
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 واستدعاء الأدوات
هيكل مخرجاتك بشكل موثوق باستخدام ميزات التنسيق المدمجة. اضبط response_format إلى {"type": "json_object"} لإجبار الامتثال لـ JSON. يمكنك أيضًا تعريف tools للاستدعاء الوظيفي، مما يسمح للنموذج بتنفيذ إجراءات محددة. استخدم tool_choice للتحكم في توقيت قرار النموذج باستدعاء وظيفة. تعمل هذه الميزات مع عملاء متوافقين مع OpenAI القياسي، مما يجعل التكامل مباشراً للتطبيقات القائمة.
from openai import OpenAI
client = OpenAI(base_url="https://api.openroutergdpr.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)
فهم حدود الرموز
إدارة نافذة السياق الخاصة بك لتجنب الاقتطاع أو الأخطاء. يدعم النموذج نافذة سياق بحجم 100,000 رمز لكل من المطالبة والإكمال معاً. يمكن لكل طلب إخراج ما يصل إلى 16,000 رمز، أو 2,048 إذا لم تحدد max_tokens. أنت مقيد بـ 300 طلب في الدقيقة و 8 طلبات متزامنة لكل مفتاح. يجب ألا يتجاوز حجم جسم الطلب 8 ميجابايت. يؤدي تجاوز هذه الحدود إلى ظهور أكواد خطأ HTTP محددة.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.openroutergdpr.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);الأسئلة الشائعة
هل يتوافق OpenRouter مع اللائحة العامة لحماية البيانات (GDPR)؟
نعم، لا نستخدم مطالباتك لبيانات التدريب. على عكس أجهزة التوجيه متعددة المزودين التي ترسل البيانات إلى خلفيات مختلفة، نقدم نموذجاً واحداً على خوادمنا الخاصة، مما يوفر تحكماً أوضح في البيانات لاحتياجات الامتثال في الاتحاد الأوروبي.
ماذا يحدث إذا تجاوزت حد معدل الطلب؟
ستتلقى رمز حالة 429 إذا تجاوزت 300 طلب في الدقيقة أو 8 اتصالات متزامنة. انتظر briefly قبل إعادة المحاولة، أو قلل من التزامن. تأكد من أنك لا ترسل حمولات ضخمة تتجاوز حد حجم الجسم البالغ 8 ميجابايت.
لماذا أحصل على خطأ 402؟
يشير الرمز 402 إلى أن رصيدك المدفوع مسبقاً غير كافٍ للطلب. قم بإضافة رصيد إلى حسابك باستخدام USDT (TRC20) أو USDC (Base) لاستئناف الخدمة. لا تستهلك الأخطاء والرفضات الرصيد، لذا يتم احتساب الفاتورة فقط على الإنجازات الناجحة.
احصل على مفتاح API الخاص بك الآن
سجّل، انسخ المفتاح، حدّث عنوان URL الأساسي. هذا كل شيء.