OpenRouter Heretic: دليل تكامل كامل

لwhy تختار أوبنروتر هيريتيك؟

يوفر نموذجاً غير خاضع للرقابة، قوياً ووحيداً، دون تعقيد تعدد النماذج أو التوجيه بينها. غالباً ما يواجه المطورون صعوبة مع أنظمة واجهات برمجة مجزأة تفرض أسعاراً مختلفة لكل نموذج. يوفر هذا الإعداد نقطة نهاية موحدة لتوليد النصوص الخام. تحصل على سلوك متسق عبر جميع الطلبات. النموذج مُعدّ لمحتوى الكبار القانوني والمواضيع المثيرة للجدل دون رفض غير ضروري. ليس من نماذج GPT أو Claude أو Gemini. إنه نموذج مفتوح الأوزان يعمل على خوادم مخصصة. هذا يعني زمن استجابة متوقعاً وأسعاراً واضحة. تدفع فقط مقابل الرموز المستخدمة. الأخطاء لا تستهلك رصيدك. نظام السداد المسبق يضمن عدم فقدانك للوصول أثناء المشروع. لا توجد رسوم شهرية تربطك. تحتفظ برصيدك للأبد. هذه البساطة توفر وقت الهندسة. تركز على بناء الميزات. لا على إدارة غرابة المزودين. نافذة السياق بـ 100k تتعامل مع المستندات الكبيرة بكفاءة. تستفيد أنظمة RAG كثيراً من هذه السعة. فهرسة ملفات إبيشتاين أو تحليل الوثائق القانونية يعمل بشكل جيد. النموذج يفهم الفروق الدقيقة. لا يقوم بتطهير الإجابات لأسباب بروتستانتية. يعطيك البيانات التي تحتاجها. مباشرة. بدون هوامش وسطاء. مجرد نص مدخل، ونص مخرج. موثوق. سريع. غير خاضع للرقابة.

المتطلبات الأساسية: إعداد الحساب

تحتاج إلى عنوان بريد إلكتروني ومحفظة عملات مشفرة لإجراء الإيداعات. التسجيل فوري عبر Google أو البريد الإلكتروني. لا تعيق عملية التحقق من رقم الهاتف تقدمك. تتلقى مفتاح API على الفور. المفتاح نشط لـ 300 طلب في الدقيقة. يمكنك تشغيل 8 طلبات متزامنة. حد حجم جسم الطلب هو 8 ميجابايت. هذا يتعامل مع معظم مهام LLM القياسية. تحصل على رصيد تجريبي بقيمة $0.50 لمدة سبعة أيام. يتيح لك ذلك اختبار نقطة النهاية. استخدمه للتحقق من التدفق. تحقق من استدعاء الأدوات. تحقق من وضع JSON. بمجرد رضاك، قم بإجراء إيداع بالعملات المشفرة. يتم قبول USDT على TRC20 أو USDC على Base. الحد الأدنى للإيداع هو $20. الحد الأقصى هو $500. تحصل على رصيد إضافي في المستويات الأعلى. $50 يحصل على مكافأة بنسبة 5%. $100 يحصل على 10%. $200 يحصل على 15%. الرصيد لا ينتهي. يمكنك إيقاف الاستخدام لأشهر. ثم استئنافه. رصيدك يبقى سليماً. لا تظهر رسوم خفية. لا يتم إصدار استرداد للمبالغ مقابل الاستخدام القياسي. يتم التعامل مع الأخطاء عبر الدعم. الخصوصية واضحة. لا تُستخدم المطالبات للتدريب. بياناتك تبقى لك. هذا الإعداد يناسب المهندسين الذين يريدون التحكم. لا يوجد قفل من البائع. مجرد API نظيف.

الخطوة 1: إنشاء مفتاح API الخاص بك

