groknsfwprompt.comبداية سريعة
بداية سريعة للمطورين: واجهة برمجة تطبيقات LLM غير خاضعة للرقابة
ابدأ البناء باستخدام واجهة برمجة التطبيقات للذكاء الاصطناعي اللامقيدة في ثوانٍ باستخدام أدوات SDK المتوافقة مع OpenAI. يغطي هذا الدليل المصادقة، البث، والاقتصاد الخاص بالرموز للتوليد الحر للنصوص.
إعداد عنوان URL الأساسي والمصادقة
يصادق مفتاح API الخاص بك على كل طلب موجه إلى نقطة النهاية المستضافة لدينا. استخدم عنوان URL الأساسي https://api.groknsfwprompt.com/v1 واضبط النموذج إلى uncensored لتوليد النص. لا نقوم بتوجيه حركة المرور إلى موردين آخرين، لذا ترسل رمز العميل الخاص بك الطلبات مباشرة إلى خوادمنا. يعتمد المصادقة على ال Authorization رأس مع رمز Bearer. لا توجد رسوم اشتراك، بل فقط رسوم رصيد مدفوع مسبقاً بناءً على استخدام الرموز الفعلي.
الطلب الأول باستخدام cURL
أرسل إكمال بسيط للتحقق من الاتصال والفوترة. يطلب هذا المثال استجابة إبداعية لموجه لوحة كوميكس NSFW. تأكد من أن رصيد الرصيد المدفوع مسبقاً يغطي تكلفة الرموز المقدرة قبل التنفيذ. نفرض رسومًا على رموز الإدخال والإخراج بشكل منفصل بأسعار ثابتة.
curl https://api.groknsfwprompt.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "generate a text file named report.txt"}]
}'
تحقق من رمز الحالة لتأكيد التسليم الناجح. تُعيد الواجهة البرمجية بيانات بتنسيق JSON تحتوي على النص المُولّد. إذا تلقيت خطأ 402، قم بشحن رصيدك بالعملات المشفرة عبر USDT أو USDC. لا تستهلك الأخطاء مثل الطلبات غير الصالحة رصيدك.
تكامل واجهة برمجة تطبيقات Python
ثبّت الحزمة الرسمية من OpenAI وقم بتكوين عنوان URL الأساسي ليشير إلى خدمتنا. يتيح لك ذلك استخدام صيغة بايثون المألوفة لجميع التفاعلات. اضبط base_url المعامل صراحةً لتجنب الوصول إلى نقطة النهاية الافتراضية لـ OpenAI. يجب تعيين معرّف النموذج إلى uncensored للوصول إلى وضع المحتوى غير المقيد.
from openai import OpenAI
client = OpenAI(base_url="https://api.groknsfwprompt.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)
التعامل مع الاستثناءات بسلاسة لإدارة حدود المعدل أو عدم كفاية الأموال. تقوم الـ SDK بتدفق البيانات بكفاءة، مما يقلل من استهلاك الذاكرة للردود الطويلة. يمكنك تعديل المعلمات مثل temperature للتحكم في الإبداع. يعمل هذا النهج بنفس الطريقة لتوليد النصوص البسيطة أو المخرجات المهيكلة المعقدة.
تطبيق SDK Node.js
قم بتهيئة العميل باستخدام مفتاح API الخاص بك وعنوان URL الأساسي المخصص. يمكن لمطوري Node.js الاستفادة من واجهة متوافقة مع OpenAI نفسها للتطوير السريع. قم بتعيين معرف النموذج إلى uncensored لسلوك متسق. يدعم هذا الإعداد كل من أنماط الطلبات المتزامنة وغير المتزامنة.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.groknsfwprompt.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);
معالجة أجزاء الاستجابة لتجميع النص النهائي. تتعامل مكتلة التطوير (SDK) مع تفاصيل الاتصال بـ HTTP تلقائياً. تأكد من التعامل مع إعادة المحاولة المحتملة للشبكة إذا تعرضت بنية التحتية الخاصة بك لانقطاع مؤقت. تتكامل هذه الطريقة بسلاسة مع مسارات Express أو Fastify الموجودة.
استجابات البث وحساب الرموز
فعّل البث عن طريق تعيين stream: true في معاملات الطلب الخاص بك. يُسلّم هذا الرموز تدريجياً أثناء توليدها، مما يحسن من زمن الاستجابة المُدرَك للمستخدمين. تحتوي الشريحة الأخيرة على إحصائيات استخدام الرموز الإجمالية للتحقق من الفوترة. التدفق مثالي لواجهات الدردشة أو أدوات الكتابة الإبداعية في الوقت الفعلي.
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)
تحليل كل قطعة لتحديث واجهة المستخدم الخاصة بك أو تسجيل التقدم. تضمن واجهة برمجة التطبيقات أن جميع الرموز مدرجة في تقرير الاستخدام النهائي. يساعدك هذا الشفافية على تتبع التكاليف بدقة دون تخمين استهلاك الرموز. لا يؤثر البث على هيكل التسعير لكل رمز.
حدود المعدلات والأخطاء ونافذة السياق
يدعم مفتاحك 300 طلب في الدقيقة و8 اتصالات متزامنة. يؤدي تجاوز هذه الحدود إلى خطأ 429، والذي يمكنك إعادة المحاولة فيه باستخدام آلية التخلف الأسي. تمتد نافذة السياق إلى 100,000 رمز لكل من النص المدخل والمخرج معاً. حافظ على حجم الإدخال معقولاً لتجنب الوصول إلى حد الإخراج البالغ 16,000 رمز. يشير الخطأ 401 إلى مفتاح API غير صالح أو مفقود، بينما يعني 402 استنفاد رصيدك المدفوع مسبقاً. لا تُصدر استرداد أموال للرموز المستهلكة، لكن أخطاء الفوترة تُحل عبر الدعم. يضمن هذا الحد الصاريم الاستخدام العادل لجميع المطورين الذين يستخدمون واجهة برمجة تطبيقات LLM غير الخاضعة للرقابة.
الأسئلة الشائعة
هل هذه هي واجهة برمجة التطبيقات الرسمية من Grok؟
لا، هذه خدمة مستقلة تشغل نموذجها الخاص غير الخاضع للرقابة. لا ننتمي إلى xAI أو أي باحث آخر. واجهتنا البرمجية (API) متوافقة مع حزم SDK الخاصة بـ OpenAI لكنها تقدم نموذجًا أساسيًا مختلفًا.
ماذا يحدث إذا تجاوزت حد معدل الطلب؟
ستتلقى رمز الحالة 429. الطلبات محدودة بـ 300 طلب في الدقيقة لكل مفتاح. يجب أن تنتظر حتى انتهاء النافذة أو ترقية التزامن إذا لزم الأمر. يتم تحديد الاتصالات المتزامنة بحد أقصى 8 لكل مفتاح.
هل تدعم الـ API توليد الصور؟
لا، تتعامل هذه الخدمة API فقط مع مدخلات ومخرجات النصوص. لا تدعم الصور أو الصوت أو الفيديو أو التضمينات. ركز على مهام توليد النصوص الخالصة مثل الكتابة الإبداعية أو إكمال الدردشة.
احصل على مفتاحك فوراً
سجّل، احصل على مفتاحك، وحدّث عنوان URL الأساسي. بهذه البساطة.