وثائق واجهة برمجة التطبيقات (API) للمطورين

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

مفتاح واجهة برمجة التطبيقات الخاص بك يصادق على كل طلب. استخدم https://api.nsfwtext.cc/v1 كعنوان URL الأساسي. مرر المفتاح في Authorization الرأس. يعمل هذا الإعداد مع أي عميل متوافق مع OpenAI.

Copycurl https://api.nsfwtext.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Check server status now"}]
  }'

أنشئ مفتاحك على الفور عبر Google أو البريد الإلكتروني. لا يلزم رقم هاتف. يظهر المفتاح مباشرة بعد التسجيل.

الطلب الأول

أرسل أول رسالة إلى النموذج غير المقيد (uncensored). استخدم معرف النموذج uncensored للمخرجات الخام. يقبل نقطة النهاية حمولات chat-completions القياسية.

Copyfrom openai import OpenAI

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

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

استجابات البث

استلم الرموز في الوقت الفعلي عبر أحداث الإرسال من الخادم. فعّل التدفق عن طريق ضبط stream إلى true. يظهر استخدام الرموز في الشريحة النهائية.

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)

معالجة كل قطعة فور وصولها. يقلل هذا من زمن الاستجابة المُدرَك للمخرجات الطويلة. تعامل مع الجمل الجزئية بسلاسة في واجهة المستخدم.

استدعاء الوظائف ووضع JSON

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

Copyimport OpenAI from "openai";

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

حدد تعريفات الأدوات في الـ tools مصفوفة. يعيد النموذج استدعاءات الأدوات أو نصًا مباشرًا. تحقق من بنية JSON قبل الاستخدام.

المعاملات والسياق

تحكّم في التوليد باستخدام temperature, top_p، و seed. تدعم نافذة السياق 100,000 رمز إجماليًا. الحد الأقصى للإخراج هو 16,000 رمز في كل طلب.

تعيين max_tokens لمنع الاستخدام المفرط. استخدم stop التسseqs لتقطيع المخرجات مبكرًا. اضبط presence_penalty للتنوع.

الحدود والأخطاء

تسمح حدود معدل الطلبات بـ 300 طلب في الدقيقة. التزامن مقيد بـ 8 طلبات متزامنة. يجب أن يبقى حجم جسم الطلب أقل من 8 ميجابايت.

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