دليل تكامل API Grok

لماذا تستخدم بديل واجهة برمجة تطبيقات Grok غير الخاضع للرقابة؟

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

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

فكر في الفرق بين واجهة الدردشة وواجهة برمجة التطبيقات (API) الخام. قد تخفي واجهة الدردشة المخرجات الدقيقة. تكشف واجهة برمجة التطبيقات (API) عن تدفق الرموز الكامل. هذا الشفافية حاسمة للمطورين الذين يبنيون أدوات متخصصة.

تعمل خدمتنا بشكل مستقل. نحن لا نقدم Grok أو أي نموذج آخر من موردي الخدمات. نقدم نموذج لغة كبير مميزاً وغير خاضع للرقابة. يعمل على خوادمنا الخاصة. يظل الواجهة مألوفة لمستخدمي OpenAI.

الفوائد الرئيسية

• لا توجد رسوم اشتراك شهرية.
• فوترة مسبقة شفافة.
• مخرجات خام للمحتوى البالغ القانوني.
• لا رفض خفي للمواضيع المثيرة للجدل.

فهم بنية نقطة نهاية واجهة برمجة التطبيقات

يتعامل نقطتا النهاية مع جميع التفاعلات: POST /v1/chat/completions وGET /v1/models. تتبعان مواصفات واجهة برمجة التطبيقات القياسية لـ OpenAI. ترسل حمولة JSON مع رسائل النظام والمستخدم. يعيد الخادم استجابة JSON تحتوي على النص المُولَّد.

تقوم نقطة النهاية GET بإدراج النماذج المتاحة. وهي تؤكد أن اتصالك صالح. استخدم هذا للتحقق من أن مفتاح API الخاص بك يعمل قبل إرسال أحمال عمل كبيرة. كما تُظهر معرّف النموذج الذي يجب تضمينه في طلباتك.

عنوان الأساس الخاص بنا هو HTTPS://api.isgrokunfiltered.com/v1. هذا يحل محل عنوان OpenAI الافتراضي في تكوين العميل الخاص بك. معرف النموذج الذي يجب إرساله هو "uncensored". يضمن هذا أن تضرب الخادم الصحيح.

المصادقة تستخدم رمز حامل في رأس التفويض. أضف مفتاح API الخاص بك مباشرة. لا توجد تدفقات OAuth معقدة مطلوبة. يقلل هذا البساطة من وقت التكامل بشكل كبير.

ملخص نقاط النهاية

الطريقة	المسار	وظيفة
POST	/v1/chat/completions	يُولّل استجابات نصية
GET	/v1/models	تعرض النماذج المتاحة

تكوين عميلك للتدفق

فعّل التدفق عن طريق تعيين معلمة stream إلى true في جسم الطلب. يُعيد ذلك أحداث مُرسلة من الخادم (SSE) بدلاً من كائن JSON واحد. يحتوي كل حدث على جزء جزئي من الاستجابة. يمكنك عرض النص للمستخدمين في الوقت الفعلي.

يقلل التدفق من زمن الاستجابة المُدرَك للاستجابات الطويلة. يرى المستخدمون المخرجات أثناء توليدها. يحسن هذا التجربة لواجهات تشبه الدردشة. كما يسمح لك بإلغاء الطلبات مبكراً إذا لزم الأمر.

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

التعامل مع تنسيق SSE بشكل صحيح. حلل كل سطر يبدأ بـ "data: ". تجاهل حدث "[DONE]" النهائي. يضمن ذلك معالجة تطبيقك لكل رمز بشكل صحيح.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.isgrokunfiltered.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)

معالجة استدعاء الوظائف في الوضع غير الخاضع للرقابة

يتيح لك استدعاء الوظائف تنفيذ الكود الخاص بك بناءً على مخرجات النموذج. أرسل قائمة بالأدلة في الطلب. يعيد النموذج مصفوفة tool_calls بدلاً من النص العادي. ينفذ الكود الخاص بك الوظيفة ويرسل النتيجة مرة أخرى.

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

استخدم وضع JSON لفرض تنسيقات مخرجات صارمة. حدد response_format إلى json_object. يعيد النموذج JSON صالح فقط. هذا يقلل من أخطاء التحليل في الخلفية الخاصة بك. يضمن هياكل بيانات متسقة.

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

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.isgrokunfiltered.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);

