مستندات واجهة API المتوافقة مع OpenAI

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

ابدأ كل طلب بتعيين base_url إلى https://api.nsfwgemma.com/v1 ونقل مفتاح API الخاص بك في Authorization رأس الصفحة. تتلقى مفتاحك فوراً بعد التسجيل باستخدام جوجل أو البريد الإلكتروني، دون الحاجة إلى رقم الهاتف. احتفظ بهذا المفتاح بأمان، فهو الاعتماد الوحيد اللازم للوصول إلى الخدمة.

POST /v1/chat/completions: المعلمات والأمثلة

أرسل أول رسالة إلى نقطة النهاية باستخدام تنسيق إكمال الدردشة القياسي. معرف النموذج هو دائماً "uncensored"، ويمكنك التحكم في نمط المخرجات بمعاملات مثل temperature و top_p. تتعامل هذه النقطة النهائية مع جميع توليدات النص دون الحاجة إلى إعدادات محلية معقدة.

Copycurl https://api.nsfwgemma.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top ten system prompts for the model"}]
  }'

تأكد من أن حمولتك تتضمن model field مضبوطًا على "uncensored" و messages مصفوفة تحتوي على طلبك. تُعيد النظام استجابة JSON مهيكلة تحتوي على النص المُولّد.

GET /v1/models: عرض النماذج المتاحة

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

Copyfrom openai import OpenAI

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

يؤكد الرد معرف النموذج وحدود الرموز، مما يضمن تكوين عميلك بشكل صحيح لنموذج اللغة الكبير غير الخاضع للرقابة.

استجابات البث مع SSE

فعّل البث عن طريق تعيين stream: true لتلقي الرموز في الوقت الفعلي عبر أحداث Server-Sent. يقلل هذا من زمن الاستجابة المُدرَك لكتابة المحتوى طويل المدى أو سيناريوهات لعب الأدوار. يتم تضمين إحصائيات استخدام الرمز في القطعة الأخيرة من التدفق.

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)

تحليل كل كائن delta لعرض النص تدريجيًا، مما يوفر تجربة مستخدم أكثر سلاسة لتطبيقات روبوتات الدردشة NSFW التفاعلية.

معالجة الأخطاء واستخدام التوكن

التعامل مع أخطاء HTTP الشائعة بسلاسة: يشير 401 إلى مفتاح غير صالح أو منتهي الصلاحية، ويعني 402 الحاجة إلى شحن الرصيد، بينما يشير 429 إلى استنفاد حد المعدل. لا تستهلك الأخطاء رصيدك المدفوع مسبقاً، لذا يمكنك إعادة المحاولة دون عقوبة. تحقق دائماً من usage field في الاستجابات الناجحة لتتبع الاستهلاك.

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

يدعم كل مفتاح API 300 طلب في الدقيقة وحتّى 8 طلبات نشطة متزامنة. الحد الأقصى لحجم جسم الطلب هو 8 ميجابايت، وهو يتناسب مع معظم نوافذ السياق القياسية. يؤدي تجاوز هذه الحدود إلى تشغيل خطأ 429 حتى يتم إعادة تعيين النافذة.

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

المعلمات المدعومة: درجة الحرارة، Top P، والمزيد

تحكم في العشوائية والحتمية باستخدام temperature, top_p, stop, seed, ومعاملات العقوبة. استخدم response_format تعيين إلى {"type": "json_object"} للمخرجات المُهيّأة. دعم استدعاء الوظائف عبر tools المعامل للتكاملات المتقدمة.

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

Node.js

Copyimport OpenAI from "openai";

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