قم بزيارة لوحة التحكم وانقر على 'الحصول على مفتاح API'. الواجهة بسيطة. أدخل بريدك الإلكتروني أو استخدم تسجيل الدخول عبر Google. يولد النظام مفتاحاً فريداً. يبدو كسلسلة طويلة من الأحرف. انسخه فوراً. احفظه في متغيرات البيئة الخاصة بك. لا ترفعه إلى المستودعات العامة. المفتاح مرتبط بحسابك. يمكنك امتلاك مفتاح نشط واحد فقط. إذا قمت بتوليد مفتاح جديد، سيتوقف المفتاح القديم عن العمل. هذا يبسط الأمان. لا تدير مفاتيح متعددة. قم بتدويرها عند الحاجة. يمنح المفتاح الوصول إلى نقطة نهاية chat-completions. كما يسمح بقراءة بيانات النماذج. لا يمكنك استخدامه للتلقيم النصي أو توليد الصور. النطاق واضح. نص يدخل، نص يخرج. يصادق المفتاح على طلباتك. يتحقق الخزان من رصيدك. يخصم الرموز المستخدمة. الأخطاء مجانية. إذا أعاد الخزان خطأ 500، لا تخسر رصيدك. يحمي هذا ميزانيتك. يمكنك توليد مفاتيح لبيئات مختلفة. تستخدم Dev و Prod مفاتيح منفصلة. يمنع هذا الإنفاق العرضي. تظهر الواجهة رصيدك الحالي. يتم تحديثه في الوقت الفعلي. يمكنك رؤية استهلاك الرموز. يساعدك هذا في توقع التكاليف. النظام شفاف. لا مفاجآت. فقط فواتير دقيقة. يُبنى الثقة من خلال الوضوح.

الخطوة 2: تكوين العميل الخاص بك

وجّه حزمة تطوير البرمجيات (SDK) الخاصة بك إلى عنوان URL الأساسي: HTTPS://api.llmheretic.com/v1. هذا العنوان متوافق مع مكتبات OpenAI الرسمية. تقوم بتغيير عنوان URL الأساسي في تكوينك. ثم اضبط رأس مفتاح API. معرف النموذج هو 'uncensored'. هذا هو النموذج الوحيد المتاح. لا تختار بين GPT-4 أو Llama. تستخدم هذا النموذج. إنه مُعدّل لإخراج غير خاضع للرقابة. اضبط درجة الحرارة (Temperature). اضبط top_p. عرّف تسلسلات التوقف (Stop sequences). تتحكم هذه المعاملات في الإبداع. تجعل الدرجة المنخفضة المخرجات حتمية. تضيف الدرجة العالية العشوائية. اضبطها بناءً على حالة الاستخدام الخاصة بك. لتوليد التعليمات البرمجية، استخدم قيماً منخفضة. للكتابة الإبداعية، ارفعها. خيار التدفق متاح. اضبط stream إلى true لتسليم الرموز (Tokens) في الوقت الفعلي. يحسن هذا تجربة المستخدم. يرى المستخدمون النص أثناء توليده. يقلل من زمن الاستجابة المُدرَك. وضع JSON مفيد للبيانات المهيكلة. اضبط response_format إلى json_object. يعيد النموذج JSON صالحاً. يتكامل هذا بشكل جيد مع تطبيقات الواجهة الأمامية. أدوات استدعاء الوظائف مدعومة. عرّف مخطط الوظيفة الخاصة بك. يستدعي النموذج الوظائف بشكل صحيح. يتيح هذا سير عمل وكيلي (Agentic). يمكنك بناء أنظمة معقدة. التكوين قياسي. لا توجد غرائب خاصة. تعيد استخدام الكود الموجود. الانتقال سلس. تتعامل حزمة SDK مع التسلسل. تركز على المنطق. ليس تفاصيل البروتوكول.

الخطوة 3: إرسال أول طلب

قم بإنشاء طلب POST إلى /v1/chat/completions. قم بتضمين مفتاح API الخاص بك في الرأس. اضبط النموذج على 'uncensored'. مرر مصفوفة الرسائل. تحتوي كل رسالة على دور ومحتوى. استخدم 'user' للإدخال. 'assistant' للدورات السابقة. 'system' للتعليمات. توجه تعليمات النظام السلوك. اضبطه لتحديد النبرة. أو تقييد تنسيق الإخراج. يتضمن جسم الطلب الأمر. يتم حساب الرموز المميزة تلقائياً. تكلف المدخلات 0.15 دولار لكل مليون رمز مميز. تكلف المخرجات 0.50 دولار لكل مليون رمز مميز. هذه الأسعار شفافة. ترى عدد الرموز المميزة في الاستجابة. تحتوي الشريحة الأخيرة على بيانات الاستخدام. يساعدك هذا في تتبع التكاليف. الأخطاء مجانية. إذا فشل النموذج، لا تدفع شيئاً. هذا يقلل من المخاطر. يمكنك التجربة بحرية. يسمح نافذة السياق 100k بإدخالات كبيرة. الصق المستندات الكاملة. ضمّن سجل المحادثة. يحتفظ النموذج بالسياق. يجيب بدقة. التدفق اختياري. إذا قمت بتعطيله، تنتظر الاستجابة الكاملة. هذا أبسط للوظائف الدفعية. اختر بناءً على احتياجاتك. حد حجم الطلب هو 8 ميجابايت. هذا يناسب معظم حالات الاستخدام. قد تحتاج الحمولات الأكبر إلى التقسيم. تتحقق واجهة برمجة التطبيقات من الصحة. تعيد رسائل خطأ واضحة. يمكنك تصحيح الأخطاء بسرعة. العملية مباشرة. لا خطوات إعداد معقدة. فقط أرسل الطلب. احصل على النتيجة. ابنِ تطبيقك.

