Chinese LLM API تجربة مجانية: آلية العمل والأسئلة الشائعة

حول التجربة

ماذا أحصل عليه مجاناً؟

كل حساب جديد يحصل على 0.50 دولار رصيد. صالح لمدة سبعة أيام من التسجيل، ولا تحتاج لإدخال تفاصيل الدفع للحصول عليه. ينطبق الرصيد على نفس نقطة النهاية ونفس النموذج الذي تستخدمه الحسابات المدفوعة، لذا ما تختبره هو ما ستشغله في الإنتاج.

كم تبلغ قيمة $0.50؟

يعتمد ذلك على الموجّهات الخاصة بك، لذا إليك توضيح مع افتراضات واضحة. نفترض أن كل طلب يرسل 1,000 رمز مدخل ويحصل على 500 رمز مخرج. بسعر $0.25 لكل مليون رمز مدخل و$1.00 لكل مليون رمز مخرج، يكلف الطلب الواحد $0.00025 زائد $0.0005، أي $0.00075. إذن تغطي $0.50 حوالي 660 طلبًا من هذا النوع. التبادلات الأقصر تمتد أكثر، واستدعاءات السياق الطويل تستهلك الرصيد بسرعة أكبر.

ماذا يحدث عند انتهاء التجربة؟

إذا انقضت السبعة أيام أو استُنفد الرصيد أولاً، تعيد الطلبات خطأ HTTP 402 بالرمز no_credit. لا يُحذف شيء. اشحن الرصيد المسبق وسيعمل نفس المفتاح مجدداً. لا يوجد اشتراك، والرصيد المُشحن لا ينتهي أبداً.

هل أحتاج لإضافة تفاصيل الدفع للبدء؟

لا. يستغرق التسجيل بريدًا إلكترونيًا وكلمة مرور فقط. يُعرض المفتاح مباشرة بعد تسجيل حسابك في صفحة الحصول على المفتاح.

خطة عملية لأيام السبعة

أيام سبعة كافية إذا قررت مسبقاً ما تريد تعلمه. عامل التجربة كمشروع تقييم صغير بدلاً من مكان للتجربة العشوائية. إليك تسلسل يعمل بشكل جيد لمعظم الفرق:

1. اليوم 1، اختبار الدخان. تأكد من صحة المفتاح، وقائمة النماذج، وواحد إكمال قصير. الأوامر أدناه تقوم بالثلاثة.
2. الأيام 2 إلى 3، موجّهاتك الحقيقية. شغّل عشرين إلى خمسين إدخالاً ممثلاً من منتجك الخاص عبر الـ API. احفظ المخرجات بجانب المدخلات حتى يتمكن زميل من مراجعتها دون إعادة تشغيل أي شيء.
3. اليوم 4، مسارات الفشل. استحث خطأ 400 عمدًا بطلب كبير الحجم، و401 بمفتاح خاطئ، واختبر معالجة 429 و503 باندفاع صغير. من الأفضل رؤية هذه الآن بدلاً من بيئة الإنتاج.
4. الأيام 5 إلى 6، نموذج التكلفة. اضرب عدد الرموز المسجلة في الأسعار المنشورة وتوقع مبلغاً شهرياً تحت افتراضات حركة المرور الخاصة بك.
5. اليوم 7، القرار. قارن الجودة والتكلفة والحدود مع متطلباتك، ثم قرر ما إذا كنت تريد شحن الرصيد.

Copyexport API_KEY="paste-your-key-here"

# 1) confirm the key works and see the model id
curl -s https://api.chinesellmapi.com/v1/models \
  -H "Authorization: Bearer $API_KEY"

# 2) one short completion; read the usage block in the reply
curl -s https://api.chinesellmapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"用一句话介绍杭州的春天。"}],"max_tokens":120}'

تُعيد المكالمة الثانية كائن استخدام يحتوي على عدد رموز الموجّه والإنتاج. سجّل هذه الأرقام منذ اليوم الأول؛ فهي المادة الخام لكل تقدير للتكلفة ستقوم به لاحقاً.

المفاتيح والبدء

كم مفتاحاً يمكنني امتلاكه؟

واحدة لكل حساب. إذا احتجت إلى واحدة جديدة، أنشئ مفتاحًا جديدًا من حسابك. يتوقف المفتاح القديم عن العمل فورًا، لذا حدّث تطبيقاتك المنشرة على الفور، وإلا سترى أخطاء 401 من أي شيء لا يزال يستخدم القيمة السابقة.

أين أضع المفتاح؟

في متغير بيئة على خادمك، باسم مثل API_KEY، وأبداً في كود المتصفح أو مستودع عام. تحمل الطلبات المفتاح كـ Authorization: Bearer <key>.

ما هو أصغر طلب يثبت أنه يعمل؟

اعرض قائمة النماذج باستخدام GET /v1/models، ثم أرسل إكمال دردشة قصير إلى /v1/chat/completions مع النموذج uncensored وmax_tokens منخفضة. حقل الاستخدام في الاستجابة يظهر بالضبط ما كلفه الاستدعاء من رموز.

هل يمكنني استخدام OpenAI SDK؟

نعم. الـ API متوافق مع إكمال دردشة OpenAI. وجّه URL الأساسي إلى https://api.chinesellmapi.com/v1، وزوّد بمفتاحك، واضبط النموذج على uncensored. دليل كامل، بما في ذلك الموجّهات والتحكم في السكربت، موجود في البدء السريع.

