Gemma بدون رقابة: دليل تكامل للمطورين

لماذا تختار Gemma بدون رقابة؟

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

لا يرفض النموذج الموجّهات الإبداعية أو التحليلية القياسية، مما يجعله مناسبًا لتوليد أنماط محتوى متنوعة. ومع ذلك، من المهم ملاحظة أنه نموذج مفتوح الأوزان مستقل، وليس نموذج Google Gemma، ولا يرتبط بـ xAI's Grok. يعمل على خوادم مخصصة ويقدم نصوصًا للإدخال والإخراج، مما يوفر بيئة نظيفة ومتوقعة للمطورين الذين يحتاجون إلى إخراج خام للنموذج دون عبء توجيه النماذج المتعددة.

نظرة عامة على توافق API

الـ API متوافق تمامًا مع OpenAI، مما يعني أنه يمكنك استخدام مكتلات OpenAI الرسمية أو أي عميل آخر يتكلم بروتوكول OpenAI. تحتاج فقط إلى تحديث base_url وتقديم مفتاح API الخاص بك. يعكس هيكل نقطة النهاية واجهة إكمال الدردشة القياسية، مما يجعل الانتقال من مزودي الخدمات الآخرين أمرًا سهلاً.

• نقاط النهاية: فقط POST /v1/chat/completions و GET /v1/models متاحان.
• بدون ميزات إضافية: لا توجد نقاط نهاية للتمثيل النصي (embeddings)، أو توليد الصور، أو معالجة الصوت، أو الضبط الدقيق (fine-tuning).
• عنوان URL الأساسي: https://api.grokuncensored.cc/v1
• معرف النموذج: استخدم uncensored كمعرف للنموذج.

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

إعداد بيئة العمل

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

بمجرد حصولك على المفتاح، قم بتكوين متغيرات البيئة. على سبيل المثال، في Python:

تأكد من أن عنوان URL الأساسي يشير إلى https://api.grokuncensored.cc/v1. يمكنك أيضًا الاستفادة من رصيد التجربة، الذي يوفر $0.50 صالح لمدة 7 أيام، دون الحاجة إلى بطاقة ائتمان. هذا يتيح لك التحقق من الاتصال وجودة الاستجابة قبل الالتزام بشحن الرصيد بالعملات المشفرة.

إرسال طلبك الأول

بمجرد تكوين بيئة العمل، يمكنك إرسال طلب. يقبل الـ API مصفوفات الرسائل القياسية. إليك مثال أساسي باستخدام cURL:

Copycurl https://api.grokuncensored.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

سيحتوي الرد على النص المُولّد واستخدام الرموز. إذا قمت بتعيين max_tokens إلى قيمة، فإن الـ API سيحترم هذا الحد. إذا لم تقم بتعيين max_tokens، فإن الحد الأقصى الافتراضي للإخراج هو 2,048 رمز. للإطالة، يمكنك زيادة هذا الحد حتى 32,000 رمز، بشرط أن يبقى إجمالي السياق (الموجّه + الإكمال) ضمن نافذة 100,000 رمز.

معالجة الاستجابات والرموز

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

عند استخدام البث المتدفق، تأكد من أن عميلك يتعامل مع أحداث Server-Sent Events (SSE) بشكل صحيح. يعيد الـ API شرائح من النص، وتحتوي الشريحة الأخيرة على حقل usage. هذا يتيح تسوية الفواتير بدقة. ملاحظة: الرصيد مسبق الدفع، والأخطاء لا تخصم من رصيدك. هذا النموذج ليس خدمة تمثيل نصي (embedding)، لذا لا يمكنك استخدامه لعمليات البحث المتجه مباشرة؛ يجب عليك معالجة التمثيل النصي بشكل منفصل إذا لزم الأمر.

المعاملات المتقدمة

يدعم الـ API عدة معاملات للتحكم في جودة التوليد. يمكنك تعديل temperature للإبداع، و top_p لأخذ العينات النووية، و seed للتكرار. تشمل المعاملات الأخرى المدعومة stop، و presence_penalty، و frequency_penalty.

يدعم استدعاء الدوال عبر حقلي tools و tool_choice. هذا يسمح للنموذج بتوليد مخرجات مهيكلة يمكن تحليلها بواسطة تطبيقك. بالإضافة إلى ذلك، يتوفر وضع JSON عبر response_format: {"type": "json_object"}، مما يضمن أن يكون الإخراج JSON صالحًا. هذا مفيد لبناء الوكلاء أو خطوط بيانات المهيكلة. النموذج هو نموذج مفتوح الأوزان، مضبوط لتوليد نص عالي الجودة، مما يجعله مناسبًا لمتابعة التعليمات المعقدة.

معالجة الأخطاء

تُعاد الأخطاء باستخدام رموز حالة HTTP القياسية. تشمل الأخطاء الشائعة حدود المعدل (429) أو مفاتيح API غير صالحة (401). يتم تعيين حدود المعدل على 300 طلب في الدقيقة و8 طلبات متزامنة لكل مفتاح. إذا وصلت إلى هذه الحدود، نفذ آلية إعادة المحاولة المتزايدة الأسي في العميل الخاص بك.

يُحدّد حجم جسم الطلب بـ 8 MB. إذا تجاوزت هذا الحد، سيتم رفض الطلب. تأكد من أن موجّهاتك ضمن هذه الحدود. نظرًا لأن الـ API يدعم النصوص فقط، فلن تحدث أخطاء تتعلق بمعالجة الوسائط. بالنسبة لأخطاء الفوترة، مثل عدم كفاية الرصيد، سيعيد الـ API حالة 402. الرصيد لا ينتهي صلاحيته أبدًا، لذا يمكنك شحن الرصيد في أي وقت. يمكن حل الأخطاء مثل الشحن المزدوج عبر صفحة الدعم، حيث لا يتم استرداد الرصيد تلقائيًا.

المقارنة مع Grok بدون رقابة

على الرغم من مناقشته غالبًا جنبًا إلى جنب مع نماذج بدون رقابة أخرى مثل Grok بدون رقابة، فإن هذا الـ API هو خدمة مستقلة. إنه لا يقدم Google Gemma، وليس هو الـ Grok API الرسمي من xAI. يشير مصطلح Gemma بدون رقابة في نتائج البحث غالبًا إلى سلوك نموذج مفتوح الأوزان، والذي يحاكيه هذا الـ API بشكل وثيق. ومع ذلك، فإن معرف النموذج هو ببساطة uncensored، ولا يرتبط بهيكلية Google.

على عكس الـ Grok API الرسمي، الذي قد يحتوي على تسعير وحدود مختلفة، يقدم هذا الـ API سعرًا ثابتًا بقيمة $0.25/$1.00 لكل مليون رمز (token). كما يدعم المدفوعات بالعملات المشفرة حصريًا، دون الحاجة إلى بطاقة ائتمان للتجربة. هذا يجعله بديلاً مرناً للمطورين الذين يفضلون العملات المشفرة أو يريدون تجنب الاشتراكات. النموذج ليس بائع تجزئة لـ Grok؛ إنه نموذج مفتوح الأوزان مميز.

الخاتمة

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