أسئلة شائعة حول واجهة API الوسيطة: من الحصول على المفتاح إلى تشخيص الأخطاء
نجمع هنا الإجابات على الأسئلة المتكررة التي يطرحها المطورون أثناء التكامل والاستخدام، مرتبة في خمس مجموعات: البدء، الرصيد والفوترة، الأخطاء، حدود القدرات، والمحتوى والخصوصية. تركز كل إجابة على أرقام وإجراءات محددة لتتمكن من مطابقة حالتك مباشرة، ثم العودة إلى صفحة التوثيق لمراجعة تفاصيل الواجهة إذا لزم الأمر.
نقاط رئيسية
- يتطلب التسجيل بريدًا إلكترونيًا وكلمة مرور فقط، ويظهر المفتاح فورًا؛ يحتوي الحساب الجديد على رصيد تجريبي مجاني بقيمة 0.50 دولار صالح لمدة 7 أيام، دون الحاجة إلى معلومات الدفع.
- يشير خطأ 402 إلى نفاد الرصيد، و429 إلى سرعة الطلبات، و503 إلى الحاجة إلى إعادة المحاولة لاحقًا؛ تختلف طرق معالجة كل منها اختلافًا كبيرًا.
- نافذة السياق 100,000 رمز، الحد الأقصى للإخراج 32,000 رمز، حجم جسم الطلب لا يتجاوز 8 MB، يدعم النصوص فقط.
- لا تُستخدم الموجّهات في التدريب.
البدء
كيف أحصل على المفتاح الأول؟
افتح صفحة الحصول على المفتاح، وسجّل باستخدام البريد الإلكتروني وكلمة المرور. سيظهر المفتاح فورًا على الصفحة بعد التسجيل. لا يتطلب العملية إدخال أي معلومات دفع؛ انسخه وضعه في متغيرات البيئة لبدء الاستدعاء.
كم مفتاحًا يمكن أن يحتويه الحساب الواحد؟
مفتاح واحد لكل حساب. يمكنك إعادة توليده عند الحاجة، لكن انتبه: سيفقد المفتاح القديم صلاحيته فورًا بعد التوليد الجديد، وستبدأ الخدمات التي تستخدمه في استلام خطأ 401. لذا، جهّز عملية نشر المفتاح الجديد قبل التنفيذ.
ما هي نقطة النهاية واسم النموذج؟
نقطة النهاية هي https://api.llmzhongzhuan.com/v1，对话请求发往 /v1/chat/completions، ويمكنك عرض قائمة النماذج عبر GET /v1/models. يوجد نموذج واحد فقط باسم uncensored.
كيف أعدل الكود الحالي لـ OpenAI؟
عادةً ما يتطلب الأمر تعديلين فقط: استبدال base_url بالعنوان أعلاه، واستبدال المفتاح بمفتاح الموقع، وتغيير حقل model إلى uncensored. تظل هياكل طلب الاستجابة مطابقة لتنسيق مكملات محادثة OpenAI، لذا لا يحتاج معظم الكود إلى تغيير. راجع تكوين الإطار لكتابة الإطار المحددة.
الرصيد والفوترة
كم مقدار رصيد التجربة، وكيف يُحسب؟
يتم منح الحسابات الجديدة رصيدًا مجانيًا بقيمة 0.50 دولار، ساري المفعول لمدة 7 أيام. بسعر 0.25 دولار لكل مليون رمز مدخل و1.00 دولار لكل مليون رمز مخرج، وبافتراض أن كل طلب يحتوي على 800 رمز مدخل و400 رمز مخرج، يكلف الطلب الواحد حوالي 0.0006 دولار، مما يعني أن رصيد التجربة المجانية يمكنه إرسال أكثر من 800 طلب من هذا النوع. هذا تقدير افتراضي فقط، ويعتمد في الواقع على طول الموجّه.
هل ينتهي رصيد ما بعد الشحن؟
لا. يتم شحن رصيد مسبق الدفع، بدون اشتراك أو قاعدة لتصفير الرصيد عند انتهاء الصلاحية. القيد الوحيد هو أن رصيد التجربة ينتهي بعد 7 أيام.
كيف أعرف تكلفة الطلب الواحد؟
تحتوي الاستجابة على usage الذي يحتوي على عدد رموز الإدخال والمخرجات. في الطلبات التي تستخدم البث المتدفق، سيظهر شريحة إضافية في النهاية تحتوي على usage. اضرب هذين الرقمين في السعر للحصول على تكلفة الطلب. يمكنك الاطلاع على طريقة المراقبة في ممارسات الاستقرار.
أين أجد الأسعار الكاملة؟
الأسعار كما هو موضح في صفحة التسعير. يوضح الموقع سعر الإدخال وسعر المخرجات، بدون رسوم إضافية مخفية.
الأخطاء وحدود المعدل
ماذا يعني استلام خطأ 402؟
رمز الخطأ هو no_credit، مما يعني نفاد رصيد الحساب أو انتهاء صلاحية التجربة. الحل الوحيد هو شحن رصيد مسبق الدفع. لا تُعدّ الطلب في هذه الحالة، لأن إعادة المحاولة لن تنجح وستنتج طلبات زائدة.
كيف أتعامل مع خطأ 429؟
الحد الأقصى هو 300 طلب لكل مفتاح في الدقيقة، وعند التجاوز يتم إرجاع 429. قلل من معدل الإرسال، وأضف إعادة محاولة بالتراجع مع اهتزاز عشوائي. يُنصح باستخدام حدّ الطلبات المتزامنة مع منظم الإيقاع لتسليم الدفعات بسلاسة، ويتوفر نموذج الكود في قسم الاستقرار.
هل 503 upstream_busy عطل؟
هل خطأ 503 upstream_busy هو عطل؟
ما سبب 403 content_blocked؟
ما سبب خطأ 403 content_blocked؟
يعني أن الطلب قد استهدف حظر المحتوى. سيتم إرجاع 403 دائمًا لمحتوى جنسي يتعلق بالأطفال، سواء كان خياليًا أو في سياق لعب الأدوار. لا تُعدّ الطلب عند مواجهة 403، بل راجع المحتوى وعدّله.
ما طول السياق، وكم يمكن أن يكون طول الإخراج؟
إجمالي طول نافذة السياق هو 100,000 رمز، ولا يمكن أن يتجاوز مجموع المدخلات والمخرجات هذا الحد. تكون قيمة max_tokens الافتراضية 2048، ويمكن زيادتها إلى 32,000 كحد أقصى. إذا تجاوز مجموع المدخلات وmax_tokens الحد الأقصى، سيتم إرجاع خطأ 400، لذا تذكر ترك مساحة للمدخلات عند كتابة نصوص طويلة.
هل يدعم البث المتدفق واستدعاء الدوال؟
كلاهما مدعوم. اضبط stream على true للحصول على إخراج عبر تدفق SSE؛ يعتمد استدعاء الدوال على تنسيق tools الخاص بـ OpenAI. سيتم تمرير معاملات الاستخراج الشائعة مثل temperature وtop_p وstop كما هي.
هل يدعم النموذج إنشاء النصوص أو الصور أو الصوت؟
لا. يوفر الموقع محادثة نصية فقط، ولا يدعم النصوص المتجهة أو الصور أو الصوت أو الفيديو أو التخصيص الدقيق، كما أنه يحتوي على نموذج واحد فقط. إذا كانت أعمالك تتطلب هذه القدرات، فيجب عليك استخدام حلول أخرى.
هل هناك حد لحجم جسم الطلب؟
نعم، لا يمكن أن يتجاوز حجم جسم الطلب الواحد 8 MB. عند إدراج مستندات طويلة في الموجّه، يجب أن تنتبه ليس فقط لعدد الرموز، ولكن أيضًا لحجم البايت الإجمالي.
النشر والصيانة اليومية
ما هي أهم الإجراءات قبل النشر الرسمي؟
ابدأ بالتحقق من قائمة النماذج عبر /v1/models، ثم قم بتشغيل اختبار يتضمن مدخلات طويلة، والبث المتدفق، ومسارات الأخطاء. بعد ذلك، اكتب فروع معالجة خاصة بأخطاء 402 و429 و503، واحفظ بيانات الاستخدام. أخيرًا، اضبط حد تنبيه للرصيد لتجنب نفاد الرصيد المسبق الدفع أثناء أوقات الذروة. لا تنسَ إدراج عناصر التحقق هذه في عملية النشر، ليتحقق منها فريق الدعم بشكل فردي.
ما الذي يجب التحقق منه أولاً إذا عادت جميع الطلبات برمز 401 فجأة؟
تحقق أولاً مما إذا كان شخص ما قد قام بإعادة إنشاء مفتاح API في الخلفية، لأن المفتاح القديم يصبح غير صالح فور إعادة إنشائه. ثانياً، تحقق مما إذا كانت متغيرات البيئة قد فقدت في أحدث إصدار، أو إذا كان المفتاح يحتوي على مسافات أو أسطر جديدة. حفظ المفتاح النشط الحالي في مكان واحد فقط يوفر معظم جهود استكشاف الأخطاء هذه.
ما الذي يجب الانتباه إليه عند مشاركة مفتاح واحد بين خدمات متعددة؟
يتم حساب حدّ المعدل بشكل مجمع لكل مفتاح، بحيث لا يتجاوز مجموع طلبات جميع الخدمات 300 طلب في الدقيقة. إذا استهلك مهمة دفعية واحدة كامل السعة، فقد تتلقى الخدمات المباشرة أيضاً رمز 429. يُنصح بتحديد حدّ المعدل للمهام الدفعية بشكل منفصل، وإعطاء الأولوية للطلبات المباشرة، والسماح للمهام الدفعية بالتنفيذ في أوقات غير الذروة ليلاً عند الضرورة.
كيف تتجنب تجاوز التكاليف المتوقعة بشكل خفي؟
سعر رمز (token) المخرجات أعلى بأربع مرات من سعر المدخلات، لذا احرص على التحكم في max_tokens وطول النص المطلوب في الموجّه. قم أيضاً بحساب الاستخدام حسب الوظيفة؛ إذا تضاعف متوسط المخرجات فجأة لأي وظيفة، فافحص ما إذا كان ذلك ناتجاً عن تغييرات في الموجّه. تتمثل ميزة وضع الدفع المسبق في توقف الخدمة عند نفاد الرصيد، مما يمنع فواتير الاستهلاك الزائد غير المتوقعة.
المحتوى والخصوصية
ما نوع المحتوى المسموح به؟
لن يتم رفض المحتوى البالغ القانوني، والإبداعات الخيالية، والمواضيع المثيرة للجدل بشكل مباشر، وتخدم الخدمة المستخدمين البالغين فوق سن 18 عاماً. يتم حظر محتوى الجنس الذي يتضمن قاصرين دائماً. لمزيد من المعلومات حول تكلفة هذه الخدمة والمفاضلات المتعلقة بها، يمكنك قراءة تكلفة ومفاضلات API للذكاء الاصطناعي بدون رقابة.
هل سيتم استخدام الموجّه الخاص بي في التدريب؟
لا، لن يتم استخدام الموجّه في التدريب. بخلاف ذلك، لا تقدم هذه الصفحة تفاصيل أخرى حول التخزين أو السجلات؛ يرجى الرجوع إلى المستندات الرسمية.
ما الفرق بين هذه الخدمة وخدمات التجميع الوسيطة؟
يوفر هذا الموقع نموذجاً واحداً فقط، ولا توجد حاجة لإجراء تعيينات لعدد كبير من أسماء النماذج، ويمكنك التحقق من قائمة النماذج بنفسك عبر /v1/models. لفهم المبادئ العامة ومخاطر خدمات التحويل الوسيطة، يمكنك قراءة المقال مبادئ التحويل الوسيطي.
الأسئلة الشائعة
كيف أبدأ الاستخدام؟
سجّل باستخدام بريدك الإلكتروني وكلمة المرور، وسيظهر مفتاح API فوراً دون الحاجة إلى إدخال معلومات الدفع. يحتوي الحساب الجديد على رصيد تجريبي مجاني بقيمة 0.50 دولار، صالح لمدة 7 أيام.
ماذا أفعل إذا عادت رسالة 402؟
رمز الخطأ 402 هو no_credit، مما يعني نفاد الرصيد أو انتهاء صلاحية التجربة، ويجب عليك شحن الرصيد المسبق، ولا تقم بإعادة المحاولة.
ما هو حدّ المعدل؟
300 طلب في الدقيقة لكل مفتاح، وعند تجاوز الحد يتم إرجاع 429، وننصح باستخدام حدّ الطلبات المتزامنة مع إعادة المحاولة بالتراجع لتسوية إرسال الطلبات.
ما هو طول نافذة السياق وأقصى طول للمخرجات؟
إجمالي طول نافذة السياق هو 100,000 رمز (token)، وmax_tokens الافتراضي هو 2048 والحد الأقصى هو 32,000، ولا يتجاوز حجم جسم الطلب 8 MB.
هل تُستخدم الموجّهات في التدريب؟
لا، لن يتم استخدام الموجّه في التدريب.
املأ النموذج فقط للحصول على مفتاح API
أنشئ حساباً، وانسخ مفتاح API، وعدّل Base URL. الإعداد بهذه البساطة.