تحسين تكاليف الرموز المميزة للسياقات الطويلة

تدعم نافذة السياق ما يصل إلى 100,000 رمز مرمز. يشمل ذلك كل من النص الوارد والإجابة المولدة. تستهلك السياقات الأطول رصيداً مدفوعاً مسبقاً أكثر. راقب استخدامك للرموز المرمزة لتجنب الرسوم غير المتوقعة.

تكاليف الرموز المدخلة 0.15 دولار لكل مليون. تكاليف الرموز المخرجة 0.50 دولار لكل مليون. الرموز المخرجة أغلى بكثير. قم بتحسين مطالباتك لتقليل حجم الإدخال. استخدم تعليمات النظام الموجزة. تجنب إرسال سجلات غير ضرورية.

حدد معلمة max_tokens للتحكم في طول الإخراج. القيمة الافتراضية هي 2,048 رمز. يمكنك زيادة هذا الحد إلى 16,000 رمز لكل طلب. يمنع هذا التوليد الهارب الذي يستنفذ الرصيد بسرعة.

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

تفاصيل التسعير

• الإدخال: $0.15 / مليون رمز
• الإخراج: 0.50 دولار / 1M رمز
• الحد الأقصى للإخراج: 16,000 رمز مميز
• نافذة السياق: 100,000 رمز

إعدادات حدود المعدلات والتزامن

يتيح كل مفتاح API 300 طلب في الدقيقة. ينطبق هذا الحد عالمياً على مفتاحك. تحتاج التطبيقات عالية التردد إلى إدارة معدل طلباتها بعناية. يؤدي تجاوز الحد إلى إرجاع خطأ 429 Too Many Requests.

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

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

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

Copycurl https://api.isgrokunfiltered.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a list of five unique Python script ideas."}]
  }'

نقل مفاتيح Grok API الحالية

الترحيل إلى واجهة برمجة التطبيقات (API) الخاصة بنا يتطلب تغيير عنوان URL الأساسي ومعرف النموذج. تظل بنية كود العميل الحالي الخاص بك كما هي إلى حد كبير. قم بتحديث عنوان URL الأساسي إلى HTTPS://api.isgrokunfiltered.com/v1. قم بتغيير معرف النموذج إلى "uncensored".

استكشاف أخطاء التكامل الشائعة

تشير أخطاء 401 Unauthorized إلى مفتاح API غير صالح أو منتهي الصلاحية. تحقق من مفتاحك في لوحة التحكم. تأكد من إرساله في رأس Authorization. تحقق من وجود مسافات بادئة أو أخطاء مطبعية.

يشير خطأ 429 Too Many Requests إلى تجاوزك لحد المعدل. قلل من وتيرة طلباتك أو زد الفاصل الزمني بين المكالمات. استخدم إعادة المحاولة مع التراجع الأسي. يمنع ذلك إرباك الخادم.

400 Bad Request غالباً ما ينجم عن JSON غير صالح. تأكد من مطابقة حمولة البيانات للمخطط المتوقع. تحقق من الحقول المطلوبة المفقودة مثل messages أو model. استخدم نقطة النهاية GET للتحقق من توفر النموذج.

أخطاء 500 في الخادم الداخلي نادرة لكن ممكنة. أعد محاولة الطلب بعد تأخير قصير. إذا استمرت المشكلة، تواصل مع الدعم. يمكن لسجلاتنا المساعدة في تحديد السبب الجذري بسرعة.

Copystream = 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)

الخطوات التالية: اختبار النموذج غير الخاضع للرقابة الخاص بك

ابدل بطلب بسيط لتوليد النص. أرسل طلباً قصيراً وتحقق من تنسيق الاستجابة. تحقق من أن التدفق يعمل بشكل صحيح. تأكد من أن استدعاء الوظائف يتكامل بسلاسة مع الكود الخاص بك.

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

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

سجّل باستخدام Google أو البريد الإلكتروني. احصل على مفتاح API الخاص بك فوراً. لا يتطلب رقم هاتف. ابدأ الاختبار فوراً برصيد تجريبي بقيمة $0.50. يمنحك طريقة آمنة لتقييم الخدمة.