فهم عنوان URL الأساسي
يحدد عنوان URL الأساسي المكان الذي يرسل إليه عميلك الطلبات. يؤدي الخطأ هنا إلى فشل فوري في الاتصال أو استجابات نموذج غير متوقعة. يفترض العديد من المطورين أن عنوان URL القياسي لـ OpenAI يعمل عالمياً، لكن مزودي النماذج الخالية من القيود يستخدمون غالباً نقاط نهاية مميزة لتوجيه حركة المرور إلى مجموعات نماذج محددة.
تحقق من أن إعداداتك تشير إلى https://api.openrouterabliteratedmodels.com/v1 لخدمتنا. إذا كنت تستخدم وسيطاً من طرف ثالث، فتأكد من أن عنوان URL الأساسي يطابق مستنداتهم بدقة. غالباً ما تؤدي عناوين URL غير الصحيحة إلى أخطاء 404 أو استجابات من النماذج الافتراضية بدلاً من النسخة غير الخاضعة للرقابة المقصودة.
- تحقق من متغيرات البيئة الخاصة بك لـ
BASE_URLأوAPI_HOST. - تأكد من أن المسار يتضمن
/v1للتوافق القياسي. - جرّب الاتصال بطلب بسيط لقائمة النماذج قبل الاستخدام المكثف.
معالجة حدود معدل الطلب
تحدد حدود المعدل عدد الطلبات التي يمكنك إرسالها ضمن إطار زمني محدد. يفرض واجهة برمجة التطبيقات لدينا حدًا قدره 300 طلب في الدقيقة لكل مفتاح. يؤدي تجاوز هذا العتبة إلى أخطاء HTTP 429، مما يعطل الطلبات الإضافية مؤقتًا حتى انتهاء النافذة.
بالإضافة إلى ذلك، هناك حد لطلبات الطلب المتزامن وهو 8 طلبات في نفس الوقت لكل مفتاح. إذا أرسلت أكثر من 8 طلبات متزامنة، سيتم ترتيب الطلبات الزائدة في قائمة الانتظار أو فشلها اعتمادًا على مكتبة العميل الخاصة بك. راقب التزامن في تطبيقك لتجنب الوصول إلى هذه الحدود الصلبة. استخدم استراتيجيات إعادة المحاولة الأسية في الكود الخاص بك للتعامل مع أخطاء 429 بسلاسة دون إزعاج الخادم.
تذكر أن كل مفتاح فريد لحسابك. يمكن أن يؤدي مشاركة المفاتيح عبر خدمات متعددة إلى تسريع الوصول إلى هذه الحدود. قم بإنشاء مفتاح جديد إذا كنت تحتاج إلى أحواض حدود معدل منفصلة لأجزاء مختلفة من تطبيقك.
استجابات البث مقابل عدم البث
تعيد الاستجابة بيانات تدريجياً أثناء توليد الرموز المميزة، بينما ينتظر عدم التدفق الاستجابة الكاملة. يعد التدفق ضرورياً لتجارب المستخدم في الوقت الفعلي ولكنه يتطلب معالجة دقيقة لأحداث الإرسال عبر الخادم (SSE).
أثناء التدفق، تحتوي القطعة الأخيرة على إحصائيات استخدام الرموز. إذا توقفت عن المعالجة مبكرًا، فقد تفوتك هذه البيانات. تأكد من أن عميلك يحلل رسالة SSE الأخيرة لاسترداد عدد الرموز المدخلة والمخرجة بدقة. تكون الاستجابات غير المتدفقة أبسط ولكن قد تسبب زمن استجابة عالي للمخرجات الطويلة.
اختر التدفق (Streaming) لواجهات الدردشة حيث يرى المستخدمون النص يظهر حرفًا بحرف. استخدم عدم التدفق (Non-streaming) للمعالجة الدفعية أو عندما تحتاج إلى الإجابة الكاملة قبل المتابعة. يدعم الـ API الخاص بنا كلا الوضعين عبر stream المعامل في جسم الطلب.
أخطاء وضع JSON
يضمن وضع JSON أن يخرج النموذج JSON صالحاً، وهو أمر حاسم للتكامل البرمجي. غالباً ما تنجم الأخطاء هنا عن رؤوس غير صحيحة أو عدم تطابق في المخططات. تتطلب الـ API response_format: {"type": "json_object"} لإجبار إخراج JSON الصارم.
إذا تلقيت JSON غير صالح، تحقق من تعريف المخطط الخاص بك. قد يتضمن النموذج كتل كود Markdown أو نصوصاً توضيحية خارج بنية JSON. استخدم محللاً قوياً يمكنه إزالة علامات Markdown أو التحقق من الإخراج مقابل المخطط المتوقع. تجنب المخططات المعقدة جداً التي قد تربك النموذج.
اختبر باستخدام هياكل بسيطة أولاً. أضف التعقيد تدريجياً لتحديد حيث يكافح النموذج. تأكد من ضبط درجة الحرارة بشكل مناسب، حيث يمكن أن تزيد درجات الحرارة الأعلى من العشوائية وتقلل من صحة JSON.
أخطاء حساب عدد الرموز
يحدد عدّ الرموز التعبيرية الفوترة واستخدام نافذة السياق. يمكن أن تؤدي الحسابات الخاطئة إلى فواتير غير متوقعة أو استجابات مقتطعة. تفرض واجهة برمجة التطبيقات الخاصة بنا $0.15 مقابل كل 1M رمز تعبيري للإدخال و$0.50 مقابل كل 1M رمز تعبيري للإخراج.
استخدم مكتبة توكين موثوقة تتطابق مع مخطط توكين النموذج. قد تقوم النماذج المختلفة بتوكين المسافات البيضاء أو علامات الترقيم بشكل مختلف، مما يؤدي إلى اختلافات بين عدك المحلي وعد الواجهة البرمجية. اعتمد دائماً على استخدام الرموز المميزة المُعاد في الاستجابة للفوترة الدقيقة.
راقب نافذة السياق الخاصة بك، والتي تبلغ 100,000 رمز إجمالاً. سيؤدي تجاوز هذا الحد إلى حدوث أخطاء. قم بتقطيع الرسائل أو الملخصات الأقدم للبقاء ضمن الحدود. راقب استهلاكك للرموز بمرور الوقت لتحسين هيكل مطالبتك وتقليل التكاليف.
تأخيرات الدفع بالعملات المشفرة
تُعالج الإضافات عبر USDT (TRC20) أو USDC (Base) فوراً من جانبنا. ومع ذلك، قد تؤدي ازدحام الشبكة أحياناً إلى تأخيرات طفيفة في التأكيد. تأكد من إرسال المبلغ والشبكة الصحيحين لتجنب الخسارة.
تتراوح الإضافات من $20 إلى $500 في مبالغ صحيحة. تنطبق رصيد المكافأة تلقائيًا: +5% من $50، +10% من $100، و+15% من $200. تحقق من تجزئة المعاملة لتأكيد الدفع. إذا لم تظهر الأرصدة خلال بضع دقائق، تحقق من مستكشف البلوكتشين لحالة المعاملة.
لا تنتهي صلاحية الرصيد، لذا لا توجد ضرورة لاستخدامه فوراً. تُحل الأخطاء مثل الشحنات المزدوجة عبر صفحة الدعم. احتفظ بسجلات المعاملات الخاصة بك لسهولة الرجوع إليها عند ظهور أي مشكلات.
تكوين معرف النموذج
يحدد معرف النموذج إصدار النموذج غير الخاضع للرقابة الذي تستخدمه. لخدمتنا، معرف النموذج هو uncensored. يمكن أن يؤدي استخدام معرف غير صحيح إلى حدوث أخطاء أو سلوك غير متوقع.
تأكد من أن طلباتك تحدد model: "uncensored" في جسم الطلب. يشير هذا المعرف إلى نموذجنا المحدد مفتوح الوزن والمخصص للاستجابات غير المقيدة. إنه ليس معرفًا عامًا، بل مؤشر محدد لنصنا المستضاف.
تحقق من وثائق مكتبة العميل الخاصة بك لمعرفة كيفية تعيين معرف النموذج. تستخدم بعض المكتبات model الحقل، بينما قد تستخدم بعض الخيارات معلمة مختلفة. يضمن الاتساق في استخدام معرف النموذج عبر تطبيقك منع الالتباس ويضمن أنك تستدعي دائمًا النموذج غير الخاضع للرقابة المقصود.
تجاوزات نافذة السياق
تحدّي نافذة السياق العدد الإجمالي للرموز التي يمكنك إرسالها في طلب واحد. تدعم واجهة برمجة التطبيقات الخاصة بنا نافذة بحجم 100,000 رمز، بما في ذلك المطالبة والإكمال. يؤدي تجاوز هذا الحد إلى حدوث خطأ.
لإدارة السياق، نفذ استراتيجية النافذة المنزلقة. قم بإزالة الرسائل الأقدم أو تلخيصها لتحرير المساحة. راقب عدد الرموز في مدخلاتك للتأكد من بقائها ضمن حد 100,000 رمز. إذا تجاوزت الحد، سترفض واجهة برمجة التطبيقات الطلب.
استخدم ال max_tokens معامل للتحكم في طول المخرجات. الحد الأقصى للمخرجات لكل طلب هو 16,000 رمز. يساعد ضبط هذا المعامل في منع الاستخدام المفرط للرموز ويحافظ على الاستجابات ضمن حدود قابلة للإدارة لتطبيقك.
سياسة الدعم والاسترداد
لا يتم استرداد الرصيد بمجرد استخدامه، لكنه لا ينتهي. إذا واجهت مشكلات في المدفوعات أو الخدمة، تواصل مع الدعم من خلال الصفحة المخصصة. يتم حل الأخطاء مثل الشحنات المزدوجة من قبل فريق الدعم.
بالنسبة لمشاكل التقنية، تحقق من التوثيق أولاً. الـ API لدينا مباشر، لكن قد تظهر حالات حافة. قدم مفتاح الـ API الخاص بك وتفاصيل الطلب عند طلب المساعدة. تتفاوت أوقات الاستجابة، لكننا نهدف إلى حل المشكلات بسرعة.
تذكر أن الرصيد مدفوع مسبقًا. أنت تدفع مقابل ما تستهلكه، مع كون الأخطاء والرفض مجانيًا. يضمن هذا النموذج الشفافية في الفواتير. استخدم صفحة الدعم لأي تناقضات أو أسئلة حول حسابك.
