البدء السريع for Grok Unrestricted users
اربط عميلك المتوافق مع OpenAI الحالي بالنموذج بدون رقابة في دقائق. استبدل عنوان URL الأساسي ومفتاح API، ثم أرسل الطلبات إلى نقاط النهاية التي تعرفها بالفعل.
المتطلبات المسبقة
قبل إرسال الطلبات، تأكد من امتلاكك لمفتاح API وعميل مُعد لنقاط النهاية المتوافقة مع OpenAI. أنشئ حسابًا على موقعنا باستخدام متابعة مع Google أو بريد إلكتروني وكلمة مرور. يظهر مفتاح API الخاص بك على الفور وهو الاعتماد الوحيد الذي تحتاجه. لا يلزم رقم هاتف أو بطاقة ائتمان للإعداد الأولي. ستتلقى رصيدًا تجريبيًا بقيمة 0.50 دولار صالح لمدة 7 أيام لاختبار نقطة النهاية. احصل على هذا الرصيد بنقرة واحدة في صفحة مفتاح API الخاص بك. للاستخدام الإنتاجي، قم بشحن الرصيد باستخدام USDT (TRC20) أو USDC (Base). تدعم الخدمة سير العمل القياسي لإدخال النص وإخراج النص مع نافذة سياق بحجم 100,000 رمز.
المصادقة
أدرج مفتاح API الخاص بك في رأس Authorization لكل طلب. استخدم مخطط Bearer متبوعًا بسلسلة المفتاح الخاص بك. هذا يصادق حسابك ضد عنوان URL الأساسي api.grokunrestricted.com. إذا كان المفتاح غير صالح أو مفقودًا، ستعيد الواجهة خطأ يشير إلى فشل المصادقة. تأكد من أن مفتاحك حديث؛ سيحل إنشاء مفتاح جديد محل المفتاح السابق. لا يلزم نطاقات أو أذونات إضافية لإكمال الدردشة القياسية.
الدردشة الإكمال نقطة النهاية
أرسل الرسائل إلى نقطة النهاية POST /v1/chat/completions. حدد معرف النموذج كـ uncensored. يجب أن يتضمن جسم الطلب مصفوفة messages مع سجل محادثاتك. تعيد الواجهة استجابة نصية ضمن مصفوفة choices. تدعم نقطة النهاية المعلمات القياسية مثل temperature، وtop_p، وstop. يتم احتساب رسوم الطلبات بناءً على استخدام الرموز الفعلي. لا تتحمل الأخطاء والرفض أي رسوم.
الاستجابات البث المتدفق
استخدم أحداث الإرسال من الخادم (SSE) للبث المتدفق. اضبطstream على true في طلبك. تعيد الواجهة تدفقًا من القطع، يحتوي كل منها على نص جزئي. يتضمن القطعة النهائية استخدام الرموز الإجمالي للطلب. يقلل هذا النهج من زمن الاستجابة المدرك للاستجابات الكبيرة. استخدم مكتبات SDK الرسمية للتعامل مع تحليل التدفق تلقائيًا. يعمل البث المتدفق مع جميع المعلمات القياسية.
استدعاء الدوال
تمكين استخدام الأدوات عن طريق توفير مصفوفة tools في الطلب. حدد توقيعات الوظائف مع الأسماء والوصف ومخططات المعلمات. يعيد النموذج استدعاءات الأدوات في الاستجابة عند الاقتضاء. يجب عليك تنفيذ الأداة من جانبك وإعادة النتائج في الرسائل اللاحقة. لا تتحقق الواجهة من دقة إخراج الأداة؛ أنت مسؤول عن التعامل مع النتائج. استخدم tool_choice للتحكم في كيفية اختيار النموذج للوظائف.
وضع JSON
فرض إخراج JSON صالح من النموذج عن طريق تعيين response_format إلى {"type": "json_object"}. هذا مفيد لاستخراج البيانات المهيكلة أو توليد التكوين. سيحاول النموذج الامتثال لقواعد صيغة JSON. تأكد من أن الموجّه يصف الهيكل المتوقع بوضوح. قد تحدث استجابات JSON غير صالحة إذا واجه النموذج صعوبة مع المخططات المعقدة. تحقق من الإخراج من جانب العميل قبل التحليل.
cURL
curl https://api.grokunrestricted.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.grokunrestricted.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.grokunrestricted.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 في مكان واحد — راجعها قبل شحن الرصيد.
| البند | القيمة |
|---|---|
| صيغة API | متوافق مع OpenAI: يعمل أي SDK من OpenAI بتغيير base URL والمفتاح فقط |
| معرّف النموذج | uncensored |
| نقاط النهاية | POST /v1/chat/completions · GET /v1/models |
| Base URL | https://api.grokunrestricted.com/v1 |
| المصادقة | Authorization: Bearer YOUR_KEY |
| المعاملات | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| نافذة السياق | 100,000 رمز (المدخلات والمخرجات معاً) |
| البث المتدفق | نعم — server-sent events؛ آخر جزء يتضمن استهلاك الرموز |
| استدعاء الدوال | نعم — tools و tool_choice؛ الرد يتضمن tool_calls حتى أثناء البث؛ تُرسل النتائج كرسالة role: tool |
| أقصى مخرجات | حتى ما تبقى من نافذة 100,000 رمزًا؛ max_tokens اختياري (بلا حد منفصل) |
| وضع JSON | response_format: {"type": "json_object"} |
| حدّ المعدل | 300 طلب في الدقيقة لكل مفتاح |
| الطلبات المتزامنة | حتى 8 في الوقت نفسه لكل مفتاح |
| ترويسات الرد | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| حجم الطلب | حتى 8 MB |
| رصيد تجريبي مجاني | $0.50 لمدة 7 أيام، بدون بطاقة · مفتاح تجريبي: طلبان متوازيان، 60 طلبًا في الدقيقة؛ الحدود الكاملة (8 و300) بعد أول شحن |
| الصلاحية | الرصيد المدفوع لا تنتهي صلاحيته، بدون اشتراك |
| مكافأة | +5% من $50، +10% من $100، +15% من $200 |
| شحن الرصيد | USDT (TRC20) أو USDC (Base)، أي مبلغ صحيح من $20 إلى $500 |
| الفوترة | رصيد مسبق الدفع حسب الاستهلاك الفعلي؛ الأخطاء والرفض مجانية |
| السعر | $0.15 لكل مليون رمز مدخلات · $0.50 لكل مليون رمز مخرجات |
| تسجيل الدخول | 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 | النموذج مشغول — أعد المحاولة بعد ثوانٍ |
الأسئلة and answers
كيف أتعامل مع حدّ المعدل؟
تسمح الـ API بـ 300 طلب في الدقيقة لكل مفتاح و8 طلبات متزامنة. إذا تجاوزت هذه الحدود، ستعيد الـ API خطأ. يجب عليك تنفيذ منطق إعادة المحاكمة مع زيادة زمنية أسية في العميل الخاص بك للتعامل مع الحمل الزائد المؤقت بكفاءة.
ماذا يحدث إذا نفد رصيدك؟
ستفشل الطلبات إذا كان رصيد حسابك غير كافٍ. الأخطاء مجانية، لذا لن يتم خصم المبلغ عن الطلبات الفاشلة بسبب نقص الأموال. قم بشحن حسابك بالعملات المشفرة لاستئناف الخدمة. الرصيد لا ينتهي.
هل نافذة السياق 100k رمز إجمالي؟
نعم، نافذة السياق هي 100,000 رمز لكل من الموجّه والإكمال معاً. لا يوجد حد أقصى منفصل للإخراج. إذا لم تحدد max_tokens، يمكن أن يمتد الرد إلى نهاية النافذة.
حسابك key is one form away
أنشئ حساباً، وانسخ المفتاح، ثم غيّر URL الأساسي. هذه هي الإعدادات الكاملة.
احصل على مفتاح API