الأسئلة الشائعة حول واجهة برمجة تطبيقات النماذج الكبيرة: ابحث عن الإجابات حسب الموضوع
عندما يتعامل المطورون مع واجهة برمجة تطبيقات النماذج الكبيرة لأول مرة، غالبًا ما تخطر بأذهانهم عشرات الأسئلة الصغيرة: من أين أحصل على المفتاح؟ هل يمكن إرسال الصور؟ هل سيتوقف فجأة؟ ما الطول الأقصى؟ تم تقسيمها إلى خمس مجموعات حسب الموضوع، مع إجابات موجزة لكل سؤال، وروابط للمقالات التفصيلية عند الحاجة، ويمكنك الانتقال مباشرة إلى المجموعة التي تهمك.
تم التحديث في
نقاط رئيسية
- نقطة الدخول هي التسجيل بالبريد الإلكتروني وكلمة المرور، ويظهر المفتاح فورًا، حساب واحد بمفتاح واحد، ويمكن إعادة توليده.
- نطاق القدرات هو دردشة نصية فقط، بنموذج واحد، يدعم البث المتدفق واستدعاء الدوال، ولا يتضمن الصور، والصوت، والتضمين المتجهي، أو الضبط الدقيق.
- لا يتجاوز مجموع الـ prompt والإخراج في الطلب الواحد 100,000 رمز (token)، و300 طلب في الدقيقة لكل مفتاح.
- المحتوى البالغ القانوني متاح، لكن المحتوى الجنسي الذي يتضمن قاصرين يُحجب دائمًا، والخدمة مخصصة للبالغين فقط.
الحساب والمفتاح
كيف أحصل على المفتاح الأول؟
انتقل إلىصفحة الحصول على المفتاح، وسجّل بالبريد الإلكتروني وكلمة المرور، وسيظهر المفتاح بعد اكتمال التسجيل، دون الحاجة إلى معلومات الدفع.
هل يمكن إنشاء أكثر من مفتاح لحساب واحد؟
لا، مفتاح واحد لكل حساب. للتمييز بين استخدامات المشاريع المختلفة، قم بتوسيم الطلبات في الخلفية الخاصة بك حسب المشروع، بدلاً من الاعتماد على مفاتيح متعددة.
ماذا أفعل إذا تسرب المفتاح؟
أعد توليده فورًا. يصبح المفتاح القديم غير صالح في تلك اللحظة، لذا جهز القيمة الجديدة للنشر في جميع الأماكن قبل التنفيذ.
هل يمكن للمستخدمين الجدد تجربة الخدمة؟
نعم. الحسابات الجديدة تحصل على رصيد تجريبي مجاني بقيمة $0.50، صالح لمدة 7 أيام، دون الحاجة إلى ربط أي طريقة دفع.
لمتابعة العملية من التسجيل إلى إرسال الطلب، اتبع دليل المشروع الكامل في مقال Chatbot.
إذا كنت تدير عدة مشاريع في وقت واحد، لا تعتمد على مفاتيح متعددة للعزل، بل قم بتوسيم كل استدعاء في الخلفية الخاصة بك باسم المشروع، وتسجيل الـ usage. هذا يجعل التلخيص الشهري حسب الوسم أكثر وضوحًا من إحصائيات لوحة التحكم ذات الحبيبات الخشنة.
ما يمكن استدعاؤه وما لا يمكن
ما هو عنوان الواجهة واسم النموذج؟
العنوان هو https://api.apidamoxing.com/v1，模型名固定为 uncensored. الخدمة تقدم نموذجًا واحدًا فقط.
ما نقاط النهاية المتاحة؟
اثنان: POST /v1/chat/completions للدردشة، وGET /v1/models لعرض قائمة النماذج. المسارات الأخرى تعيد 404.
هل يمكن إرسال الصور أو الصوت، أو إجراء بحث متجهي؟
لا. نحن نعالج النص فقط، ولا توجد صور، أو صوت، أو فيديو، أو تضمين متجهي، ولا نقدم الضبط الدقيق.
هل يدعم البث المتدفق واستدعاء الدوال؟
كلاهما مدعوم. للبث المتدفق أضف stream: true في الطلب، ويتم الإرجاع عبر SSE؛ واستدعاء الدوال يتبع تنسيق tools الخاص بـ OpenAI.
هل يمكنني استخدام SDK الخاص بـ OpenAI الجاهز؟
نعم، فقط قم بتعيين base_url إلى العنوان أعلاه، واستبدل api_key بمفتاحك. يمكنك استخدام Python، أو Node، أو curl.
خطأ شائع هو الاعتقاد بأن "بما أنه متوافق مع تنسيق OpenAI، فهو يدعم جميع ميزات OpenAI". التوافق يعني تنسيق الطلب والاستجابة، وليس نطاق الميزات. هنا لدينا دردشة نصية فقط، لذا يجب فصل الأجزاء المتعلقة بفهم الصور، أو تحويل الصوت إلى نص، أو البحث المتجهي في الأكواد الحالية، واستبدالها بتنفيذ آخر.
الطول، التكرار، والمعاملات
كم يمكن أن يحتوي الطلب؟
الحد الأقصى للمجموع (إدخال وإخراج) هو 100,000 رمز (token). حجم جسم الطلب محدود بـ 8 MB، لكن في سيناريوهات النص، نصل عادةً إلى حد الرموز أولاً.
لماذا تنقطع الإجابة في المنتصف؟
غالبًا ما يكون ذلك بسبب الوصول إلى الحد الأقصى لـ max_tokens، والقيمة الافتراضية هي 2048. قم بزيادتها، والحد الأقصى الفردي هو 32,000، مع الانتباه إلى ألا يتجاوز المجموع 100,000.
كم عدد الطلبات التي يمكن إرسالها في الدقيقة؟
300 طلب لكل مفتاح. يُنصح بتطبيق حدّ المعدل في جانبك مسبقاً للمهام الجماعية، بدلاً من الانتظار حتى يتم تقييدك ثم محاولة التعويض.
هل ستُطبَّق حقول temperature وtop_p وstop؟
نعم، تُمرَّر حقول الاستمارة القياسية كما هي إلى النموذج، ويتصرف السلوك بما يتوافق مع توقعاتك لواجهة إكمال المحادثة.
أين يمكنني الاطلاع على تفاصيل كل حقل؟
يحتوي interface parameter details على جداول تفصيلية، بينما يوفر documentation page مرجعاً مختصراً.
بشأن "ما الذي يُعدّ طويلاً؟"، 100,000 رمز (token) تعادل تقريباً عشرات الآلاف من الأحرف الصينية، ويعتمد ذلك تحديداً على المحتوى؛ إنها مجرد تقدير تقريبي وليس تحويلاً دقيقاً. عند التعامل مع مستندات طويلة جداً، يُعدّ تقسيمها ثم تلخيصها نهجاً أكثر أماناً.
التكاليف والرصيد
كيف يتم التسعير؟
يتم التسعير حسب الرموز (token): $0.25 لكل مليون رمز للإدخال، و$1.00 لكل مليون رمز للإخراج. لا توجد رسوم شهرية ولا حاجة للاشتراك.
هل يتم الدفع مسبقاً أم لاحقاً؟
الدفع مسبقاً. قم بشحن رصيد مسبق الدفع في حسابك، ويُخصم حسب الاستخدام، ولا ينتهي الرصيد.
ماذا يحدث عند نفاد الرصيد؟
يفشل الطلب، وتظهر رمز الحالة 402 ورمز الخطأ no_credit. يحدث نفس الأمر عند انتهاء رصيد التجربة المجانية، ويعود العمل بعد شحن الرصيد.
كيف يمكنني تقدير تكلفة ميزة معينة؟
راجع حسابات token and billing: اقرأ الـ usage من الاستجابة واضربها في السعر.
نصيحة إضافية لإدارة الميزانية: قم بشحن الرصيد بناءً على "الاستخدام المتوقع في هذه الدورة"، ولا تشحن الكثير دفعة واحدة. نظراً لأن الدفع مسبق، فإن رصيدك هو الحدّ الأقصى الصارم؛ يتوقف الاستخدام عند النفاد ولن تتكبد فواتير غير متوقعة.
مشاكل النشر واستكشاف الأخطاء
هل يمكن استخدام مفتاح واحد لكل من بيئة التطوير والبيئة الإنتاجية؟
نظراً لأن كل حساب يحتوي على مفتاح واحد فقط، فإنها تُستخدم فعلياً كواحدة. تأكد من وضع المفتاح في متغيرات البيئة على الخادم فقط، ولا تكتبه في مستودع الكود أو صفحات الواجهة الأمامية، واعلم أن إعادة توليد المفتاح ستجعل جميع البيئات غير صالحة في آن واحد.
هل يجب إعادة المحاولة فوراً عند حدوث خطأ 503؟
لا. هذا يعني أن الخدمة مشغولة مؤقتاً. أعد المحاولة بعد بضع ثوانٍ، وحدد الحد الأقصى لعدد مرات إعادة المحاولة. إرسال الطلبات بقوة متتالية سيهدر فقط رصيد الطلبات.
الواجهة بطيئة، هل هناك مشكلة؟
توليد النصوص الطويلة يتطلب وقتاً بطبيعة الحال، وكلما كان الإخراج أطول، زاد الوقت. يُنصح بتفعيل البث المتدفق ليتمكن المستخدمون من رؤية النصوص الأولية، مع ضبط مهلة العميل (timeout) لتكون أكثر مرونة.
كيف أتجنب تجاوز الحدّ عندما يطول الحوار؟
قم بقص سجل المحادثة في الخلفية الخاصة بك، واحتفظ بآخر بضع جولات فقط، ويمكنك ضغط المحتوى الأقدم في ملخص. قدّر الحجم الكلي قبل إرسال الطلب، ولا تنتظر حتى تعود الاستجابة برمز 400 لمعالجة الأمر.
كيف أتأكد من عدد الرموز (token) التي استهلكها طلب معين؟
اقرأ حقل usage في الاستجابة، والذي يحتوي على ثلاثة أرقام: الإدخال، والإخراج، والمجموع. في الاستجابات المتدفقة، تظهر هذه القراءة في كتلة البيانات الأخيرة، دون الحاجة إلى معاملات إضافية.
تظهر هذه الأسئلة بشكل متكرر لأنها تحدث في الخطوة التالية بعد "عمل الكود". يُنظر إلى هذا القسم كقائمة تحقق قبل النشر، تأكد من أن برنامجك يتعامل مع كل بند.
حدود المحتوى والمستخدمين
ما نوع المحتوى الذي سيتم رفضه؟
لن يتم رفض المحتوى البالغ القانوني، والروايات، والمواضيع المثيرة للجدل. يُحجب المحتوى الجنسي الذي يتضمن قاصرين ويعيد رمز 403، وكذلك الروايات وأدوار التمثيل.
من يمكنه استخدام الخدمة؟
مخصص للأشخاص البالغين فقط (18 سنة فأكثر). إذا كان منتجك موجهاً للجمهور، قم بتأكيد العمر عند نقطة الدخول.
هل سيتم استخدام الموجّه (prompt) الخاص بي للتدريب؟
لا، لا تُستخدم الموجّهات للتدريب.
أين يجب أن أبحث أولاً عند ظهور خطأ؟
اقرأ أولاً كود ورسالة كائن error في جسم الاستجابة، ثم قارنها برمز الحالة: 401 يعني مشكلة في المفتاح، 402 يعني مشكلة في الرصيد، 403 يعني مشكلة في المحتوى، 429 يعني تجاوز حدّ المعدل، و503 يعني أن الخدمة مشغولة مؤقتاً، أعد المحاولة بعد بضع ثوانٍ.
الأسئلة الشائعة
ما المطلوب لاستدعاء الواجهة؟
مفتاح لحساب مسجل، بالإضافة إلى طلب HTTPS يشير إلى https://api.apidamoxing.com/v1، مع إضافة رمز Bearer في الـ Header، وباقي التنسيق مطابق لتنسيق إكمال المحادثة.
ما الميزات المدعومة وغير المدعومة؟
مدعوم: محادثة نصية، مخرجات متدفقة، واستدعاء الدوال. غير مدعوم: الصور، الصوت، الفيديو، التضمين المتجهي، والتدقيق الدقيق (fine-tuning).
لماذا يتم قطع الإجابة؟
عادة ما يكون ذلك بسبب الوصول إلى الحد الأقصى لـ max_tokens، والقيمة الافتراضية هي 2048، ويمكن تعديلها لتصل إلى 32,000. يجب ألا يتجاوز مجموع الموجّه والإخراج 100,000 رمز (token).
ماذا يحدث عند نفاد الرصيد؟
يعيد الطلب رمز 402 وno_credit. يمكنك الاستمرار بعد شحن رصيد مسبق الدفع، ولا ينتهي الرصيد.
من لا يمكنه استخدام هذه الخدمة؟
الأشخاص دون سن 18 عاماً. سيتم حظر محتوى الجنس الذي يتعلق بالأطفال سواء كان خيالياً أم لا، وإرجاع رمز 403.
املأ النموذج للحصول على مفتاح API
أنشئ حساباً، انسخ المفتاح، عدّل Base URL. الإعداد بهذه البساطة.
