uncensoredgrok.comالمستندات
البدء السريع لمستخدمي Grok
قم بنقل تكاملات واجهة برمجة التطبيقات الحالية لـ Grok إلى نقطة النهاية المتوافقة مع OpenAI وبدون رقابة في دقائق. يغطي هذا الدليل تكوين SDK، البث المتدفق، استدعاء الدوال، والقيود الرئيسية للمطورين الذين يبحثون عن بديل جاهز للاستخدام.
تثبيت SDK لـ OpenAI
تتبع واجهة الـ API الخاصة بنا المخطط القياسي chat-completions، مما يتيح لك إعادة استخدام مكتبات الـ SDK الرسمية الخاصة بـ OpenAI لغات Python وNode.js ولغات أخرى. تأكد من تثبيت أحدث إصدار من مكتبة العميل المفضلة لديك. يتيح لك هذا النهج الحفاظ على منطق التطبيق الحالي كما هو مع استبدال عنوان URL الأساسي ومفتاح المصادقة. لا تحتاج إلى عميل مخصص أو طبقة توجيه معقدة. المتطلب الوحيد هو أن يدعم الكود المعلمات القياسية المتوافقة مع OpenAI مثل model، وmessages، وstream.
تكوين عنوان URL الأساسي والمفتاح
وجّه عميل الـ SDK الخاص بك إلى عنوان URL الأساسي لدينا: https://api.uncensoredgrok.com/v1. اضبط معلمة النموذج على uncensored للوصول إلى نموذجنا مفتوح الأوزان. احصل على مفتاح API الخاص بك من صفحة "الحصول على مفتاح API" بعد التسجيل باستخدام البريد الإلكتروني وكلمة المرور فقط. لا يلزم بطاقة ائتمان للبدء. يتم عرض المفتاح فورًا عند التسجيل ويمكن إعادة توليده في أي وقت، مما يلغي صلاحية المفتاح السابق. يضمن هذا التكوين البسيط توجيه طلباتك بشكل صحيح إلى خوادم وحدات معالجة الرسومات لدينا دون أي طبقات توجيه أو تجميع مخفية للنماذج.
إرسال أول إكمال
قم بإجراء طلب POST قياسي إلى /v1/chat/completions. يقبل النموذج مدخلات نصية ويعيد إخراجاً نصياً. من المهم ملاحظة أننا لا نقدم نقاط نهاية للتلوين (embeddings)، أو توليد الصور، أو معالجة الصوت، أو الضبط الدقيق (fine-tuning). نقطة النهاية الوحيدة المتاحة هي chat-completions. النموذج مُعد للإجابة بدون رفض المحتوى للمواضيع القانونية للبالغين، أو الخيالية، أو المثيرة للجدل. ومع ذلك، ينطبق حد صارم دائماً: الطلبات التي تحتوي على محتوى جنسي يتضمن قاصرين يتم حظرها. بالنسبة لجميع المحتويات القانونية الأخرى، يعالج النموذج الطلبات مباشرة بدون مرشطات وسيطة.
تمكين استجابات البث المتدفق
فعّل البث المتدفق عن طريق تعيين المعلمة stream إلى true في طلبك. تُرجع الـ API أحداثًا مرسلة من الخادم (SSE) يمكنك تحليلها رمزًا تلو الآخر. هذا مثالي لتجارب المستخدم في الوقت الفعلي. يتطابق تنسيق الاستجابة مع بروتوكول البث المتدفق القياسي الخاص بـ OpenAI، لذا يجب أن تعمل محللات التدفق الحالية لديك دون تعديل. يمكنك التعامل مع الرموز الجزئية عند وصولها، مما يقلل من زمن الاستجابة المُدرَك للمستخدمين. هذه الميزة مدعومة في نقطة النهاية chat-completions وتعمل بسلاسة مع كل من مكتبات SDK الخاصة بـ Python وNode.js.
استخدام استدعاء الأدوات
دعم استدعاء الدوال والأدوات بشكل كامل. يمكنك تعريف الأدوات في معلمة tools والسماح للنموذج بالقرار متى يستدعيها. تتضمن الاستجابة استدعاءات للأدوات يمكنك تنفيذها في منطق تطبيقك، ثم إعادة تغذية النتائج في المحادثة. هذا يتيح سير عمل معقد دون الحاجة إلى التنسيق الخارجي. يتعامل النموذج مع تعريفات الأدوات والاستدعاء بشكل شفاف. لاحظ أننا لا نقدم توجيه النموذج أو خيارات متعددة للنماذج؛ هذا النموذج الوحيد بدون رقابة يتعامل مع جميع تفاعلات الأدوات بشكل أصلي.
الحدود، الأخطاء، ونافذة السياق
يدعم نموذجنا نافذة سياق بحجم 100,000 رمز، مما يجمع بين رموز الموجّه ورموز الرد. حد حجم جسم الطلب هو 8 ميجابايت. يُسمح بـ 300 طلب في الدقيقة لكل مفتاح API. إذا تلقيت خطأ 401، فإن مفتاحك غير صالح أو منتهي الصلاحية. يشير الخطأ 402 إلى عدم كفاية الرصيد المسبق للدفع. يعني الخطأ 429 أنك تجاوزت حدّ المعدل. التسعير شفاف: $0.15 لكل مليون رمز إدخال و$0.50 لكل مليون رمز إخراج. الرصيد لا ينتهي. تحقق من نقطة النهاية للنماذج المتاحة لتأكيد أن معرف النموذج هو uncensored.
cURL
curl https://api.uncensoredgrok.com/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."}]
}'Python
from openai import OpenAI
client = OpenAI(base_url="https://api.uncensoredgrok.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.uncensoredgrok.com/v1", apiKey: process.env.API_KEY });
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);البث المتدفق
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Tell the story in second person."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)المواصفات التقنية
كل الحدود والميزات الفعلية للـ API في مكان واحد — راجعها قبل شحن الرصيد.
| البند | القيمة |
|---|---|
| صيغة API | متوافق مع OpenAI: يعمل أي SDK من OpenAI بتغيير base URL والمفتاح فقط |
| Base URL | https://api.uncensoredgrok.com/v1 |
| نقاط النهاية | POST /v1/chat/completions · GET /v1/models |
| معرّف النموذج | uncensored |
| المصادقة | Authorization: Bearer YOUR_KEY |
| أقصى مخرجات | حتى ما تبقى من نافذة 100,000 رمزًا؛ max_tokens اختياري (بلا حد منفصل) |
| المعاملات | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| البث المتدفق | نعم — server-sent events؛ آخر جزء يتضمن استهلاك الرموز |
| نافذة السياق | 100,000 رمز (المدخلات والمخرجات معاً) |
| استدعاء الدوال | نعم — tools و tool_choice؛ الرد يتضمن tool_calls حتى أثناء البث؛ تُرسل النتائج كرسالة role: tool |
| وضع JSON | response_format: {"type": "json_object"} |
| حدّ المعدل | 300 طلب في الدقيقة لكل مفتاح |
| حجم الطلب | حتى 8 MB |
| ترويسات الرد | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| الطلبات المتزامنة | حتى 8 في الوقت نفسه لكل مفتاح |
| مكافأة | +5% من $50، +10% من $100، +15% من $200 |
| السعر | $0.15 لكل مليون رمز مدخلات · $0.50 لكل مليون رمز مخرجات |
| رصيد تجريبي مجاني | $0.50 لمدة 7 أيام، بدون بطاقة · مفتاح تجريبي: طلبان متوازيان، 60 طلبًا في الدقيقة؛ الحدود الكاملة (8 و300) بعد أول شحن |
| شحن الرصيد | USDT (TRC20) أو USDC (Base)، أي مبلغ صحيح من $20 إلى $500 |
| الفوترة | رصيد مسبق الدفع حسب الاستهلاك الفعلي؛ الأخطاء والرفض مجانية |
| الصلاحية | الرصيد المدفوع لا تنتهي صلاحيته، بدون اشتراك |
| تسجيل الدخول | Google أو البريد الإلكتروني وكلمة المرور |
| المحتوى | محتوى البالغين مسموح؛ يُرفض أي محتوى جنسي يتعلق بالقاصرين |
| المفاتيح | مفتاح نشط واحد لكل حساب؛ المفتاح الجديد يحل محل القديم |
رموز الأخطاء
تصل الأخطاء بصيغة JSON مع type ثابت؛ الطلبات الفاشلة أو المرفوضة لا تُحتسب.
| الرمز | النوع | المعنى |
|---|---|---|
400 | bad_request | JSON غير صالح أو رسائل فارغة أو معامل خاطئ أو تجاوز نافذة السياق |
401 | missing_key · invalid_key · key_revoked | لا يوجد مفتاح أو المفتاح خاطئ أو تم استبداله |
402 | no_credit | الرصيد فارغ — اشحن وتستأنف الطلبات فوراً |
403 | content_blocked | محتوى جنسي يتعلق بقاصرين — مرفوض دون احتساب |
404 | not_found | نقطة نهاية غير معروفة |
413 | request_too_large | جسم الطلب أكبر من 8 MB |
429 | rate_limited · concurrency | تجاوز 300 في الدقيقة أو 8 متزامنة — انتظر ثم أعد المحاولة |
503 | upstream_busy | النموذج مشغول — أعد المحاولة بعد ثوانٍ |
أسئلة وأجوبة
هل هذه هي واجهة برمجة التطبيقات الرسمية لـ Grok؟
لا. نحن خدمة مستقلة. لسنا OpenAI أو xAI أو أي مورد آخر. نموذجنا هو نموذج مفتوح الأوزان يعمل على خوادمنا الخاصة، ومضبط ليعطي ردودًا بدون رقابة. إنه متوافق مع تنسيق API الخاص بـ Grok لكنه منتج منفصل.
هل تستخدم موجّهاتي للتدريب؟
لا. لا تُستخدم الموجّهات المرسلة إلى الـ API الخاصة بنا في التدريب. نحن نركز على فائدة الـ API الخام. يتم الحفاظ على خصوصية بياناتك دون الحاجة إلى اتفاقيات مؤسسية معقدة.
ماذا يحدث إذا نفد الرصيد الخاص بي؟
ستُرجع الطلبات خطأ 402 حتى تقوم بشحن الرصيد المسبق للدفع. يمكنك الدفع بالعملات المشفرة (USDT أو USDC) بدءًا من $20. الرصيد لا ينتهي، لذا يمكنك إيقاف واستئناف الاستخدام حسب وتيرتك الخاصة.
مفتاحك على بُعد نموذج واحد
أنشئ حساباً، انسخ المفتاح، غيّر Base URL. هذا هو الإعداد الكامل.