الخطوة 4: التعامل مع استجابات التدفق

فعّل التدفق عن طريق تعيين stream إلى true. ترسل الخادم سلسلة من الأجزاء. يحتوي كل جزء على رمز جزئي. تتراكم هذه الرموز. اعرضها للمستخدم في الوقت الفعلي. هذا يخلق تأثير الكتابة. يدرك المستخدمون أداءً أسرع. يتضمن الجزء الأخير بيانات الاستخدام. يحتوي على تعداد الرموز. يمكنك تسجيل هذه البيانات للفوترة. ينتهي التدفق بعلامة اكتمال. تعامل مع الأخطاء بسلاسة. قد تؤدي انقطاعات الشبكة إلى كسر التدفق. يُنصح بمنطق إعادة المحاولة. تنسيق أحداث الإرسال من الخادم قياسي. قم بتحليل حقل البيانات. استخرج النص. تجاهل أجزاء البيانات الوصفية. ركز على المحتوى. يعمل هذا مع أي عميل HTTP. تدعم Node.js وPython وGo وRust ذلك. تتعامل المكتلة التطويرية (SDK) مع التحليل تلقائياً. تحصل على كائن تدفق. قم بالتكرار عبره. قدم الرموز لواجهة المستخدم. هذا مثالي لواجهات الدردشة. يرى المستخدمون الاستجابات أثناء توليدها. يقلل من وقت الانتظار. ينطبق حد الإخراج الأقصى البالغ 16k. إذا كنت بحاجة إلى مخرجات أطول، قم بإجراء طلبات متعددة. ادمج النتائج. تحافظ النموذج على الاتساق. يفهم السياق. لا يؤثر التدفق على الجودة. يغير فقط سرعة التسليم. استخدمه للتطبيقات التفاعلية. عطّله للمعالجة الدفعية. توفر دورات وحدة المعالجة المركزية. الاختيار لك. المرونة هي المفتاح. ابنِ ما يناسب مستخدميك بشكل أفضل.

الخطوة 5: مراقبة الاستخدام والتكاليف

تحقق من رصيدك في لوحة التحكم. يتم تحديثه في الوقت الفعلي. ترى استخدام الرموز لكل طلب. يُظهر الجزء الأخير من التدفق الاستخدام. سجّل هذه البيانات في نظامك. تتبع الرموز المدخلة مقابل الرموز المخرجة. المخرجات أكثر تكلفة. قم بتحسين نصوصك لتقليل طول الإدخال. استخدم نصوص النظام بكفاءة. تجنب تكرار السياق. يعني نموذج الدفع المسبق أنك تتحكم في الإنفاق. قم بإضافة رصيد عندما يكون الرصيد منخفضاً. عمليات الإضافة عبر العملات المشفرة فورية. يتم دعم USDT و USDC. تضيف الرصيد الإضافي قيمة. يمنحك 100 دولار زيادة بنسبة 10٪. هذا يخفض تكلفتك الفعالة. الرصيد لا ينتهي. يمكنك الادخار لأوقات الذروة. لا رسوم شهرية. لا فخود التجديد التلقائي. إذا تم احتساب الشحنة مرتين، اتصل بالدعم. يقومون بإصلاحها يدوياً. الاستردادات ليست معيارية. الرصيد نهائي. هذا يشجع على الإنفاق الدقيق. راقب استخدام مفتاح API الخاص بك. 300 طلب في الدقيقة هو الحد الأقصى. 8 طلبات متزامنة هي السقف. تجاوز الحدود يعيد أخطاء 429. قم بتقييد معدل عميلك. نفذ استرداداً أسيًا. هذا يمنع التقييد. تظهر لوحة التحكم البيانات التاريخية. حلل الاتجاهات. حدد الارتفاعات. عدل بنية نظامك. تحسين التكلفة عملية مستمرة. التغييرات الصغيرة تتراكم. الكفاءة مهمة. كل رمز له أهمية. ميزانيتك هي لإدارتها.