الحدود والقدرات

كم يمكن أن يكون طول الموجّه والرد؟

نافذة السياق هي 100,000 رمز، تحسب الموجّه والإكمال معاً. إعداد max_tokens الافتراضي هو 2,048 ويمكن رفعه إلى 32,000 لكل طلب. يمكن أن يكون حجم طلب حتى 8 ميجابايت. إذا تجاوز الموجّه زائد max_tokens النافذة، يعيد الـ API خطأ 400.

كم طلباً يمكنني إرساله؟

يُحدّ كل مفتاح بـ 300 طلب في الدقيقة. بعد ذلك تتلقى استجابة 429. وزّع مهام الدفعات بشكل متساوٍ وأضف تأخيراً؛ يتضمن دليل الترجمة سكريبت دفعات مُنظّم.

هل يدعم البث المتدفق واستدعاء الدوال؟

نعم لكليهما. اضبط stream: true لأحداث المرسلة من الخادم، مع شريحة نهائية تحمل الاستخدام. تُقبل الأدوات بتنسيق OpenAI، وتُمرر حقول أخذ العينات مثل temperature، top_p وstop كما هي.

ما الذي لا يتوفر؟

النصوص فقط معروضة: لا تضمين، صور، صوت، فيديو أو ضبط دقيق. يوجد نموذج واحد. إذا كان مشروعك يحتاج أحد الميزات المفقودة، خطط لربط هذا الـ API بأداة أخرى لذلك الجزء.

الأخطاء التي قد تواجهها

ما هي رموز الحالة التي يجب أن أتوقعها؟

الأخطاء تُعيد استجابة JSON على شكل {"error":{"code":...,"message":...}}. يعني 400 طلبًا غير صالح، و401 مفتاحًا غير صالح أو مفقود، و402 no_credit، و403 content_blocked، و404 نقطة نهاية غير معروفة، و429 حدّ المعدل و503 upstream_busy.

أي الأخطاء تستحق إعادة المحاولة؟

فقط 429 و503. انتظر، أضف تأخير عشوائي، وأعد المحاولة لعدد محدود من المرات؛ بضع ثوانٍ كافية لـ 503. إعادة محاولة 400، 401، 402 أو 403 لن تغير النتيجة.

لقد قمت بالشحن لكنني لا أزال أرى 402، ماذا أفعل الآن؟

تحقق من أنك تستخدم المفتاح الحالي، لأن إعادة توليد المفتاح تحل محل القديم. ثم أكد أن الطلب يذهب إلى عنوان URL الأساسي الصحيح. إذا تطابق كل شيء، أرسل طلباً بسيطاً واقرأ رسالة الخطأ في جسم الاستجابة.

إطالة عمر رصيد التجربة

الرصيد صغير مُصمَّمًا لهذا الغرض، لذا فإن بعض العادات تطيل عمره. حافظ على max_tokens منخفضة أثناء الاختبار، لأن رموز المخرج تكلف أربعة أضعاف رموز الإدخال: $1.00 لكل مليون مقابل $0.25 لكل مليون. اختبر بموجّهات قصيرة وممثلة أولاً وانتقل إلى أطول المدخلات فقط عندما تتصرف القصيرة بشكل صحيح. تجنب الحلقات التي تستدعي الـ API دون شرط توقف، وحدد عدد إعادة المحاولة في الكود الخاص بك.

مثال عملي مع افتراضات محددة: مجموعة تقييم مكونة من 50 موجّهًا، كل منها يحتوي على حوالي 600 رمز مدخل، مع حصر الردود عند 300 رمز مخرج. تمرير واحد يكلف 30,000 رمز مدخل بالإضافة إلى 15,000 رمز مخرج، وهو ما يعادل 0.0075 دولار بالإضافة إلى 0.015 دولار، أو 0.0225 دولار. يمكنك تشغيل المجموعة بأكملها حوالي 22 مرة قبل نفاد الرصيد، وهو ما يكفي لمقارنة عدة متغيرات للموجّه بشكل صحيح.

إذا مررت موجّهًا طويلًا جدًا، تذكر أن كل الموجّه يُفوتر في كل استدعاء. تكلفة إرسال مستند بـ 40,000 رمز عشرين مرة تساوي تكلفة عشرين طلبًا كبيرًا منفصلًا، لذا قم بالتخزين المؤقت أو تلخيص السياق المشترك حيثما أمكن. الأسعار الحالية مدرجة في صفحة الأسعار، وتفاصيل المعاملات في الوثائق.

قواعد المحتوى والخصوصية

ما نوع المحتوى المسموح به؟

المحتوى القانوني للبالغين، الخيال والمواضيع المثيرة للجدل لا تُرفض ككافة. الخدمة مخصصة للبالغين الذين تبلغ أعمارهم 18 سنة أو أكثر. للخيال طويل الشكل ودردشة الشخصيات، يغطي دليل الخيال بنية الموجّه والتكلفة.

ما هو المحظور دائمًا؟

المحتوى الجنسي الذي ينطوي على قُصّر يتم حظره في كل الحالات ويعيد رمز 403، بما في ذلك الخيال ولعب الأدوار. لا يمكن تغيير الحظر بصياغة الموجّه، لذا لا تعيد المحاولة.

هل تُستخدم موجّهاتي في التدريب؟

لا، لا تُستخدم الموجّهات في التدريب.