أول طلب في خمس دقائق

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

تحاكي واجهة API الخاصة بنا واجهة OpenAI v1، مما يتيح لك تغيير نقاط النهاية دون تغيير منطق التطبيق الخاص بك. استخدم https://api.groknsfw.top/v1 كعنوان URL الأساسي. تتطلب المصادقة مفتاح API صالح يتم تمريره في رأس Authorization كرمز Bearer. يمكنك إنشاء هذا المفتاح فورًا عبر تسجيل الدخول إلى Google أو البريد الإلكتروني على لوحة التحكم. يدعم كل حساب مفتاحًا نشطًا واحدًا فقط؛ إصدار مفتاح جديد يلغي صلاحية المفتاح السابق على الفور. يسهل هذا النموذج أحادي المفتاح التحكم في الوصول لمعظم بيئات التطوير والاختبار.

الطلب الأول

أرسل طلب إكمال محادثة قياسي لاختبار الاتصال. معرّف النموذج هو uncensored، والذي يتعامل مع رفض المحتوى بشكل مختلف عن النماذج القياسية. فيما يلي مثال أساسي باستخدام أداة سطر الأوامر curl للتحقق من صحة مفتاحك وعنوان URL الأساسي.

Copycurl https://api.groknsfw.top/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."}]
  }'

إذا تلقيت استجابة JSON تحتوي على choices و usage، فإن تكاملك نشط. تحقق من كائن usage لرؤية استهلاك الرموز لتتبع الفواتير بدقة.

تكامل SDK Python

استخدم حزمة Python الرسمية openai للتفاعل مع نقطة النهاية الخاصة بنا. قم بتعيين سمات base_url و api_key قبل إجراء المكالمات. يعمل هذا النهج مع أي مكتبة تدعم مخطط OpenAI، مما يجعل الترحيل من مزودي الخدمات الآخرين أمرًا سهلاً.

Copyfrom openai import OpenAI

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

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

إعداد SDK Node.js

لتطبيقات JavaScript أو TypeScript، قم بتكوين SDK OpenAI للإشارة إلى عنوان URL الأساسي الخاص بنا. يضمن ذلك عمل رمز العميل الحالي الخاص بك دون تعديل. يستفيد نظام Node.js البيئي من هذا التوافق، مما يتيح النمذجة السريعة لواجهات دردشة NSFW.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.groknsfw.top/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 يدعم عناوين URL الأساسية المخصصة. يجب أن يتضمن كائن التكوين بشكل صارم خصائص apiKey و baseURL لتجنب عدم تطابق نقاط النهاية.

استجابات البث المتدفق (SSE)

فعّل توليد الرموز في الوقت الفعلي عن طريق تعيين stream: true في طلبك. تُرجع واجهة API دفق أحداث مرسلة من الخادم (SSE)، مما يسلم الرموز بمجرد توليدها. يقلل هذا من زمن الاستجابة المُدرَك للمستخدمين النهائيين في تطبيقات الدردشة.

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)

قم بتحليل أحداث SSE لاستخراج محتوى delta. يحتوي الجزء الأخير من الدفق على إحصائيات usage الإجمالية، والتي يجب استخدامها للمصالحة الدقيقة للفواتير. لا يؤثر البث المتدفق على عد الرموز أو التسعير.

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

تخضع طلباتك لحدّ قدره 300 طلب في الدقيقة و8 طلبات متزامنة لكل مفتاح. الحد الأقصى لحجم جسم الطلب هو 8 MB، وتدعم نافذة السياق ما مجموعه 100,000 رمز. تُعاد الأخطاء بتنسيقات HTTP القياسية: 401 للمفاتيح غير الصالحة، و402 لعدم كفاية الرصيد، و429 لحدود المعدل. أخطاء الرصيد مجانية، لكن حدود المعدل تتطلب منك تخفيف الطلبات. الحد الأقصى للإخراج لكل طلب هو 32,000 رمز؛ ويؤدي حذف max_tokens إلى الافتراض على 2,048 رمز.