الأسئلة الشائعة حول API بدون رقابة: التسجيل، الفوترة، نقاط النهاية، رموز الأخطاء وحدود المحتوى

التسجيل والتجربة المجانية

كيف أسجل؟ هل أحتاج لربط بطاقة بنكية؟

سجّل في صفحة /get-api-key/ باستخدام البريد الإلكتروني وكلمة المرور، بدون حاجة لربط بطاقة. بعد نجاح التسجيل، يظهر مفتاح API فوراً على الصفحة، دون انتظار المراجعة.

كم رصيد التجربة للحساب الجديد، وكم المدة؟

الحسابات الجديدة تحصل على $0.50 رصيد تجريبي مجاني صالح لمدة 7 أيام. بناءً على سعر الإخراج $1.00 / مليون رمز (token)، يكفي هذا لتوليد حوالي 500,000 رمز (token) من الردود، وهو كافٍ لاختبار التكامل والتحقق من النطاق الصغير.

كم مفتاحًا يمكن أن يكون لديك في حساب واحد؟ ماذا أفعل إذا ضاع المفتاح؟

كل حساب له مفتاح API واحد فقط. إذا تم تسريبه أو ضياعه، يمكنك إعادة توليده من الحساب، وسيصبح المفتاح القديم غير صالح فوراً. ستحصل الخدمات التي لا تزال تستخدم المفتاح القديم على استجابة 401، لذا يجب تحديث متغيرات البيئة بعد التغيير.

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

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

الفوترة والرصيد

ما هي الأسعار، وكيف يتم الفوترة؟

الفوترة حسب الرموز (token): الإدخال $0.25 / مليون رمز (token)، والإخراج $1.00 / مليون رمز (token). بدون اشتراك أو رسوم شهرية، ندفع مقابل ما نستهلكه. للمزيد من التفاصيل، راجع صفحة الأسعار.

هل ينتهي الرصيد؟

لا. رصيد مسبق الدفع المُشحن لا ينتهي، فقط رصيد التجربة المبدئي بقيمة $0.50 للحسابات الجديدة محدود بـ 7 أيام.

كيف أعرف تكلفة الطلب الواحد؟

حقل usage في كل استجابة يعطي عدد رموز الإدخال والإخراج، وضربها في السعر يعطي التكلفة. الطلبات المتدفقة (streaming) تحتوي أيضاً على usage في كتلة البيانات الأخيرة، انتبه إلى أن choices في هذه الكتلة يكون مصفوفة فارغة.

كيف أتجنب تكبد تكاليف عالية غير متوقعة؟

اعتمد على أمرين: استخدام max_tokens للحد من الإخراج، والافتراضي 2048؛ في المحادثات متعددة الجولات، اقتصِ التاريخ حتى لا يزداد حجم الإدخال. بما أن الدفع مسبق، يتوقف الطلب عند نفاد الرصيد، فلا توجد فواتير تتجاوز الرصيد.

مثال: كم يكلف الطلب العادي؟

افترض إدخال 2,000 رمز (token) وإخراج 500 رمز (token): تكلفة الإدخال حوالي $0.0005، وتكلفة الإخراج حوالي $0.0005، المجموع حوالي $0.001، أي أن 1000 طلب من هذا النوع تكلف حوالي $1. الأرقام الفعلية تعتمد على حقل usage في الاستجابة.

ماذا يحدث عند نفاد الرصيد؟

تعيد نقاط النهاية استجابة 402 برمز الخطأ no_credit. بعد الشحن، يمكنك الاستمرار في الاستخدام دون الحاجة لإعادة توليد مفتاح API.

نقاط النهاية والمعاملات

ما هو عنوان نقطة النهاية واسم النموذج؟

Base URL هو https://api.wuxianzhiapi.com/v1، واسم النموذج ثابت وهو uncensored. نقاط النهاية المتاحة هي POST /v1/chat/completions و GET /v1/models.

هل يتوافق مع SDK؟

نعم. مكتبة Python الرسمية openai v1 وما فوق، ومكتبة npm openai v4 وما فوق، تعمل بمجرد تغيير base_url ومفتاح API. انظر إلى أمثلة الكود في ، وللمهاجرة من واجهات أخرى، راجع دليل الهجرة.

ما هو طول نافذة السياق؟ ما الحد الأقصى لـ max_tokens؟

السياق يتسع لـ 100,000 رمز (token)، ولا يتجاوز مجموع المُوهِج والإخراج هذا العدد. max_tokens افتراضيًا 2048، والحد الأقصى لكل طلب 32,000. حجم جسم الطلب لا يمكن أن يتجاوز 8 MB.

هل يدعم الإخراج المتدفق (streaming) واستدعاء الدوال؟

