البدء السريع لمستخدمي Unhinged Grok

المصادقة وعنوان URL الأساسي

واجهة API الخاصة بنا متوافقة مع OpenAI، مما يعني أنك لا تحتاج إلى مكتبة جديدة. تحتاج فقط إلى تحديث قيمتين في تكوينك الحالي: base_url و api_key. يتم إنشاء مفتاح API الخاص بك فورًا عند تسجيل الدخول عبر Google أو البريد الإلكتروني. احفظ هذا المفتاح بأمان؛ فهو الاعتماد الوحيد المطلوب للمصادقة.

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

مثال التكوين

• عنوان URL الأساسي: https://api.unhingedgrok.com/v1
• مفتاح API: مفتاحك الفريد من لوحة التحكم

تحقق من اتصالك عن طريق سرد النماذج المتاحة. يؤكد هذا أن المصادقة تعمل بشكل صحيح قبل إرسال طلبات التوليد.

الطلب الأول

ابدأ بإرسال طلب إكمال نصي بسيط. يستخدم هذا المثال curl لإظهار الهيكل الخام لبروتوكول HTTP. يستهدف الطلب نقطة النهاية /v1/chat/completions بمعرف النموذج uncensored. تُرجع الاستجابة النص المُولّد في مصفوفة choices.

يعمل هذا النهج المباشر مع أي لغة أو أداة تدعم تنسيقات HTTP القياسية لـ OpenAI. يمكنك اختبار هذا فوراً بعد إنشاء مفتاحك.

طلب HTTP المباشر

نسخcurl https://api.unhingedgrok.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."}]
  }'

تكامل SDK Python

استخدم مكتبة Python الرسمية لـ OpenAI لدمج واجهتنا. قم بتثبيت الحزمة عبر pip. قم بتهيئة العميل بمفتاحك وعنوان URL الأساسي المخصص. تعمل باقي طرق SDK، مثل chat.completions.create، تماماً كما هو موثق لـ OpenAI.

هذه الطريقة مثالية لخدمات الخلفية، وسكربتات معالجة البيانات، أو سير العمل الآلي. تتعامل SDK مع تسلسل JSON وتحليل الاستجابة تلقائياً.

مثال على كود Python

نسخfrom openai import OpenAI

client = OpenAI(base_url="https://api.unhingedgrok.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 لـ Node.js

لبيئات JavaScript أو TypeScript، استخدم حزمة npm الرسمية openai. قم بتكوين العميل بنفس عنوان URL الأساسي والمفتاح. يدعم SDK الخاص بـ Node.js أنماط الاستدعاء (Callbacks) والأنماط القائمة على الوعود.

يتيح لك هذا الإعداد تضمين توليد النصوص بدون رقابة مباشرة في تطبيقات الويب، أو الوظائف الخالية من الخوادم (serverless functions)، أو أدوات الأتمتة القائمة على Node. يظل التعامل مع الأخطاء متسقًا مع سلوك حزمة OpenAI SDK القياسية.

مثال على كود Node.js

نسخimport OpenAI from "openai";

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

استجابات البث المتدفق

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

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

مثال على البث المتدفق

نسخ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)

الحدود والأخطاء والنافذة السياقية

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

تسمح حدود المعدل بـ 300 طلب في الدقيقة لكل مفتاح. الطلبات المتزامنة محدودة بـ 8. يجب ألا تتجاوز أحجام الطلبات 8 ميجابايت. تعامل مع أخطاء HTTP القياسية: يشير 401 إلى مفتاح غير صالح، ويُشير 402 إلى عدم كفاية الرصيد، بينما يعني 429 تجاوز حد المعدل. لا تستهلك الأخطاء الرصيد.