الخطوة 6: إعدادات متقدمة (الأدوات، JSON)

استخدم استدعاء الوظائف لسير العمل الوكيل. عرّف الأدوات في الطلب. حدد الاسم والوصف والمعاملات. يقرر النموذج أي أداة يجب استدعاؤها. يعيد المعاملات. تنفذ الدالة. أعد النتائج إلى النموذج. يولد إجابة نهائية. هذا يتيح المنطق المعقد. بحث الويب. استعلامات قاعدة البيانات. تنفيذ الكود. يضمن وضع JSON مخرجات منظمة. اضبط response_format على json_object. يعيد النموذج JSON صالح. قم بتحليله في كودك. هذا أمر بالغ الأهمية لواجهات برمجة التطبيقات. تجنب أخطاء التحليل. المخطط مرن. أنت تحدد الهيكل. يتبعه النموذج. تؤثر درجة الحرارة على اختيار الأداة. تجعل القيم المنخفضة القرارات حتمية. تضيف القيم الأعلى التنوع. استخدم درجة حرارة منخفضة للموثوقية. يرشح Top_p أخذ النواة. اضبط للتنوع. تسلسلات التوقف توقف التوليد. مفيدة للنصوص المنظمة. يضمن البذرة إمكانية الاستنساخ. اضبط بذرة للتصحيح. النتائج متسقة. هذه الميزات توسع واجهة برمجة التطبيقات. تبني وكلاء أقوياء. يفهم النموذج التعليمات. ينفذ المهام بدقة. لا يتوهم أسماء الأدوات. يلتزم بمخططك. هذه الموثوقية أمر بالغ الأهمية. لأنظمة الإنتاج. تحتاج إلى الحتمية. توفر هذه الإعدادات ذلك. اجمع بينها لأقصى فائدة. ابنِ تطبيقات ذكية. حل مشاكل حقيقية. يتعامل النموذج غير الخاضع للرقابة مع المطالبات المعقدة. لا يرفض الأدوات الصالحة. ينفذها بالكامل. شغّل مشروعك التالي.

استكشاف الأخطاء الشائعة

تشير أخطاء 429 إلى تجاوز حد المعدل. لقد أرسلت الكثير من الطلبات. انتظر وأعد المحاولة مع التراجع. تشير أخطاء 401 إلى مفتاح API غير صالح. تحقق من مفتاحك. تأكد من أنه نشط. أعد إنشاؤه إذا فقد. أخطاء 400 هي طلبات سيئة. تحقق من صيغة JSON. تحقق من أن معرف النموذج هو 'uncensored'. تأكد من أن مصفوفة الرسائل صحيحة. يجب أن يكون الدور 'user' أو 'assistant' أو 'system'. يجب أن يكون المحتوى موجوداً. أخطاء 500 هي مشاكل في الخادم. أعد المحاولة مرة واحدة. إذا استمرت، اتصل بالدعم. الأخطاء مجانية. لا تخسر رصيدك. هذا آمن للاختبار. تحقق من رصيدك. إذا كان صفراً، أضف رصيداً. مدفوعات العملات المشفرة فورية. USDT على TRC20. USDC على Base. تحقق من الشبكة. قد تؤدي الاتصالات البطيئة إلى انتهاء المهلة. زد قيم المهلة. قد تؤدي المخرجات الكبيرة إلى تجاوز حد 16k. قسم طلبك. أو اقبل المخرجات الجزئية. يتعامل التدفق مع هذا بشكل جيد. اعرض ما تحصل عليه. يستمر النموذج. نافذة السياق هي 100 ألف رمز مميز. إذا تجاوزتها، يقوم النموذج بالاختزال. احذف الرسائل القديمة. احتفظ بالسياق الحديث. هذا يحسن الصلة. صحح بشكل منهجي. سجل المدخلات والمخرجات. قارن بالنتائج المتوقعة. عزز المشكلة. واجهة البرمجة قوية. الأخطاء نادرة. عندما تحدث، تكون واضحة. أصلحها بسرعة. استمر في البناء.