كلاهما مدعوم. للإخراج المتدفق استخدم stream: true، وسيضيف الخادم كتلة بيانات تحتوي على usage تلقائياً في النهاية. لاستدعاء الدوال، استخدم tools و tool_choice بتنسيق OpenAI، وتُعاد نتائج الأداة برسالة role: "tool".

لماذا لا يحتوي الجزء الأخير من استجابة البث المتدفق على نص؟

هذا كتلة إحصائيات الاستخدام المضافة تلقائيًا، حيث تكون الاختيارات مصفوفة فارغة، ويحتوي usage على عدد الرموز لهذه الطلبية. عند التحليل، تحقق مما إذا كانت الاختيارات فارغة أولاً قبل استخراج المحتوى، ولن تواجه خطأ تجاوز الفهرس.

هل هناك حدّ للمعدل؟

300 طلب لكل مفتاح في الدقيقة. عند التجاوز، يُعاد رمز 429، وما عليك سوى الانتظار ثم إعادة المحاولة. يُنصح باستخدام استراتيجية التراجع الأسي.

هل يدعم النصوص المتجهة (Vectors)، الصور، الصوت أو التخصيص الدقيق (Fine-tuning)؟

لا يدعم أيًا منها. نقدم هنا محادثة نصية فقط، مع نموذج واحد uncensored، ولا توجد نصوص متجهة (embeddings)، ولا توليد صور أو صوت أو فيديو، ولا تخصيص دقيق.

رموز الخطأ

جميع استجابات الخطأ بصيغة JSON، بتنسيق {"error":{"code":...,"message":...}}. فيما يلي شرح لكيفية التعامل مع كل رمز خطأ حسب رمز الحالة.

ما هو خطأ 400؟

هناك مشكلة في الطلب نفسه. الأكثر شيوعًا هو تجاوز الحد الأقصى لـ 100,000 رمز (token) عند جمع طول الموجّه مع max_tokens، أو وجود خطأ في تنسيق JSON أو نوع الحقل. يجب تعديل الطلب؛ إعادة المحاولة لن تنفع.

كيف يمكن تشخيص خطأ 401؟

المفتاح غير صالح أو غير موجود. تحقق مما إذا كان رأس الطلب هو Authorization: Bearer <المفتاح>، وتأكد من فعالية متغيرات البيئة، وما إذا كان المفتاح قد تم تجديده؛ حيث يصبح المفتاح القديم غير صالح فورًا بعد التجديد.

ماذا يعني خطأ 402 no_credit؟

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

ماذا يعني خطأ 403 content_blocked؟

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

ما سبب خطأ 404؟

تم الوصول إلى نقطة نهاية غير موجودة. السبب الشائع هو خطأ في كتابة URL، مثل نسيان /v1، أو استدعاء نقطة نهاية غير مدعومة مثل النصوص المتجهة (embeddings) أو توليد الصور.

كيف يمكن التعامل مع أخطاء 429 و 503؟

الخطأ 429 يعني تجاوز حدّ المعدل البالغ 300 طلب في الدقيقة؛ رمز خطأ 503 هو upstream_busy، مما يعني أن النموذج مشغول مؤقتًا، حاول مرة أخرى بعد بضع ثوانٍ. كلاهما مناسب لإعادة المحاولة باستخدام التراجع الأسي، راجع صفحة أمثلة الكود.

حدود المحتوى

هل يعني "بدون رقابة" إمكانية توليد أي شيء؟

لا. المحتوى البالغ القانوني، والإبداعات الخيالية، والمواضيع المثيرة للجدل لا يتم رفضها، لكن المحتوى الجنسي الذي يتضمن قاصرين يتم حظره دائمًا، ويعود الرمز 403، سواء كان خياليًا أو يتضمن لعب أدوار. يجب أن يكون الاستخدام قانونيًا.

لمن هو موجه؟

موجه فقط للمستخدمين البالغين الذين تزيد أعمارهم عن 18 عامًا. إذا كنت تستخدمه لبناء منتج للمستخدمين النهائيين، فيجب عليك إجراء تأكيد العمر داخل تطبيقك، والحفاظ على آليات الإبلاغ وإدارة الحسابات.

هل يمكن استخدامه لأدوار التمثيل، والروايات، والألعاب؟

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

في أي حالات يتم إرجاع خطأ 403 في أدوار التمثيل؟

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

هل مخرجات النموذج موثوقة دائمًا من حيث الحقائق؟

ليس بالضرورة. عدم رفض الإجابة لا يعني دقة المحتوى. يجب عليك التحقق من الحقائق بنفسك قبل استخدام الاستنتاجات المتعلقة بالحقائق، والبيانات، أو القانون أو الطب.

الخصوصية

هل سيتم استخدام موجّهاتي لتدريب النموذج؟

لا. لن يتم استخدام الموجّهات التي ترسلها للتدريب.

كيف يمكنني تأمين المفتاح؟

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

كيف يجب التعامل مع بيانات المستخدمين في التطبيق؟

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