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

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

تُطبّق واجهة API الخاصة بنا البروتوكول المتوافق مع openai. تُصادق من خلال تمرير مفتاح API الفريد الخاص بك في رأس Authorization. عنوان URL الأساسي لجميع الطلبات هو https://api.groknsfw.cc/v1. على عكس المزودين القياسيين، لا نطلب معرّف منظمة محددًا. ما عليك سوى إنشاء مفتاحك عبر لوحة التحكم أو صفحة التسجيل السريع. احفظ مفتاحك بأمان؛ فهو يمنحك وصولاً كاملاً إلى رصيدك المسبق الدفع. لا توجد رسوم شهرية أو اشتراكات، فقط تسعير حسب الرمز مع عدم انتهاء الصلاحية.

يجب أن يتضمن كل طلب معرّف النموذج uncensored. هذا النموذج هو نموذج لغوي كبير مفتوح الأوزان مستضاف على بنيتنا التحتية، وهو مميز عن موردي الآخرين. تم ضبطه لتقديم إجابات غير مقيدة للمحتوى البالغ القانوني مع الحفاظ على دقة عالية في الحقائق. لا تحتاج إلى تغيير إصدار مكتبة العميل؛ تعمل OpenAI SDKs القياسية بشكل مباشر.

إكمال الدردشة الأساسي

أرسل طلب إكمال دردشة قياسي لتوليد النص. تقبل نقطة النهاية قائمة من الرسائل، بما في ذلك أدوار النظام والمستخدم والمساعد. يسمح هذا الهيكل بتحديد السياق والتعليمات وسجل المحادثة. يعيد النموذج استجابة نصية بناءً على الموجّه المقدم. يمكنك التحكم في إبداع المخرجات باستخدام معاملات مثل temperature و top_p. إذا لم يتم تحديد max_tokens، فإن حد المخرجات الافتراضي هو 2,048 رمز. يمكنك زيادة هذا الحد حتى 32,000 رمز لكل طلب، ضمن نافذة السياق الإجمالية البالغة 100,000 رمز.

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

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

استدعاء الدوال والأدوات

تدعم واجهة API استدعاء الدوال، مما يسمح للنموذج بإخراج بيانات هيكلية بدلاً من نص عادي. عرّف أدواتك في معلمة tools، محدداً اسم الدالة، والوصف، ومخطط المعاملات. عندما يحدد النموذج أن استدعاء الأداة ضروري، فإنه يعيد اسم الدالة والحجج بتنسيق JSON. يقوم تطبيقك بعد ذلك بتنفيذ الدالة وإدخال النتيجة مرة أخرى في المحادثة. يتيح ذلك سير العمل المعقد، واستخراج البيانات، والإجراءات الآلية. اضبط tool_choice للتحكم فيما إذا كان يجب على النموذج استخدام أداة أو يمكنه الاختيار بحرية.

وضع JSON

لتطبيقات تتطلب تنسيقات مخرجات صارمة، استخدم وضع JSON. اضبط معامل response_format على {"type": "json_object"}. سيقيّد النموذج مخرجاته إلى JSON صالح. هذا مثالي لتحليل البيانات إلى أنظمة الخلفية الخاصة بك أو توليد تكوينات هيكلية. لاحظ أن وضع JSON قد يقلل قليلاً من مرونة التفكير في النموذج مقارنة بالنص الحر. تأكد من أن الموجّه يوجه النموذج بوضوح لإخراج JSON فقط. تعمل هذه الميزة جنبًا إلى جنب مع استدعاء الدوال ولكنها توفر واجهة أبسط عندما تحتاج فقط إلى بيانات هيكلية بدون تعريفات الأدوات.

استخدام الرموز والحدود

حسابك محدود بـ 300 طلب في الدقيقة و 8 طلبات متزامنة لكل مفتاح. الحد الأقصى لحجم جسم الطلب هو 8 ميجابايت. إذا تجاوزت هذه الحدود، تُعيد واجهة برمجة التطبيقات رمز حالة 429. أخطاء المصادقة تُعيد 401، وعدم كفاية الرصيد تُعيد 402. التسعير هو $0.25 لكل مليون رمز مدخل و $1.00 لكل مليون رمز مخرج. الأخطاء والرفض لا تستهلك الرصيد. نافذة السياق هي 100,000 رمز إجمالاً، بما في ذلك كل من الموجّه والإكمال. أدر استخدام الرموز بعناية لتجنب التكاليف غير المتوقعة. الرصيد لا ينتهي أبدًا، ويمكنك الشحن في أي وقت باستخدام العملات المشفرة.

cURL

Copycurl https://api.groknsfw.cc/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

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

البث المتدفق

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)